Tárolóeszközök indítási beállításai

Egy ASP.NET Core-projekt Tulajdonságok mappájában található a launchSettings.json fájl, amely a webalkalmazás fejlesztési gépen való indítását vezérlő beállításokat tartalmazza. A fájl ASP.NET fejlesztésében való használatáról további információt a Több környezet használata ASP.NET Corecímű témakörben talál.

Ezt a fájlt közvetlenül szerkesztheti, de a Visual Studio IDE-ben a fájl tulajdonságait a felhasználói felületen keresztül is szerkesztheti. Válassza az indítási lehetőség melletti legördülő listát (például Docker vagy .NET SDK), majd válassza a Hibakeresési tulajdonságok lehetőséget egy egytárolós projekthez.

Docker Compose esetén válassza a Docker Compose indítási beállításainak kezeléselehetőséget, és tekintse meg A levélírási szolgáltatások egy részhalmazának indításacímű témakört.

A launchSettings.jsonDocker szakasz beállításai a Visual Studio tárolóalapú alkalmazások kezelésével kapcsolatosak.

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

Használhatja a Podmant "Container (Dockerfile)"is, amely pontosabb, bár "Docker (Dockerfile)" a Docker és a Podman tároló futtatókörnyezetekben is működik.

A commandName beállítás azonosítja, hogy ez a szakasz a Container Toolsra vonatkozik.

A launchSettings.json legtöbb beállítása elérhető és alkalmazható, akár Dockerfile-t használ, akár a .NET SDK beépített tároló buildtámogatását használja (.NET 7 és újabb verziókhoz érhető el).

Az alábbi táblázat az ebben a szakaszban beállítható tulajdonságokat mutatja be:

Tulajdonság a Hibakeresési profil felhasználói felületén	Név beállítása a launchSettings.json	Példa	Leírás
Parancssori argumentumok	commandLineArgs	"commandLineArgs": "--mysetting myvalue"	Ezeket a parancssori argumentumokat használja az alkalmazás elindításához, amikor elindítja a projektet a tárolóban.
Tárolófuttatási argumentumok	containerRunArguments ContainerRunArguments	"containerRunArguments": "-l mylabel=value"	A parancsnak átadott docker runpodman run további argumentumok. (Használja a kisbetűs verziót a Visual Studio 17.12-es és újabb verzióiban. A nagybetűs verziót a Visual Studio 17.9-ben vezettük be, és a visszamenőleges kompatibilitást biztosítjuk.) A következő cserejogkivonatokat használhatja: - {ProjectDir} – A projektkönyvtár teljes elérési útja. - {OutDir} – Az MSBuild tulajdonság OutDir értéke.
Nincs adat.	DockerfileRunArguments	"dockerfileRunArguments": "-l mylabel=value"	Mint containerRunArguments, de csak a Dockerfile buildtípust használó projektek esetében. Javasoljuk, hogy inkább használja containerRunArguments .
Környezeti változók	környezeti változók	"environmentVariables": { "ASPNETCORE_URLS": "https://+:443;http://+:80", "ASPNETCORE_HTTPS_PORT": "44381" }	Ezeket a környezeti változóértékeket a rendszer a tárolóban való indításkor továbbítja a folyamatnak.
Végrehajtható elérési út	executablePath	"executablePath": "myprogram.exe"	Hibakereséskor a hibakeresőt a program arra utasítja, hogy indítsa el ezt a végrehajtható fájlt.
Tároló neve	konténernév	mycontainer	(17.12 és újabb verziók) A tároló neve, amely megfelel a [a-zA-Z0-9][a-zA-Z0-9_.-]reguláris kifejezésnek.
Tárolókörnyezet fájljai	containerRunEnvironmentFiles	"containerRunEnvironmentFiles": "abc.env;xyz.env"	(17.12 és újabb verziók) A környezeti változófájlok (.env fájlok) listája pontosvesszővel elválasztva. Lásd: .env fájlszintaxis.
HTTP-port	httpPort	"httpPort": 24051	A tároló indításakor a gazdagépen található port a tároló HTTP-portjára van leképezve. A tárolóport 80-at használ, kivéve, ha a környezeti változók ASPNETCORE_URLS és ASPNETCORE_HTTP_PORTSa .
Böngésző indítása	böngészőindítás	"launchBrowser": true	Azt jelzi, hogy a projekt sikeres elindítása után elindítja-e a böngészőt.
Nincs adat.	launchBrowserTimeout	"launchBrowserTimeout": 1	A böngésző elindítása előtt (csak a Docker Compose esetében) az alkalmazás készenlétének maximális időtartama (másodpercben).
URL	launchUrl	"launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}"	Ezt az URL-címet használja a böngésző indításakor. A sztring támogatott cserejogkivonatai a következők: - {Scheme} – http vagy httpsváltja fel, attól függően, hogy SSL-t használ-e. - {ServiceHost} – Általában localhost- ra cserélik. Ha Windows 10 RS3 vagy régebbi Windows-tárolókat céloz meg, az a tároló IP-címére lesz lecserélve. - {ServicePort} – Általában sslPortra vagy httpPortra cserélik, attól függően, hogy SSL-t használnak-e. Ha windowsos tárolókat céloz meg Windows 10 RS3 vagy régebbi rendszeren, a rendszer a környezeti változók ASPNETCORE_URLSASPNETCORE_HTTP_PORTSáltal megadott HTTP- vagy HTTPS-portra, illetve a HTTP 80-ra és a HTTPS 443-ra cseréli, ha nincs beállítva.
Az összes port közzététele	publishAllPorts	"publishAllPorts": true	Ha igaz, adja át -Pdocker run, amely az összes közzétett portot közzéteszi egy véletlenszerű porton. Lásd Docker dokumentációját. Ha azonban sslPortad meg, a Visual Studio továbbra is átmegy -p 5002:443, így a szolgáltatásnak továbbra is figyelnie kell az 5002-s portot.
SSL-port	sslPort	"sslPort": 44381	A gazdagép ezen portja a tároló indításakor a tároló HTTPS-portjára van leképezve. A tárolóport 443-at használ, kivéve, ha a környezeti változók ASPNETCORE_URLS és ASPNETCORE_HTTP_PORTSa .
Nincs adat.	useSSL	"useSSL": true	Azt jelzi, hogy a projekt indításakor SSL-t használjon-e. Ha nincs megadva useSSL, akkor az SSL sslPort > 0.
Munkakönyvtár	workingDirectory	"workingDirectory": "c:\path\to\folder"	Hibakereséskor a hibakeresőnek arra kell utasítania, hogy ezt az elérési utat használja munkakönyvtárként.

A felhasználói felületen nem minden beállítás érhető el, például useSSL. A beállítások módosításához közvetlenül szerkessze launchSettings.json.

A containerRunArguments Profilok indítása felhasználói felületen a következőként Container run argumentsállítható be: . Ez egyenértékű az elavult MSBuild tulajdonság.DockerfileRunArguments

Jegyzet

Ha ugyanez a beállítás megtalálható a projektfájlban és az indítási beállításfájlban is, a indítási beállítások fájljának értéke elsőbbséget élvez.

Következő lépések

Konfigurálja a projektet a Container Tools buildtulajdonságainakbeállításával.

Lásd még:

• Docker Compose buildtulajdonságok
• Docker Compose indítási profiljainak kezelése