Pengaturan peluncuran Alat Kontainer

Di folder Properti dalam proyek ASP.NET Core, Anda dapat menemukan file launchSettings.json, 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 untuk proyek kontainer tunggal.

Untuk Docker Compose, pilih Kelola Pengaturan Peluncuran Docker Compose, dan lihat Meluncurkan subset layanan kompos.

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

    "Docker (Dockerfile)": {
      "commandName": "Docker",
      "launchBrowser": true,
      "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}",
      "environmentVariables": {
        "ASPNETCORE_HTTPS_PORTS": "8081",
        "ASPNETCORE_HTTP_PORTS": "8080"
      },
      "publishAllPorts": true,
      "useSSL": true
    }

Anda juga dapat menggunakan "Container (Dockerfile)", yang lebih akurat jika Anda ingin menggunakan Podman, meskipun "Docker (Dockerfile)" berfungsi untuk runtime kontainer Docker dan Podman.

Pengaturan commandName mengidentifikasi bahwa bagian ini berlaku untuk Alat Kontainer.

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

Tabel berikut ini memperlihatkan properti yang bisa diatur di bagian ini:

Properti di antarmuka pengguna Profil Debug	Nama pengaturan di launchSettings.json	Contoh	Deskripsi
Argumen baris perintah	commandLineArgs	"commandLineArgs": "--mysetting myvalue"	Argumen baris perintah ini untuk memulai aplikasi Anda digunakan saat meluncurkan proyek Anda di kontainer.
Argumen eksekusi kontainer	containerRunArguments ContainerRunArguments	"containerRunArguments": "-l mylabel=value"	Argumen tambahan untuk diteruskan ke docker run perintah atau podman run . (Gunakan versi huruf kecil di Visual Studio 17.12 dan yang lebih baru. Versi huruf besar diperkenalkan di Visual Studio 17.9 dan disediakan untuk kompatibilitas mundur.) Anda dapat menggunakan token pengganti berikut: - {ProjectDir} - Jalur lengkap ke direktori proyek. - {OutDir} - Nilai properti MSBuild OutDir.
Tidak tersedia	DockerfileRunArguments	"dockerfileRunArguments": "-l mylabel=value"	Seperti containerRunArguments, tetapi hanya untuk proyek yang menggunakan jenis build Dockerfile. Disarankan untuk digunakan containerRunArguments sebagai gantinya.
Variabel Lingkungan	variabelLingkungan	"environmentVariables": { "ASPNETCORE_URLS": "https://+:443;http://+:80"Bahasa Indonesia: "ASPNETCORE_HTTPS_PORT": "44381" }	Nilai variabel lingkungan ini diteruskan ke proses saat diluncurkan dalam kontainer.
Jalur yang Dapat Dieksekusi	executablePath	"executablePath": "myprogram.exe"	Saat penelusuran kesalahan, debugger diinstruksikan untuk meluncurkan executable ini.
Nama Kontainer	namaKontainer	mycontainer	(17.12 dan yang lebih baru) Nama untuk kontainer yang cocok dengan ekspresi reguler [a-zA-Z0-9][a-zA-Z0-9_.-].
File lingkungan kontainer	containerRunEnvironmentFiles	"containerRunEnvironmentFiles": "abc.env;xyz.env"	(17.12 dan yang lebih baru) Daftar file variabel lingkungan (.env file) dipisahkan oleh titik koma. Lihat sintaks file .env.
HTTP Port	Pelabuhan http	"httpPort": 24051	Port ini pada host dipetakan ke port HTTP kontainer saat meluncurkan kontainer. Port kontainer 80 digunakan, kecuali Anda menentukan port dengan menggunakan variabel ASPNETCORE_URLS lingkungan dan ASPNETCORE_HTTP_PORTS.
Luncurkan Browser	bukaPeramban	"launchBrowser": true	Menunjukkan apakah akan meluncurkan browser setelah berhasil meluncurkan proyek.
Tidak tersedia	launchBrowserTimeout	"launchBrowserTimeout": 1	Jumlah waktu maksimum (dalam detik) untuk menunggu aplikasi siap sebelum meluncurkan browser (Docker Compose saja).
URL	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 port HTTP atau HTTPS yang ditentukan oleh variabel ASPNETCORE_URLS lingkungan dan ASPNETCORE_HTTP_PORTS, atau 80 untuk HTTP dan 443 untuk HTTPS jika tidak diatur.
Terbitkan semua port	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 melewati -p 5002:443, sehingga layanan Anda masih harus mendengarkan di port 5002.
SSL Port	sslPort	"sslPort": 44381	Port ini pada host dipetakan ke port HTTPS kontainer saat meluncurkan kontainer. Port kontainer 443 digunakan, kecuali Anda menentukan port dengan menggunakan variabel ASPNETCORE_URLS lingkungan dan ASPNETCORE_HTTP_PORTS.
Tidak tersedia	useSSL	"useSSL": true	Menunjukkan apakah akan menggunakan SSL saat meluncurkan proyek. Jika useSSL tidak ditentukan, maka SSL digunakan saat sslPort > 0.
Direktori kerja	workingDirectory (direktori kerja)	"workingDirectory": "c:\path\to\folder"	Saat penelusuran kesalahan, debugger diinstruksikan untuk menggunakan jalur ini sebagai direktori kerja.

Tidak semua pengaturan tersedia di UI, misalnya, useSSL. Untuk mengubah pengaturan tersebut, edit launchSettings.json secara langsung.

containerRunArguments dapat diatur dalam antarmuka pengguna Luncurkan Profil sebagai Container run arguments. Ini setara dengan properti DockerfileRunArgumentsMSBuild usang .

Nota

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

Langkah berikutnya

Konfigurasikan proyek Anda dengan mengatur properti build Container Tools.

Lihat juga

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