Bagikan melalui


Mengonfigurasi Visual Studio Container Tools

Dengan menggunakan pengaturan Visual Studio, Anda dapat mengontrol beberapa aspek tentang cara kerja Visual Studio dengan kontainer Docker, termasuk pengaturan yang memengaruhi performa dan penggunaan sumber daya saat bekerja dengan kontainer Docker.

Pengaturan Alat Kontainer

Dari menu utama, pilih Alat > Opsi, dan luaskan Alat Kontainer > Pengaturan. Pengaturan alat kontainer muncul.

Pengaturan Umum Alat Kontainer:

Opsi Alat Kontainer Visual Studio, memperlihatkan: Instal Docker Desktop jika diperlukan, dan Percayai sertifikat SSL Inti ASP.NET.

Pengaturan Proyek Tunggal dan Docker Compose Alat Kontainer:

Opsi Alat Kontainer Visual Studio, memperlihatkan: Matikan kontainer pada penutupan proyek, Tarik gambar Docker yang diperlukan saat proyek terbuka, dan Jalankan kontainer saat proyek terbuka.

Opsi Alat Kontainer Visual Studio, memperlihatkan: Matikan kontainer pada penutupan proyek, Tarik gambar Docker yang diperlukan pada proyek terbuka, Jalankan kontainer pada proyek terbuka, Jalankan layanan dalam kontainer untuk mengaktifkan Autentikasi Azure, dan Jalankan layanan dalam kontainer untuk mengaktifkan Hot Reload.

Tabel berikut ini mungkin membantu Anda memutuskan cara mengatur opsi ini.

Tabel berikut menjelaskan pengaturan Umum:

Nama Pengaturan default Berlaku Untuk Deskripsi
Instal Docker Desktop jika diperlukan Minta Saya Proyek tunggal, Docker Compose Pilih apakah Anda ingin diminta jika Docker Desktop tidak diinstal.
Sertifikat SSL Trust ASP.NET Core Minta Saya ASP.NET proyek Core 2.x Saat diatur ke Prompt Me, jika localhost sertifikat SSL tidak tepercaya, Visual Studio akan meminta setiap kali Anda menjalankan proyek ASP.NET Core 2.x.

Tabel berikut ini menjelaskan pengaturan Proyek Tunggal dan Docker Compose:

Nama Pengaturan default Berlaku Untuk Deskripsi
Tarik gambar Docker yang diperlukan saat proyek terbuka Benar Proyek tunggal, Docker Compose Untuk peningkatan performa saat memuat proyek, Visual Studio akan memulai operasi penarikan Docker di latar belakang sehingga ketika Anda siap untuk menjalankan kode Anda, gambar sudah diunduh atau dalam proses pengunduhan. Jika Anda hanya memuat proyek dan kode penjelajahan, Anda dapat mengatur ke Salah untuk menghindari mengunduh gambar kontainer yang tidak Anda butuhkan.
Menarik gambar Docker yang diperbarui saat proyek terbuka Proyek .NET Core Proyek tunggal, Docker Compose Saat Anda membuka proyek, periksa pembaruan pada gambar dan unduh jika tersedia.
Jalankan kontainer saat proyek terbuka Benar Proyek tunggal, Docker Compose Sekali lagi untuk peningkatan performa, Visual Studio membuat kontainer sebelumnya sehingga siap untuk saat Anda membangun dan menjalankan kontainer Anda. Jika Anda ingin mengontrol kapan kontainer Anda dibuat, atur ke Salah.
Menghapus kontainer saat proyek ditutup Benar Proyek tunggal, Docker Compose Atur ke Salah jika Anda ingin kontainer untuk solusi Anda dipertahankan setelah menutup solusi atau menutup Visual Studio.
Nama Pengaturan default Berlaku Untuk Deskripsi
Tarik gambar Docker yang diperlukan saat proyek terbuka Benar Proyek tunggal, Docker Compose Untuk peningkatan performa saat memuat proyek, Visual Studio akan memulai operasi penarikan Docker di latar belakang sehingga ketika Anda siap untuk menjalankan kode Anda, gambar sudah diunduh atau dalam proses pengunduhan. Jika Anda hanya memuat proyek dan kode penjelajahan, Anda dapat mengatur ke Salah untuk menghindari mengunduh gambar kontainer yang tidak Anda butuhkan.
Menarik gambar Docker yang diperbarui saat proyek terbuka Proyek .NET Core Proyek tunggal, Docker Compose Saat Anda membuka proyek, periksa pembaruan pada gambar dan unduh jika tersedia.
Jalankan kontainer saat proyek terbuka Benar Proyek tunggal, Docker Compose Sekali lagi untuk peningkatan performa, Visual Studio membuat kontainer sebelumnya sehingga siap untuk saat Anda membangun dan menjalankan kontainer Anda. Jika Anda ingin mengontrol kapan kontainer Anda dibuat, atur ke Salah.
Menghapus kontainer saat proyek ditutup Benar Proyek tunggal, Docker Compose Atur ke Salah jika Anda ingin kontainer untuk solusi Anda dipertahankan setelah menutup solusi atau menutup Visual Studio.
Menjalankan layanan dalam kontainer untuk mengaktifkan Autentikasi Azure Benar Proyek tunggal, Docker Compose Visual Studio versi 17.6 atau yang lebih baru menjalankan layanan proksi token di kontainer yang membantu Autentikasi Azure, sehingga aplikasi Anda dapat menggunakan layanan Azure selama pengembangan. Atur ke False jika Anda tidak ingin layanan ini diinstal dan dijalankan.
Menjalankan layanan dalam kontainer untuk mengaktifkan Hot Reload Benar Proyek tunggal, Docker Compose Atur ke False jika Anda tidak ingin layanan ini diinstal dan dijalankan. Layanan Hot Reload tersedia di Visual Studio 2022 versi 17.7 dan yang lebih baru dan hanya mendukung berjalan tanpa penelusuran kesalahan (Ctrl+F5).

Pengaturan Jendela Alat Kontainer mengontrol pengaturan yang berlaku untuk jendela alat Kontainer, yang menunjukkan informasi tentang kontainer dan gambar Docker. Lihat Menggunakan jendela Kontainer

Opsi Alat Kontainer Visual Studio, memperlihatkan pengaturan yang tersedia untuk jendela alat Kontainer

Tabel berikut menjelaskan pengaturan jendela Kontainer:

Nama Pengaturan default Deskripsi
Konfirmasi sebelum memangkas kontainer Selalu Mengontrol apakah Anda diminta saat memangkas kontainer yang tidak digunakan.
Konfirmasi sebelum memangkas gambar Selalu Mengontrol apakah Anda diminta saat memangkas gambar yang tidak digunakan.
Konfirmasi sebelum menghapus kontainer Selalu Mengontrol apakah Anda diminta saat menghapus kontainer.
Konfirmasi sebelum menghapus gambar Selalu Mengontrol apakah Anda diminta saat menghapus gambar.
Konfirmasi sebelum menjalankan gambar dalam jumlah besar Selalu Mengontrol apakah Anda diminta sebelum memulai kontainer dari lebih dari 10 gambar pada satu waktu.

Peringatan

localhost Jika sertifikat SSL tidak tepercaya, dan Anda memilih kotak untuk menekan permintaan, permintaan web HTTPS mungkin gagal pada waktu proses di aplikasi atau layanan Anda. Dalam hal ini, kosongkan kotak centang Jangan minta , jalankan proyek Anda, dan tunjukkan kepercayaan pada perintah.

Mengonfigurasi autentikasi Azure

Jika aplikasi Anda menggunakan layanan Azure, aplikasi memerlukan kredensial autentikasi yang sesuai saat berjalan dalam kontainer untuk mengautentikasi dengan layanan Azure. Selama pengembangan, Anda biasanya dapat menggunakan kredensial Azure Anda sendiri alih-alih kredensial yang digunakan aplikasi dalam produksi, tetapi kredensial tersebut diperlukan di lingkungan kontainer agar berguna untuk aplikasi kontainer yang sedang berjalan.

Dimulai dengan Visual Studio 2022 versi 17.6, dalam proyek kontainer tunggal dan Docker Compose, layanan proksi token disebarkan dan dijalankan dalam kontainer Anda yang membantu aplikasi dan layanan Anda mengautentikasi di Azure. Fitur ini memerlukan Azure Identity 1.9.0 atau yang lebih baru. Dengan mengaktifkan layanan ini, Anda dapat secara otomatis menggunakan sebagian besar layanan Azure tanpa konfigurasi atau penyiapan tambahan dalam kontainer. Secara khusus, kode Anda dapat menggunakan DefaultAzureCredential dan VisualStudioCredential untuk mengautentikasi dengan layanan Azure dengan cara yang sama seperti di luar kontainer. Lihat README Azure Identity 1.9.0.

Untuk menonaktifkan fitur ini, atur pengaturan Opsi Alat>Jalankan layanan dalam kontainer untuk mengaktifkan Autentikasi Azure (dijelaskan sebelumnya dalam artikel ini) ke .False

Perhatian

Ada potensi masalah keamanan jika Anda menggunakan proksi token dan telah mengaktifkan log diagnostik Alat Kontainer tertentu. Saat pengelogan diaktifkan, kredensial autentikasi dapat dicatat sebagai teks biasa. Log ini diaktifkan oleh variabel lingkungan tertentu. Untuk proyek kontainer tunggal, variabel lingkungan adalah MS_VS_CONTAINERS_TOOLS_LOGGING_ENABLED, yang kemudian masuk %tmp%\Microsoft.VisualStudio.Containers.Tools. Untuk proyek Docker Compose, itu adalah MS_VS_DOCKER_TOOLS_LOGGING_ENABLED, yang kemudian masuk %tmp%\Microsoft.VisualStudio.DockerCompose.Tools.

Baca selengkapnya tentang bekerja dengan kontainer di Visual Studio dalam gambaran umum ini.