Melampirkan ke proses yang berjalan pada kontainer Docker

Anda dapat men-debug aplikasi yang berjalan di Kontainer Docker Windows atau kontainer Linux .NET Core Docker menggunakan Visual Studio.

Prasyarat

Jika belum ada di server Linux, Anda perlu menginstal server SSH, unzip dan menginstal dengan curl atau wget. Misalnya, di Ubuntu Anda dapat melakukannya dengan menjalankan:

sudo apt-get install openssh-server unzip curl

Secure File Transfer Protocol (SFTP) juga harus diaktifkan. Sebagian besar distribusi SSH menginstal dan mengaktifkan SFTP secara default, tetapi itu tidak selalu terjadi.

Melampirkan ke proses yang berjalan pada kontainer Linux Docker

Anda dapat melampirkan debugger Visual Studio ke proses yang berjalan di kontainer Linux .NET Core Docker di komputer lokal atau jarak jauh Anda menggunakan kotak dialog Lampirkan ke Proses.

Penting

Untuk menggunakan fitur ini, Anda harus memiliki akses lokal ke kode sumber.

Nota

Anda dapat menggunakan instruksi ini untuk melampirkan ke Linux Docker yang berjalan di WSL melalui SSH, tetapi instans WSL Anda harus terlebih dahulu menjalankan server SSH. Misalnya, Anda dapat menginstal Open SSH Server (misalnya: sudo apt-get install openssh-server), mengonfigurasi server dengan mengedit file konfigurasi (misalnya: /etc/ssh/sshd_config), lalu memulai server (misalnya: sudo service ssh start).

Untuk melampirkan ke proses yang sedang berjalan dalam kontainer Linux Docker:

1. Di Visual Studio, pilih Debug > Lampirkan ke Proses (CTRL+ALT+P) untuk membuka kotak dialog Lampirkan ke Proses.

2. Atur Jenis koneksi ke Docker (Kontainer Linux).

   

3. Pilih Temukan... untuk mengatur target Koneksi melalui kotak dialog Pilih Kontainer Docker.

   Anda dapat men-debug proses kontainer Docker baik secara lokal atau jarak jauh.

   • Untuk men-debug proses kontainer Docker secara lokal:

     1. Atur host Docker CLI ke Mesin Lokal.

     2. Pilih kontainer yang aktif untuk dilampirkan dari daftar dan tekan OK.

        

   • Untuk men-debug proses kontainer Docker dari jarak jauh:

     Anda dapat tersambung ke proses yang sedang berjalan dalam kontainer Docker menggunakan salah satu dari dua opsi. Opsi pertama, untuk menggunakan SSH, sangat ideal jika Anda tidak memiliki alat Docker yang diinstal pada komputer lokal Anda. Jika Anda memiliki alat Docker yang diinstal secara lokal dan Anda memiliki daemon Docker yang dikonfigurasi untuk menerima permintaan jarak jauh, coba opsi kedua, menggunakan daemon Docker.

     • Untuk menyambungkan ke komputer jarak jauh melalui SSH:

       1. Pilih Tambahkan... untuk tersambung ke sistem jarak jauh.

          Sistem Jarak Jauh

       2. Masukkan informasi koneksi yang diperlukan dan pilih Sambungkan.

       3. Setelah menyambungkan ke SSH, pilih kontainer yang sedang berjalan untuk dilampirkan, lalu pilih OK.

     • Untuk mengatur target ke kontainer jarak jauh yang menjalankan proses melalui daemon Docker :

       1. Tentukan alamat daemon (yaitu, melalui TCP, IP, dan sebagainya) di bawah host Docker (Opsional), lalu pilih Refresh.
       2. Setelah berhasil menyambungkan ke daemon, pilih kontainer yang sedang berjalan untuk dilampirkan, lalu pilih OK.

4. Pilih proses kontainer yang sesuai dari daftar proses Tersedia dan pilih Lampirkan untuk mulai men-debug proses kontainer C# Anda di Visual Studio!

   

Melampirkan ke proses yang berjalan pada kontainer Windows Docker

Anda dapat melampirkan debugger Visual Studio ke proses yang berjalan di kontainer Windows Docker di komputer lokal Anda menggunakan kotak dialog Lampirkan ke Proses.

Penting

Untuk menggunakan fitur ini dengan proses .NET Core, Anda harus menginstal beban kerja Pengembangan Lintas Platform .NET Core dan memiliki akses lokal ke kode sumber.

Untuk melampirkan ke proses yang sedang berjalan dalam kontainer Windows Docker:

1. Di Visual Studio, pilih Debug > Kaitkan ke Proses (atau CTRL+ALT+P) untuk membuka kotak dialog Kaitkan ke Proses.

2. Atur tipe koneksi ke Docker (Windows Container).

   

3. Pilih Temukan... untuk mengatur target Koneksi menggunakan kotak dialog Pilih Kontainer Docker.

   Penting

   Proses target harus memiliki arsitektur prosesor yang sama dengan kontainer Docker Windows yang dijalankannya.

   Mengatur target ke kontainer jarak jauh melalui SSH saat ini tidak tersedia dan hanya dapat dilakukan menggunakan daemon Docker.

   Untuk mengatur target ke kontainer jarak jauh yang menjalankan proses melalui daemon Docker :

   1. Tentukan alamat daemon (yaitu, melalui TCP, IP, dan sebagainya) di bawah host Docker (Opsional) lalu pilih Refresh.

   2. Setelah berhasil menyambungkan ke daemon, pilih kontainer yang sedang berjalan untuk dilampirkan, lalu pilih OK.

4. Pilih proses kontainer yang sesuai dari daftar proses Tersedia dan pilih Lampirkan untuk mulai men-debug proses kontainer C#Anda.