Kapsayıcı Araçları başlatma ayarları

ASP.NET Core projesindeki Özellikler klasöründe, web uygulamanızın launchSettings.json geliştirme makinenizde nasıl başlatıldığını denetleyen ayarları içeren dosyayı bulabilirsiniz. Bu dosyanın ASP.NET geliştirmede nasıl kullanıldığı hakkında ayrıntılı bilgi için bkz . ASP.NET Core'da birden çok ortam kullanma.

Bu dosyayı doğrudan düzenleyebilirsiniz, ancak Visual Studio IDE'de kullanıcı arabirimi aracılığıyla bu dosyadaki özellikleri de düzenleyebilirsiniz. Başlatma seçeneğinin yanındaki açılan listeyi seçin (örneğin, Docker veya .NET SDK) ve ardından Hata Ayıklama Özellikleri'ni seçin.

Başlatmada Ayarlar.json Docker bölümündeki ayarlar Visual Studio'nın kapsayıcılı uygulamaları nasıl işlediğiyle ilgilidir.

    "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
    }

commandName ayarı, bu bölümün Kapsayıcı Araçları için geçerli olduğunu belirler.

dockerfile veya .NET SDK'sının yerleşik kapsayıcı derleme desteğini (.NET 7 ve üzeri için kullanılabilir) kullanıyor olmanız fark etmeksizin içindeki ayarların launchSettings.json çoğu kullanılabilir ve uygulanabilir.

Aşağıdaki tabloda, bu bölümde ayarlanabilen özellikler gösterilmektedir:

Ayar adı	Örnek	Açıklama
commandLineArgs	"commandLineArgs": "--mysetting myvalue"	Uygulamanızı başlatmaya yönelik bu komut satırı bağımsız değişkenleri, projenizi kapsayıcıda başlatırken kullanılır.
containerRunArguments	"containerRunArguments": "-l mylabel=value"	gibi dockerfileRunArguments, ancak .NET SDK kapsayıcı derleme türüyle kullanmak için.
DockerfileRunArguments	dockerfileRunArguments": "-l mylabel=value"	Komuta geçirmek için docker run ek bağımsız değişkenler. / Bu ayar yalnızca Dockerfile kapsayıcı derleme türünü kullanan projeler için geçerlidir. Visual Studio 17.3 ve sonraki sürümlerde, eklenen aşağıdaki değiştirme belirteçlerini kullanabilirsiniz: - {ProjectDir} - Proje dizininin tam yolu. - {OutDir} - MSBuild özelliğinin OutDir değeri.
environmentVariables	"environmentVariables": { "ASPNETCORE_URLS": "https://+:443;http://+:80", "ASPNETCORE_HTTPS_PORT": "44381" }	Bu ortam değişkeni değerleri kapsayıcıda başlatıldığında işleme geçirilir.
httpPort	"httpPort": 24051	Konak üzerindeki bu bağlantı noktası, kapsayıcı başlatılırken kapsayıcının bağlantı noktası 80'e eşlenir.
launchBrowser	"launchBrowser": true	Projeyi başarıyla başlattıktan sonra tarayıcının başlatılıp başlatılmayacağını gösterir.
launchBrowserTimeout	"launchBrowserTimeout": 1	Tarayıcıyı başlatmadan önce uygulamanın hazır olmasını bekleme süresi (saniye cinsinden) üst sınırı.
launchUrl	"launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}"	Bu URL, tarayıcı başlatılırken kullanılır. Bu dize için desteklenen değiştirme belirteçleri şunlardır: - {Scheme}- SSL'nin kullanılıp kullanılmadığına bağlı olarak veya httpsile http değiştirilir. - {ServiceHost} - Genellikle ile localhostdeğiştirilir. Ancak Windows 10 RS3 veya daha eski sürümlerde Windows kapsayıcılarını hedeflediğinizde, kapsayıcının IP'siyle değiştirilir. - {ServicePort} - SSL'nin kullanılıp kullanılmadığına bağlı olarak genellikle sslPort veya httpPort ile değiştirilir. Ancak Windows 10 RS3 veya daha eski sürümlerde Windows kapsayıcılarını hedeflediğinizde, SSL'nin kullanılıp kullanılmadığına bağlı olarak veya ile 44380değiştirilir.
publishAllPorts	"publishAllPorts": true	True ise, kullanıma sunulan tüm bağlantı noktalarını rastgele bir bağlantı noktasına yayımlayan öğesine geçin -Pdocker run. Docker belgelerine bakın. Ancak, belirttiğinizde sslPortVisual Studio yine de geçirir -p 5002:443, bu nedenle hizmetiniz 5002 numaralı bağlantı noktasında dinlemeye devam etmelidir.
sslPort	"sslPort": 44381	Konak üzerindeki bu bağlantı noktası, kapsayıcı başlatılırken kapsayıcının 443 numaralı bağlantı noktasına eşlenir.
useSSL	"useSSL": true	Projeyi başlatırken SSL kullanılıp kullanılmayacağını gösterir. Belirtilmezse useSSL , SSL olduğunda sslPort > 0kullanılır.

Not

Örneğin, DockerfileRunArgumentsaynı ayarlar hem proje dosyasında hem de başlatma ayarları dosyasında bulunursa, başlatma ayarları dosyasındaki değer önceliklidir.

Sonraki adımlar

Kapsayıcı Araçları derleme özelliklerini ayarlayarak projenizi yapılandırın.

Ayrıca bkz.

• Docker Compose derleme özellikleri
• Docker Compose için başlatma profillerini yönetme