Dela via

Appvärdkonfiguration

  • Artikel

Appvärdprojektet konfigurerar och startar ditt distribuerade program (DistributedApplication). När en DistributedApplication kör läser den konfigurationen från appvärden. Konfigurationen läses in från miljövariabler som anges på appvärden och DistributedApplicationOptions.

Konfigurationen omfattar:

  • Inställningar för att vara värd för resurstjänsten, till exempel adress- och autentiseringsalternativ.
  • Inställningar som används för att starta .NET.NET Aspire instrumentpanelen, till exempel instrumentpanelens klientdels- och OpenTelemetry Protocol-adresser (OTLP).
  • Interna inställningar som .NET.NET Aspire använder för att köra appvärden. Dessa anges internt men kan nås av integreringar som utökar .NET.NET Aspire.

Appvärdkonfigurationen tillhandahålls av appvärdstartprofilen. Appvärden har ett filanrop för startinställningar launchSettings.json som har en lista över startprofiler. Varje startprofil är en samling relaterade alternativ som definierar hur du vill att dotnet ska starta programmet.

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

Föregående startinställningsfil:

  • Har en startprofil med namnet https.
  • Konfigurerar ett .NET.NET Aspire appvärdprojekt:
    • Egenskapen applicationUrl konfigurerar startadressen för instrumentpanelen (ASPNETCORE_URLS).
    • Miljövariabler som DOTNET_DASHBOARD_OTLP_ENDPOINT_URL och DOTNET_RESOURCE_SERVICE_ENDPOINT_URL anges på appvärden.

Mer information finns i .NET.NET Aspire och starta profiler.

Not

Konfigurationen som beskrivs på den här sidan gäller för .NET.NET Aspire appvärdprojekt. Information om hur du konfigurerar den fristående instrumentpanelen finns i instrumentpanelskonfiguration.

Gemensam konfiguration

Alternativ Standardvärde Beskrivning
ASPIRE_ALLOW_UNSECURED_TRANSPORT false Tillåter kommunikation med appvärden utan https. ASPNETCORE_URLS (instrumentpanelsadress) och DOTNET_RESOURCE_SERVICE_ENDPOINT_URL (appvärdresurstjänstadress) måste skyddas med HTTPS om inte sant.
DOTNET_ASPIRE_CONTAINER_RUNTIME docker Tillåter användare av alternativa containerkörningar för resurser som backas upp av containrar. Möjliga värden är docker (standard) eller podman. Mer informationfinns i installations- och verktygsöversikt.

Resurstjänst

En resurstjänst hanteras av appvärden. Resurstjänsten används av instrumentpanelen för att hämta information om resurser som samordnas av .NET.NET Aspire.

Alternativ Standardvärde Beskrivning
DOTNET_RESOURCE_SERVICE_ENDPOINT_URL null Konfigurerar adressen till den resurstjänst som värdhanteras av appvärden. Genereras automatiskt med launchSettings.json för att ha en slumpmässig port på localhost. Till exempel https://localhost:17037.
DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY Genererad 128-bitars entropitoken automatiskt. API-nyckeln som används för att autentisera begäranden som görs till appvärdens resurstjänst. API-nyckeln krävs om appvärden är i körningsläge, instrumentpanelen inte är inaktiverad och instrumentpanelen inte har konfigurerats för att tillåta anonym åtkomst med DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.

Instrumentbräda

Som standard startas instrumentpanelen automatiskt av appvärden. Instrumentpanelen stöder en egen uppsättning konfigurationoch vissa inställningar kan konfigureras från appvärden.

Alternativ Standardvärde Beskrivning
ASPNETCORE_URLS null Instrumentpanelsadress. Måste vara https om inte ASPIRE_ALLOW_UNSECURED_TRANSPORT eller DistributedApplicationOptions.AllowUnsecuredTransport är sant. Genereras automatiskt med launchSettings.json för att ha en slumpmässig port på localhost. Värdet i startinställningarna anges för egenskapen applicationUrls.
ASPNETCORE_ENVIRONMENT Production Konfigurerar miljön som instrumentpanelen körs som. Mer information finns i Använda flera miljöer i ASP.NET Core.
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL http://localhost:18889 om ingen gRPC-slutpunkt har konfigurerats. Konfigurerar OTLP gRPC-adressen på instrumentpanelen. Används av instrumentpanelen för att ta emot telemetri över OTLP. Ange resurser som OTEL_EXPORTER_OTLP_ENDPOINT env var. OTEL_EXPORTER_OTLP_PROTOCOL env var är grpc. Genereras automatiskt med launchSettings.json för att ha en slumpmässig port på localhost.
DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL null Konfigurerar OTLP HTTP-adressen för instrumentpanelen. Används av instrumentpanelen för att ta emot telemetri över OTLP. Om endast DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL har konfigurerats anges den på resurser som OTEL_EXPORTER_OTLP_ENDPOINT env var. OTEL_EXPORTER_OTLP_PROTOCOL env var är http/protobuf.
DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN Genererad 128-bitars entropitoken automatiskt. Konfigurerar klientdelens webbläsartoken. Det här är det värde som måste anges för att få åtkomst till instrumentpanelen när autentiseringsläget är BrowserToken. Om ingen webbläsartoken anges genereras en ny token varje gång appvärden startas.

Inre

Interna inställningar används av appvärden och integreringarna. Interna inställningar är inte utformade för att konfigureras direkt.

Alternativ Standardvärde Beskrivning
AppHost:Directory Innehållsroten om det inte finns något projekt. Katalog för projektet där appvärden finns. Tillgänglig från IDistributedApplicationBuilder.AppHostDirectory.
AppHost:Path Katalogen i kombination med programnamnet. Sökvägen till appvärden. Den kombinerar katalogen med programnamnet.
AppHost:Sha256 Den skapas från appens värdnamn när appvärden är i publiceringsläge. Annars skapas den från appens värdsökväg. Hexkodad hash för det aktuella programmet. Hashen baseras på appens plats på den aktuella datorn så att den är stabil mellan starterna av appvärden.
AppHost:OtlpApiKey Genererad 128-bitars entropitoken automatiskt. API-nyckeln som används för att autentisera begäranden som skickas till OTLP-tjänsten på instrumentpanelen. Värdet finns om det behövs: appvärden är i körningsläge, instrumentpanelen är inte inaktiverad och instrumentpanelen är inte konfigurerad för att tillåta anonym åtkomst med DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:BrowserToken Genererad 128-bitars entropitoken automatiskt. Webbläsartoken som används för att autentisera surfning till instrumentpanelen när den startas av appvärden. Webbläsartoken kan anges av DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN. Värdet finns om det behövs: appvärden är i körningsläge, instrumentpanelen är inte inaktiverad och instrumentpanelen är inte konfigurerad för att tillåta anonym åtkomst med DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:ResourceService:AuthMode ApiKey. Om DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS är sant är värdet Unsecured. Det autentiseringsläge som används för att komma åt resurstjänsten. Värdet finns vid behov: appvärden är i körningsläge och instrumentpanelen är inte inaktiverad.
AppHost:ResourceService:ApiKey Genererad 128-bitars entropitoken automatiskt. API-nyckeln som används för att autentisera begäranden som görs till appvärdens resurstjänst. API-nyckeln kan anges av DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY. Värdet finns om det behövs: appvärden är i körningsläge, instrumentpanelen är inte inaktiverad och instrumentpanelen är inte konfigurerad för att tillåta anonym åtkomst med DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.