Startinstellingen voor Container Tools

In de map Eigenschappen in een ASP.NET Core-project vindt u het launchSettings.json-bestand met instellingen die bepalen hoe uw web-app wordt gestart op uw ontwikkelcomputer. Zie Meerdere omgevingen gebruiken in ASP.NET Corevoor gedetailleerde informatie over hoe dit bestand wordt gebruikt in ASP.NET ontwikkeling.

U kunt dit bestand rechtstreeks bewerken, maar in Visual Studio IDE kunt u ook de eigenschappen in dit bestand bewerken via de gebruikersinterface. Kies de vervolgkeuzelijst naast de startoptie (bijvoorbeeld Docker of .NET SDK) en kies vervolgens Eigenschappen voor foutopsporing voor een project met één container.

Kies voor Docker Compose Startinstellingen voor Docker Compose beherenen zie Een subset van compose-servicesstarten.

In launchSettings.jsonzijn de instellingen in de sectie Docker gerelateerd aan de manier waarop Visual Studio container-apps verwerkt.

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

De instelling commandName geeft aan dat deze sectie van toepassing is op Container Tools.

De meeste instellingen in launchSettings.json zijn beschikbaar en van toepassing, ongeacht of u een Dockerfile gebruikt of de ingebouwde ondersteuning voor containerbuild van de .NET SDK gebruikt (beschikbaar voor .NET 7 en hoger).

In de volgende tabel ziet u de eigenschappen die in deze sectie kunnen worden ingesteld:

Eigenschap in de gebruikersinterface van het profiel voor foutopsporing	Naam instellen in launchSettings.json	Voorbeeld	Beschrijving
Opdrachtregelargumenten	commandLineArgs	"commandLineArgs": "--mysetting myvalue"	Deze opdrachtregelargumenten voor het starten van uw app worden gebruikt bij het starten van uw project in de container.
Argumenten voor containeruitvoering	containerRunArguments ContainerRunArguments	"containerRunArguments": "-l mylabel=value"	Aanvullende argumenten die moeten worden doorgegeven aan de opdracht docker run. (Gebruik de kleine letterversie in Visual Studio 17.12 en hoger. De hoofdletterversie is geïntroduceerd in Visual Studio 17.9 en is beschikbaar voor achterwaartse compatibiliteit.) U kunt de volgende vervangingstokens gebruiken: - {ProjectDir} : volledig pad naar de projectmap. - {OutDir} - De waarde van de eigenschap MSBuild OutDir.
N.V.T	DockerfileRunArguments	dockerfileRunArguments": "-l mylabel=value"	Net als containerRunArguments, maar alleen voor projecten die gebruikmaken van het buildtype Dockerfile. Voor Visual Studio 17.12 en hoger is het raadzaam om in plaats daarvan containerRunArguments te gebruiken.
Omgevingsvariabelen	environmentVariables	"environmentVariables": { "ASPNETCORE_URLS": "https://+:443;http://+:80", "ASPNETCORE_HTTPS_PORT": "44381" }	Deze omgevingsvariabelewaarden worden doorgegeven aan het proces wanneer deze in de container worden gestart.
Containernaam	containerName	mycontainer	(17.12 en hoger) Een naam voor de container die overeenkomt met de reguliere expressie [a-zA-Z0-9][a-zA-Z0-9_.-].
Containeromgevingsbestanden	containerRunEnvironmentFiles	"containerRunEnvironmentFiles": "abc.env;xyz.env"	(17.12 en hoger) Een lijst met omgevingsvariabelebestanden (.env bestanden) gescheiden door puntkomma's. Zie .env-bestandssyntaxis.
HTTP-poort	httpPort	"httpPort": 24051	Deze poort op de host wordt toegewezen aan de poort 80 van de container bij het starten van de container.
Browser starten	launchBrowser	"launchBrowser": true	Geeft aan of de browser moet worden gestart nadat het project is gestart.
N.V.T	launchBrowserTimeout	"launchBrowserTimeout": 1	De maximale hoeveelheid tijd (in seconden) om te wachten totdat de app gereed is voordat de browser wordt gestart (alleen Docker Compose).
URL	launchUrl	"launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}"	Deze URL wordt gebruikt bij het starten van de browser. Ondersteunde vervangingstokens voor deze tekenreeks zijn: - {Scheme} : vervangen door http of https, afhankelijk van of SSL wordt gebruikt. - {ServiceHost} - meestal vervangen door localhost. Wanneer u echter windows-containers op Windows 10 RS3 of ouder richt, wordt deze vervangen door het IP-adres van de container. - {ServicePort}: meestal vervangen door sslPort of httpPort, afhankelijk van of SSL wordt gebruikt. Als u echter windows-containers op Windows 10 RS3 of ouder richt, wordt deze vervangen door 443 of 80, afhankelijk van of SSL wordt gebruikt.
Alle poorten publiceren	publishAllPorts	"publishAllPorts": true	Indien waar, geeft u -P door aan docker run, waarmee alle weergegeven poorten naar een willekeurige poort worden gepubliceerd. Zie Docker-documentatie. Wanneer u echter sslPortopgeeft, passeert Visual Studio nog steeds -p 5002:443, zodat uw service nog steeds moet luisteren op poort 5002.
SSL-poort	sslPort	"sslPort": 44381	Deze poort op de host wordt toegewezen aan poort 443 van de container bij het starten van de container.
N.V.T	useSSL	"useSSL": true	Geeft aan of SSL moet worden gebruikt bij het starten van het project. Als useSSL niet is opgegeven, wordt SSL gebruikt wanneer sslPort > 0.

Niet alle instellingen zijn beschikbaar in de gebruikersinterface, bijvoorbeeld useSSL. Als u deze instellingen wilt wijzigen, bewerkt u launchSettings.json rechtstreeks.

De instelling DockerfileRunArguments wordt vervangen in Visual Studio 2022 17.12 en hoger door containerRunArguments, die als Container run argumentsin de gebruikersinterface voor startprofielen kan worden ingesteld.

Notitie

Als dezelfde instelling wordt gevonden in zowel het projectbestand als in het bestand met startinstellingen, heeft de waarde in het bestand met startinstellingen voorrang.

Volgende stappen

Configureer uw project door de build-eigenschappen van Container Tools in te stellen.

Zie ook

• Build-eigenschappen van Docker Compose
• Startprofielen beheren voor Docker Compose-