Megosztás a következőn keresztül:

Alkalmazásgazda konfigurálása

  • Cikk

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 httpsnevű 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 a DOTNET_RESOURCE_SERVICE_ENDPOINT_URL az alkalmazás gazdagépén vannak beállítva.

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.