Pengaturan peluncuran Alat Kontainer

Di folder Properti dalam proyek ASP.NET Core, Anda dapat menemukan launchSettings.json file, yang berisi pengaturan yang mengontrol bagaimana aplikasi web Anda dimulai di komputer pengembangan Anda. Untuk informasi terperinci tentang bagaimana file ini digunakan dalam pengembangan ASP.NET, lihat Menggunakan beberapa lingkungan di ASP.NET Core.

Anda dapat mengedit file ini secara langsung, tetapi di Visual Studio IDE, Anda juga dapat mengedit properti dalam file ini melalui UI. Pilih daftar dropdown di samping opsi peluncuran (misalnya, Docker atau .NET SDK), lalu pilih Properti Debug.

Di launchSettings.json, pengaturan di bagian Docker terkait dengan cara Visual Studio menangani aplikasi dalam kontainer.

    "Docker": {
      "commandName": "Docker",
      "launchBrowser": true,
      "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}",
      "DockerfileRunArguments": "-l mylabel=value",
      "environmentVariables": {
        "ASPNETCORE_URLS": "https://+:443;http://+:80",
        "ASPNETCORE_HTTPS_PORT": "44360"
      },
      "httpPort": 51803,
      "useSSL": true,
      "sslPort": 44360
    }

Pengaturan commandName mengidentifikasi bahwa bagian ini berlaku untuk Alat Kontainer.

Sebagian besar pengaturan tersedia launchSettings.json dan berlaku baik Anda menggunakan Dockerfile, atau menggunakan dukungan build kontainer bawaan .NET SDK (tersedia untuk .NET 7 dan yang lebih baru).

Tabel berikut menunjukkan properti yang dapat diatur di bagian ini:

Nama pengaturan	Contoh	Deskripsi
commandLineArgs	"commandLineArgs": "--mysetting myvalue"	Argumen baris perintah ini untuk memulai aplikasi Anda yang digunakan saat meluncurkan proyek Anda di kontainer.
containerRunArguments	"containerRunArguments": "-l mylabel=value"	Seperti dockerfileRunArguments, tetapi untuk digunakan dengan jenis build kontainer .NET SDK.
DockerfileRunArguments	dockerfileRunArguments": "-l mylabel=value"	Argumen tambahan untuk diteruskan ke docker run perintah . / Pengaturan ini hanya berlaku untuk proyek yang menggunakan jenis build kontainer Dockerfile. Di Visual Studio 17.3 dan yang lebih baru, Anda dapat menggunakan token pengganti berikut yang ditambahkan: - {ProjectDir} - Jalur lengkap ke direktori proyek. - {OutDir} - Nilai properti MSBuild OutDir.
environmentVariables	"environmentVariables": { "ASPNETCORE_URLS": "https://+:443;http://+:80", "ASPNETCORE_HTTPS_PORT": "44381" }	Nilai variabel lingkungan ini diteruskan ke proses saat diluncurkan dalam kontainer.
httpPort	"httpPort": 24051	Port pada host ini dipetakan ke port kontainer 80 saat meluncurkan kontainer.
launchBrowser	"launchBrowser": true	Menunjukkan apakah akan meluncurkan browser setelah berhasil meluncurkan proyek.
launchBrowserTimeout	"launchBrowserTimeout": 1	Jumlah waktu maksimum (dalam detik) untuk menunggu aplikasi siap sebelum meluncurkan browser.
launchUrl	"launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}"	URL ini digunakan saat meluncurkan browser. Token pengganti yang didukung untuk string ini adalah: - {Scheme} - Diganti dengan http atau https, tergantung pada apakah SSL digunakan. - {ServiceHost} - Biasanya diganti dengan localhost. Namun, ketika Anda menargetkan kontainer Windows di Windows 10 RS3 atau yang lebih lama, kontainer diganti dengan IP kontainer. - {ServicePort} - Biasanya diganti dengan sslPort atau httpPort, tergantung pada apakah SSL digunakan. Namun, ketika Anda menargetkan kontainer Windows di Windows 10 RS3 atau yang lebih lama, kontainer tersebut diganti dengan 443 atau 80, tergantung pada apakah SSL digunakan.
publishAllPorts	"publishAllPorts": true	Jika true, teruskan -P ke docker run, yang menerbitkan semua port yang terekspos ke port acak. Lihat Dokumentasi Docker. Namun, saat Anda menentukan sslPort, Visual Studio masih meneruskan -p 5002:443, sehingga layanan Anda masih harus mendengarkan di port 5002.
sslPort	"sslPort": 44381	Port pada host ini dipetakan ke port kontainer 443 saat meluncurkan kontainer.
useSSL	"useSSL": true	Menunjukkan apakah akan menggunakan SSL saat meluncurkan proyek. Jika useSSL tidak ditentukan, maka SSL digunakan saat sslPort > 0.

Catatan

Jika pengaturan yang sama, misalnya, DockerfileRunArguments, ditemukan di file proyek dan dalam file pengaturan peluncuran, nilai dalam file pengaturan peluncuran lebih diutamakan.

Langkah berikutnya

Konfigurasikan proyek Anda dengan mengatur properti pembangunan Alat Kontainer.

Lihat juga

• Properti build Docker Compose
• Mengelola profil peluncuran untuk Docker Compose