Delen via

Configuratie van app-host

  • Artikel

Het app-hostproject configureert en start uw gedistribueerde toepassing (DistributedApplication). Wanneer een DistributedApplication wordt uitgevoerd, wordt de configuratie van de app-host gelezen. De configuratie wordt geladen vanuit omgevingsvariabelen die zijn ingesteld op de app-host en DistributedApplicationOptions.

Configuratie omvat:

  • Instellingen voor het hosten van de resourceservice, zoals het adres en de verificatieopties.
  • Instellingen die worden gebruikt om het .NET.NET Aspire dashboard te starten, zoals de front-end- en OpenTelemetry Protocol-adressen (OTLP) van het dashboard.
  • Interne instellingen die .NET.NET Aspire gebruikt om de app-host uit te voeren. Deze zijn intern ingesteld, maar kunnen worden geopend door integraties die .NET.NET Aspireuitbreiden.

De configuratie van de app-host wordt geleverd door het startprofiel van de app-host. De app-host heeft een aanroep van het startinstellingenbestand launchSettings.json met een lijst met startprofielen. Elk startprofiel is een verzameling gerelateerde opties waarmee wordt gedefinieerd hoe u dotnet uw toepassing wilt starten.

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

Het voorgaande bestand met instellingen voor starten:

  • Heeft één startprofiel met de naam https.
  • Hiermee configureert u een .NET.NET Aspire app-hostproject:
    • De eigenschap applicationUrl configureert het startadres van het dashboard (ASPNETCORE_URLS).
    • Omgevingsvariabelen zoals DOTNET_DASHBOARD_OTLP_ENDPOINT_URL en DOTNET_RESOURCE_SERVICE_ENDPOINT_URL zijn ingesteld op de app-host.

Zie .NET.NET Aspire en startprofielenvoor meer informatie.

Notitie

De configuratie die op deze pagina wordt beschreven, is bedoeld voor .NET.NET Aspire app-hostproject. Zie dashboardconfiguratieom het zelfstandige dashboard te configureren.

Algemene configuratie

Optie Standaardwaarde Beschrijving
ASPIRE_ALLOW_UNSECURED_TRANSPORT false Hiermee staat u communicatie met de app-host toe zonder https. ASPNETCORE_URLS (dashboardadres) en DOTNET_RESOURCE_SERVICE_ENDPOINT_URL (resourceserviceadres van app-host) moeten worden beveiligd met HTTPS, tenzij waar.
DOTNET_ASPIRE_CONTAINER_RUNTIME docker Hiermee staat u de gebruiker van alternatieve containerruntimes toe voor resources die worden ondersteund door containers. Mogelijke waarden zijn docker (standaard) of podman. Zie Overzicht van setup en hulpprogramma's voor meer informatie.

Resourceservice

Een resourceservice wordt gehost door de app-host. De resourceservice wordt door het dashboard gebruikt om informatie op te halen over resources die worden ingedeeld door .NET.NET Aspire.

Optie Standaardwaarde Beschrijving
DOTNET_RESOURCE_SERVICE_ENDPOINT_URL null Hiermee configureert u het adres van de resourceservice die wordt gehost door de app-host. Automatisch gegenereerd met launchSettings.json om een willekeurige poort op localhostte hebben. Bijvoorbeeld https://localhost:17037.
DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY Automatisch gegenereerd 128-bits entropietoken. De API-sleutel die wordt gebruikt voor het verifiëren van aanvragen die zijn gedaan bij de resourceservice van de app-host. De API-sleutel is vereist als de app-host zich in de uitvoeringsmodus bevindt, het dashboard niet is uitgeschakeld en het dashboard niet is geconfigureerd om anonieme toegang met DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUStoe te staan.

Dashboard

Standaard wordt het dashboard automatisch gestart door de app-host. Het dashboard ondersteunt een eigen set configuratie-en sommige instellingen kunnen worden geconfigureerd vanaf de app-host.

Optie Standaardwaarde Beschrijving
ASPNETCORE_URLS null Dashboardadres. Moet https zijn, tenzij ASPIRE_ALLOW_UNSECURED_TRANSPORT of DistributedApplicationOptions.AllowUnsecuredTransport waar is. Automatisch gegenereerd met launchSettings.json om een willekeurige poort op localhostte hebben. De waarde in startinstellingen is ingesteld op de eigenschap applicationUrls.
ASPNETCORE_ENVIRONMENT Production Hiermee configureert u de omgeving waarop het dashboard wordt uitgevoerd. Zie Meerdere omgevingen gebruiken in ASP.NET Corevoor meer informatie.
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL http://localhost:18889 als er geen gRPC-eindpunt is geconfigureerd. Hiermee configureert u het OTLP gRPC-adres van het dashboard. Wordt gebruikt door het dashboard om telemetrie te ontvangen via OTLP. Stel resources in als de OTEL_EXPORTER_OTLP_ENDPOINT env var. De OTEL_EXPORTER_OTLP_PROTOCOL env var is grpc. Automatisch gegenereerd met launchSettings.json om een willekeurige poort op localhostte hebben.
DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL null Hiermee configureert u het OTLP HTTP-adres van het dashboard. Wordt gebruikt door het dashboard om telemetrie te ontvangen via OTLP. Als alleen DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL is geconfigureerd, wordt deze ingesteld op resources als de OTEL_EXPORTER_OTLP_ENDPOINT env var. De OTEL_EXPORTER_OTLP_PROTOCOL env var is http/protobuf.
DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN Automatisch gegenereerd 128-bits entropietoken. Hiermee configureert u het token van de front-endbrowser. Dit is de waarde die moet worden ingevoerd om toegang te krijgen tot het dashboard wanneer de verificatiemodus BrowserToken is. Als er geen browsertoken is opgegeven, wordt telkens wanneer de app-host wordt gestart een nieuw token gegenereerd.

Intern

Interne instellingen worden gebruikt door de app-host en -integraties. Interne instellingen zijn niet ontworpen om rechtstreeks te worden geconfigureerd.

Optie Standaardwaarde Beschrijving
AppHost:Directory De hoofdmap van de inhoud als er geen project is. Map van het project waar de app-host zich bevindt. Toegankelijk vanuit de IDistributedApplicationBuilder.AppHostDirectory.
AppHost:Path De map in combinatie met de naam van de toepassing. Het pad naar de app-host. De map wordt gecombineerd met de naam van de toepassing.
AppHost:Sha256 Deze wordt gemaakt op basis van de hostnaam van de app wanneer de app-host zich in de publicatiemodus bevindt. Anders wordt het gemaakt op basis van het hostpad van de app. Hex-gecodeerde hash voor de huidige toepassing. De hash is gebaseerd op de locatie van de app op de huidige computer, zodat deze stabiel is tussen het starten van de app-host.
AppHost:OtlpApiKey Automatisch gegenereerd 128-bits entropietoken. De API-sleutel die wordt gebruikt voor het verifiëren van aanvragen die naar de OTLP-service van het dashboard worden verzonden. De waarde is aanwezig indien nodig: de app-host bevindt zich in de uitvoeringsmodus, het dashboard is niet uitgeschakeld en het dashboard is niet geconfigureerd om anonieme toegang met DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUStoe te staan.
AppHost:BrowserToken Automatisch gegenereerd 128-bits entropietoken. Het browsertoken dat wordt gebruikt om browsen naar het dashboard te verifiëren wanneer het wordt gestart door de app-host. Het browsertoken kan worden ingesteld door DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN. De waarde is aanwezig indien nodig: de app-host bevindt zich in de uitvoeringsmodus, het dashboard is niet uitgeschakeld en het dashboard is niet geconfigureerd om anonieme toegang met DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUStoe te staan.
AppHost:ResourceService:AuthMode ApiKey. Als DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS waar is, wordt de waarde Unsecured. De verificatiemodus die wordt gebruikt voor toegang tot de resourceservice. De waarde is aanwezig indien nodig: de app-host bevindt zich in de uitvoeringsmodus en het dashboard is niet uitgeschakeld.
AppHost:ResourceService:ApiKey Automatisch gegenereerd 128-bits entropietoken. De API-sleutel die wordt gebruikt voor het verifiëren van aanvragen die zijn gedaan bij de resourceservice van de app-host. De API-sleutel kan worden ingesteld door DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY. De waarde is aanwezig indien nodig: de app-host bevindt zich in de uitvoeringsmodus, het dashboard is niet uitgeschakeld en het dashboard is niet geconfigureerd om anonieme toegang met DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUStoe te staan.