Sdílet prostřednictvím

Konfigurace hostitele aplikace

  • Článek

Projekt hostitele aplikace nakonfiguruje a spustí distribuovanou aplikaci (DistributedApplication). Když DistributedApplication spustí, načte konfiguraci z hostitele aplikace. Konfigurace se načte z proměnných prostředí, které jsou nastavené na hostiteli aplikace a DistributedApplicationOptions.

Konfigurace zahrnuje:

  • Nastavení pro hostování služby prostředků, například adresy a možnosti ověřování.
  • Nastavení použitá ke spuštění .NET.NET Aspire řídicího panelu, jako jsou front-endové adresy řídicího panelu a adresy protokolu OTLP (OpenTelemetry Protocol).
  • Interní nastavení, která .NET.NET Aspire používá ke spuštění hostitele aplikace. Jsou nastaveny interně, ale lze k němu přistupovat integracemi, které rozšiřují .NET.NET Aspire.

Konfiguraci hostitele aplikace poskytuje profil spuštění hostitele aplikace. Hostitel aplikace má volání souboru nastavení spuštění launchSettings.json se seznamem profilů spuštění. Každý spouštěcí profil je kolekce souvisejících možností, které definují, jak chcete dotnet spustit aplikaci.

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

Předchozí soubor nastavení spuštění:

  • Má jeden spouštěcí profil s názvem https.
  • Nakonfiguruje hostitelský projekt .NET.NET Aspire aplikace:
    • Vlastnost applicationUrl nakonfiguruje adresu spuštění řídicího panelu (ASPNETCORE_URLS).
    • Proměnné prostředí, jako jsou DOTNET_DASHBOARD_OTLP_ENDPOINT_URL a DOTNET_RESOURCE_SERVICE_ENDPOINT_URL, jsou nastavené na hostiteli aplikace.

Další informace naleznete v tématu .NET.NET Aspire a spouštěcí profily.

Poznámka

Konfigurace popsaná na této stránce je určená pro .NET.NET Aspire projekt hostitele aplikace. Pokud chcete nakonfigurovat samostatný řídicí panel, podívejte se na konfigurace řídicího panelu.

Běžná konfigurace

Možnost Výchozí hodnota Popis
ASPIRE_ALLOW_UNSECURED_TRANSPORT false Umožňuje komunikaci s hostitelem aplikace bez https. ASPNETCORE_URLS (adresa řídicího panelu) a DOTNET_RESOURCE_SERVICE_ENDPOINT_URL (adresa služby prostředků hostitele aplikace) musí být zabezpečeny pomocí protokolu HTTPS, pokud není pravda.
DOTNET_ASPIRE_CONTAINER_RUNTIME docker Umožňuje uživateli alternativních modulů runtime kontejneru pro prostředky zálohované kontejnery. Možné hodnoty jsou docker (výchozí) nebo podman. Další podrobnostinajdete v tématu Nastavení a nástroje.

Služba prostředků

Hostitel aplikace hostuje službu prostředků. Služba prostředků je používána řídicím panelem k načtení informací o prostředcích, které jsou orchestrovány .NET.NET Aspire.

Možnost Výchozí hodnota Popis
DOTNET_RESOURCE_SERVICE_ENDPOINT_URL null Nakonfiguruje adresu služby prostředků hostované hostitelem aplikace. Automaticky vygenerováno pomocí launchSettings.json mít náhodný port na localhost. Například https://localhost:17037.
DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY Automaticky vygenerovaný 128bitový token entropie. Klíč rozhraní API použitý k ověření požadavků provedených ve službě prostředků hostitele aplikace. Klíč rozhraní API se vyžaduje, pokud je hostitel aplikace v režimu spuštění, řídicí panel není zakázaný a řídicí panel není nakonfigurovaný tak, aby umožňoval anonymní přístup pomocí DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.

Palubní deska

Ve výchozím nastavení je řídicí panel automaticky spuštěn hostitelem aplikace. Řídicí panel podporuje vlastní sadu konfiguračnícha některá nastavení je možné nakonfigurovat z hostitele aplikace.

Možnost Výchozí hodnota Popis
ASPNETCORE_URLS null Adresa řídicího panelu Musí být https, pokud ASPIRE_ALLOW_UNSECURED_TRANSPORT nebo DistributedApplicationOptions.AllowUnsecuredTransport true. Automaticky vygenerováno pomocí launchSettings.json mít náhodný port na localhost. Hodnota v nastavení spuštění je nastavena na applicationUrls vlastnost.
ASPNETCORE_ENVIRONMENT Production Nakonfiguruje prostředí, ve kterém se řídicí panel spouští. Další informace naleznete v tématu Použití více prostředí v ASP.NET Core.
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL http://localhost:18889, pokud není nakonfigurovaný žádný koncový bod gRPC. Nakonfiguruje adresu GRPC řídicího panelu OTLP. Používá se řídicím panelem k příjmu telemetrie přes OTLP. Nastavte prostředky jako OTEL_EXPORTER_OTLP_ENDPOINT env var. OTEL_EXPORTER_OTLP_PROTOCOL env var je grpc. Automaticky vygenerováno pomocí launchSettings.json mít náhodný port na localhost.
DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL null Nakonfiguruje adresu HTTP OTLP řídicího panelu. Používá se řídicím panelem k příjmu telemetrie přes OTLP. Pokud je nakonfigurovaná pouze DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL, nastaví se pro prostředky jako OTEL_EXPORTER_OTLP_ENDPOINT env var. OTEL_EXPORTER_OTLP_PROTOCOL env var je http/protobuf.
DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN Automaticky vygenerovaný 128bitový token entropie. Nakonfiguruje token front-endového prohlížeče. Toto je hodnota, která se musí zadat pro přístup k řídicímu panelu, když je režim ověřování BrowserToken. Pokud není zadaný žádný token prohlížeče, při každém spuštění hostitele aplikace se vygeneruje nový token.

Interní

Interní nastavení používají hostitel a integrace aplikace. Interní nastavení nejsou navržená tak, aby byla nakonfigurovaná přímo.

Možnost Výchozí hodnota Popis
AppHost:Directory Kořen obsahu, pokud neexistuje žádný projekt. Adresář projektu, ve kterém se nachází hostitel aplikace. Přístupné z IDistributedApplicationBuilder.AppHostDirectory.
AppHost:Path Adresář v kombinaci s názvem aplikace. Cesta k hostiteli aplikace Zkombinuje adresář s názvem aplikace.
AppHost:Sha256 Vytvoří se z názvu hostitele aplikace, když je hostitel aplikace v režimu publikování. Jinak se vytvoří z cesty hostitele aplikace. Šestnáctkové zakódované hodnoty hash pro aktuální aplikaci Hodnota hash je založená na umístění aplikace na aktuálním počítači, takže je stabilní mezi spuštěními hostitele aplikace.
AppHost:OtlpApiKey Automaticky vygenerovaný 128bitový token entropie. Klíč rozhraní API použitý k ověření požadavků odeslaných do služby OTLP řídicího panelu. Hodnota je k dispozici v případě potřeby: hostitel aplikace je v režimu spuštění, řídicí panel není zakázaný a řídicí panel není nakonfigurovaný tak, aby umožňoval anonymní přístup pomocí DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:BrowserToken Automaticky vygenerovaný 128bitový token entropie. Token prohlížeče použitý k ověření procházení řídicího panelu při spuštění hostitelem aplikace. Token prohlížeče lze nastavit pomocí DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN. Hodnota je k dispozici v případě potřeby: hostitel aplikace je v režimu spuštění, řídicí panel není zakázaný a řídicí panel není nakonfigurovaný tak, aby umožňoval anonymní přístup pomocí DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:ResourceService:AuthMode ApiKey. Pokud je DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS true, hodnota je Unsecured. Režim ověřování používaný pro přístup ke službě prostředků. Hodnota se zobrazí v případě potřeby: hostitel aplikace je v režimu spuštění a řídicí panel není zakázaný.
AppHost:ResourceService:ApiKey Automaticky vygenerovaný 128bitový token entropie. Klíč rozhraní API použitý k ověření požadavků provedených ve službě prostředků hostitele aplikace. Klíč rozhraní API lze nastavit pomocí DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY. Hodnota je k dispozici v případě potřeby: hostitel aplikace je v režimu spuštění, řídicí panel není zakázaný a řídicí panel není nakonfigurovaný tak, aby umožňoval anonymní přístup pomocí DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.