Alkalmazásgazda konfigurálása
Az alkalmazásgazda projekt konfigurálja és elindítja az elosztott alkalmazást (DistributedApplication). Amikor egy DistributedApplication
futtat, beolvassa a konfigurációt az alkalmazás gazdagépéről. A konfiguráció az alkalmazás gazdagépén és DistributedApplicationOptionsbeállított környezeti változókból töltődik be.
A konfiguráció a következőket tartalmazza:
- Az erőforrás-szolgáltatás üzemeltetésének beállításai, például a cím és a hitelesítési beállítások.
- A .NET.NET Aspire irányítópultelindításához használt beállítások, például az irányítópult előtér- és OpenTelemetry protokoll (OTLP) címei.
- Az alkalmazásgazda futtatásához .NET.NET Aspire belső beállítások. Ezek belsőleg vannak beállítva, de .NET.NET Aspirekiterjesztő integrációkkal érhetők el.
Az alkalmazás gazdagép-konfigurációját az alkalmazásgazda indítási profilja biztosítja. Az alkalmazásgazda egy indítási beállításokat tartalmazó fájlhívást launchSettings.json, amely az indítási profilok listáját tartalmazza. Minden indítási profil egy kapcsolódó beállításgyűjtemény, amely meghatározza, hogyan szeretné dotnet
elindítani az alkalmazást.
{
"$schema": "https://json.schemastore.org/launchsettings.json",
"profiles": {
"https": {
"commandName": "Project",
"dotnetRunMessages": true,
"launchBrowser": true,
"applicationUrl": "https://localhost:17134;http://localhost:15170",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development",
"DOTNET_ENVIRONMENT": "Development",
"DOTNET_DASHBOARD_OTLP_ENDPOINT_URL": "https://localhost:21030",
"DOTNET_RESOURCE_SERVICE_ENDPOINT_URL": "https://localhost:22057"
}
}
}
}
Az előző indítási beállítások fájlja:
- Egy
https
nevű indítási profillal rendelkezik. -
.NET
.NET Aspire alkalmazásgazdaprojekt konfigurálása:
- A
applicationUrl
tulajdonság konfigurálja az irányítópult indítási címét (ASPNETCORE_URLS
). - Az olyan környezeti változók, mint a
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL
és aDOTNET_RESOURCE_SERVICE_ENDPOINT_URL
az alkalmazás gazdagépén vannak beállítva.
- A
További információ: .NET.NET Aspire és profilok indítása.
Jegyzet
Az ezen a lapon ismertetett konfiguráció .NET.NET Aspire alkalmazásgazdaprojekthez készült. Az önálló irányítópult konfigurálásához lásd irányítópult konfigurációs.
Gyakori konfiguráció
Opció | Alapértelmezett érték | Leírás |
---|---|---|
ASPIRE_ALLOW_UNSECURED_TRANSPORT |
false |
Engedélyezi az alkalmazás gazdagépével való kommunikációt https nélkül.
ASPNETCORE_URLS (irányítópult címe) és DOTNET_RESOURCE_SERVICE_ENDPOINT_URL (alkalmazásgazda erőforrás-szolgáltatás címe) csak akkor biztonságos https-kapcsolattal, ha igaz. |
DOTNET_ASPIRE_CONTAINER_RUNTIME |
docker |
Lehetővé teszi alternatív tároló-futtatókörnyezetek használatát a tárolók által támogatott erőforrásokhoz. A lehetséges értékek docker (alapértelmezett) vagy podman . További részletekért tekintse meg beállítási és eszközhasználati áttekintést. |
Erőforrás-szolgáltatás
Az erőforrás-szolgáltatást az alkalmazásgazda üzemelteti. Az irányítópult az erőforrás-szolgáltatást használja az .NET.NET Aspireáltal vezényelt erőforrásokra vonatkozó információk lekérésére.
Opció | Alapértelmezett érték | Leírás |
---|---|---|
DOTNET_RESOURCE_SERVICE_ENDPOINT_URL |
null |
Az alkalmazásgazda által üzemeltetett erőforrás-szolgáltatás címét konfigurálja. Automatikusan létrejön a launchSettings.json, hogy véletlenszerű port legyen a localhost. Például https://localhost:17037 . |
DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY |
Automatikusan generált 128 bites entrópia-jogkivonatot. | Az alkalmazásgazda erőforrás-szolgáltatásának küldött kérések hitelesítéséhez használt API-kulcs. Az API-kulcsra akkor van szükség, ha az alkalmazás gazdagépe futtatási módban van, az irányítópult nincs letiltva, és az irányítópult nincs úgy konfigurálva, hogy névtelen hozzáférést engedélyezhessen DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS . |
Műszerfal
Alapértelmezés szerint az irányítópultot az alkalmazásgazda automatikusan elindítja. Az irányítópult támogatja saját konfigurációs, és néhány beállítás konfigurálható az alkalmazás gazdagépéről.
Opció | Alapértelmezett érték | Leírás |
---|---|---|
ASPNETCORE_URLS |
null |
Irányítópult címe. Csak akkor lehet https , ha ASPIRE_ALLOW_UNSECURED_TRANSPORT vagy DistributedApplicationOptions.AllowUnsecuredTransport igaz. Automatikusan létrejön a launchSettings.json, hogy véletlenszerű port legyen a localhost. Az indítási beállítások értéke a applicationUrls tulajdonságban van beállítva. |
ASPNETCORE_ENVIRONMENT |
Production |
Konfigurálja azt a környezetet, amelyként az irányítópult fut. További információ: Több környezet használata ASP.NET Core. |
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL |
http://localhost:18889 , ha nincs gRPC-végpont konfigurálva. |
Konfigurálja az irányítópult OTLP gRPC-címét. Az irányítópult az OTLP-n keresztüli telemetriai adatok fogadásához használható. Állítsa be az erőforrásokat OTEL_EXPORTER_OTLP_ENDPOINT env varként. A OTEL_EXPORTER_OTLP_PROTOCOL env var grpc . Automatikusan létrejön a launchSettings.json, hogy véletlenszerű port legyen a localhost. |
DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL |
null |
Konfigurálja az irányítópult OTLP HTTP-címét. Az irányítópult az OTLP-n keresztüli telemetriai adatok fogadásához használható. Ha csak DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL van konfigurálva, akkor az erőforrásokon van beállítva, mint az OTEL_EXPORTER_OTLP_ENDPOINT env var. A OTEL_EXPORTER_OTLP_PROTOCOL env var http/protobuf . |
DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN |
Automatikusan generált 128 bites entrópia-jogkivonatot. | Konfigurálja az előtérbeli böngésző jogkivonatát. Ezt az értéket kell megadni az irányítópult eléréséhez, ha a hitelesítési mód BrowserToken. Ha nincs megadva böngészőjogkivonat, a rendszer minden alkalommal létrehoz egy új jogkivonatot, amikor az alkalmazásgazda elindul. |
Belső
A belső beállításokat az alkalmazásgazda és az integráció használja. A belső beállítások nem közvetlenül konfigurálhatók.
Opció | Alapértelmezett érték | Leírás |
---|---|---|
AppHost:Directory |
A tartalomgyöker, ha nincs projekt. | Annak a projektnek a könyvtára, amelyben az alkalmazásgazda található. Elérhető a IDistributedApplicationBuilder.AppHostDirectory. |
AppHost:Path |
A könyvtár az alkalmazás nevével kombinálva. | Az alkalmazásgazda elérési útja. Egyesíti a könyvtárat az alkalmazás nevével. |
AppHost:Sha256 |
Az alkalmazás gazdagépének nevéből jön létre, amikor az alkalmazás gazdagépe közzétételi módban van. Ellenkező esetben az alkalmazás gazdagépének elérési útján jön létre. | Hexadecimális kivonat az aktuális alkalmazáshoz. A kivonat az alkalmazás aktuális gépen való helyén alapul, így stabil az alkalmazásgazda indításai között. |
AppHost:OtlpApiKey |
Automatikusan generált 128 bites entrópia-jogkivonatot. | Az irányítópult OTLP szolgáltatásnak küldött kérelmek hitelesítéséhez használt API-kulcs. Az érték szükség esetén jelen van: az alkalmazás gazdagépe futtatási módban van, az irányítópult nincs letiltva, és az irányítópult nincs úgy konfigurálva, hogy névtelen hozzáférést engedélyezzen DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS . |
AppHost:BrowserToken |
Automatikusan generált 128 bites entrópia-jogkivonatot. | Az irányítópulton való böngészés hitelesítéséhez használt böngésző-jogkivonat, amikor az alkalmazásgazda elindítja. A böngésző jogkivonatát DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN állíthatja be. Az érték szükség esetén jelen van: az alkalmazás gazdagépe futtatási módban van, az irányítópult nincs letiltva, és az irányítópult nincs úgy konfigurálva, hogy névtelen hozzáférést engedélyezzen DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS . |
AppHost:ResourceService:AuthMode |
ApiKey . Ha DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS igaz, akkor az érték Unsecured . |
Az erőforrás-szolgáltatás eléréséhez használt hitelesítési mód. Az érték szükség esetén jelen van: az alkalmazás gazdagépe futtatási módban van, és az irányítópult nincs letiltva. |
AppHost:ResourceService:ApiKey |
Automatikusan generált 128 bites entrópia-jogkivonatot. | Az alkalmazásgazda erőforrás-szolgáltatásának küldött kérések hitelesítéséhez használt API-kulcs. Az API-kulcsot DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY állíthatja be. Az érték szükség esetén jelen van: az alkalmazás gazdagépe futtatási módban van, az irányítópult nincs letiltva, és az irányítópult nincs úgy konfigurálva, hogy névtelen hozzáférést engedélyezzen DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS . |