App-Hostkonfiguration

Das App-Hostprojekt konfiguriert und startet die verteilte Anwendung (DistributedApplication). Wenn ein DistributedApplication ausgeführt wird, liest er die Konfiguration vom App-Host aus. Die Konfiguration wird aus Umgebungsvariablen geladen, die auf dem App-Host festgelegt sind, und DistributedApplicationOptions.

Die Konfiguration umfasst:

• Einstellungen für das Hosten des Ressourcendiensts, z. B. die Adress- und Authentifizierungsoptionen.
• Einstellungen, die verwendet werden, um das .NET.NET Aspire-Dashboardzu starten, z. B. die Frontend- und OpenTelemetry-Protokolladressen (OTLP).
• Interne Einstellungen, die .NET.NET Aspire zum Ausführen des App-Hosts verwendet. Diese werden intern festgelegt, können jedoch durch Integrationen aufgerufen werden, die .NET.NET Aspireerweitern.

Die App-Hostkonfiguration wird vom App-Hoststartprofil bereitgestellt. Der App-Host verfügt über einen Dateiaufruf der Starteinstellungen launchSettings.json mit einer Liste von Startprofilen. Jedes Startprofil ist eine Sammlung verwandter Optionen, die definieren, wie sie dotnet ihre Anwendung starten möchten.

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

Die vorherige Starteinstellungsdatei:

• Verfügt über ein Startprofil mit dem Namen https.
• Konfiguriert ein .NET.NET Aspire App-Hostprojekt:
  • Die eigenschaft applicationUrl konfiguriert die Startadresse des Dashboards (ASPNETCORE_URLS).
  • Umgebungsvariablen wie DOTNET_DASHBOARD_OTLP_ENDPOINT_URL und DOTNET_RESOURCE_SERVICE_ENDPOINT_URL werden auf dem App-Host festgelegt.

Weitere Informationen finden Sie unter .NET.NET Aspire und Starten von Profilen.

Anmerkung

Die auf dieser Seite beschriebene Konfiguration ist für .NET.NET Aspire App-Hostprojekt vorgesehen. Informationen zum Konfigurieren des eigenständigen Dashboards finden Sie unter Dashboardkonfiguration.

Allgemeine Konfiguration

Option	Standardwert	Beschreibung
ASPIRE_ALLOW_UNSECURED_TRANSPORT	false	Ermöglicht die Kommunikation mit dem App-Host ohne https. ASPNETCORE_URLS (Dashboardadresse) und DOTNET_RESOURCE_SERVICE_ENDPOINT_URL (Adresse des App-Hostressourcendiensts) müssen mit HTTPS gesichert werden, es sei denn, true.
DOTNET_ASPIRE_CONTAINER_RUNTIME	docker	Ermöglicht dem Benutzer alternativer Containerlaufzeiten für Ressourcen, die von Containern unterstützt werden. Mögliche Werte sind docker (Standard) oder podman. Weitere Informationenfinden Sie unter Übersicht über Setup und Tools.

Ressourcendienst

Ein Ressourcendienst wird vom App-Host gehostet. Der Ressourcendienst wird vom Dashboard verwendet, um Informationen zu Ressourcen abzurufen, die von .NET.NET Aspireorchestriert werden.

Option	Standardwert	Beschreibung
DOTNET_RESOURCE_SERVICE_ENDPOINT_URL	null	Konfiguriert die Adresse des vom App-Host gehosteten Ressourcendiensts. Automatisch mit launchSettings.json generiert, um einen zufälligen Port auf localhostzu haben. Beispiel: https://localhost:17037.
DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY	Automatisch generiertes 128-Bit-Entropietoken.	Der ZUM Authentifizieren von Anforderungen an den Ressourcendienst des App-Hosts verwendete API-Schlüssel. Der API-Schlüssel ist erforderlich, wenn sich der App-Host im Ausführungsmodus befindet, das Dashboard nicht deaktiviert ist und das Dashboard nicht so konfiguriert ist, dass anonymer Zugriff mit DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUSzulässig ist.

Instrumententafel

Standardmäßig wird das Dashboard automatisch vom App-Host gestartet. Das Dashboard unterstützt eigenen Konfigurationssatz, und einige Einstellungen können vom App-Host konfiguriert werden.

Option	Standardwert	Beschreibung
ASPNETCORE_URLS	null	Dashboardadresse. Muss https sein, es sei denn, ASPIRE_ALLOW_UNSECURED_TRANSPORT oder DistributedApplicationOptions.AllowUnsecuredTransport ist wahr. Automatisch mit launchSettings.json generiert, um einen zufälligen Port auf localhostzu haben. Der Wert in den Starteinstellungen wird für die eigenschaft applicationUrls festgelegt.
ASPNETCORE_ENVIRONMENT	Production	Konfiguriert die Umgebung, in der das Dashboard ausgeführt wird. Weitere Informationen finden Sie unter Verwenden mehrerer Umgebungen in ASP.NET Core.
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL	http://localhost:18889, wenn kein gRPC-Endpunkt konfiguriert ist.	Konfiguriert die Dashboard-OTLP gRPC-Adresse. Wird vom Dashboard verwendet, um Telemetrie über OTLP zu empfangen. Legen Sie für Ressourcen als OTEL_EXPORTER_OTLP_ENDPOINT env var fest. Der OTEL_EXPORTER_OTLP_PROTOCOL env var ist grpc. Automatisch mit launchSettings.json generiert, um einen zufälligen Port auf localhostzu haben.
DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL	null	Konfiguriert die OTLP-HTTP-Adresse des Dashboards. Wird vom Dashboard verwendet, um Telemetrie über OTLP zu empfangen. Wenn nur DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL konfiguriert ist, wird sie für Ressourcen als OTEL_EXPORTER_OTLP_ENDPOINT env var festgelegt. Der OTEL_EXPORTER_OTLP_PROTOCOL env var ist http/protobuf.
DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN	Automatisch generiertes 128-Bit-Entropietoken.	Konfiguriert das Frontend-Browsertoken. Dies ist der Wert, der eingegeben werden muss, um auf das Dashboard zuzugreifen, wenn der Authentifizierungsmodus BrowserToken ist. Wenn kein Browsertoken angegeben wird, wird jedes Mal, wenn der App-Host gestartet wird, ein neues Token generiert.

Intern

Interne Einstellungen werden vom App-Host und von Integrationen verwendet. Interne Einstellungen sind nicht für die direkte Konfiguration konzipiert.

Option	Standardwert	Beschreibung
AppHost:Directory	Der Inhaltsstamm, wenn kein Projekt vorhanden ist.	Verzeichnis des Projekts, in dem sich der App-Host befindet. Zugriff über die IDistributedApplicationBuilder.AppHostDirectory.
AppHost:Path	Das Verzeichnis in Kombination mit dem Anwendungsnamen.	Der Pfad zum App-Host. Es kombiniert das Verzeichnis mit dem Anwendungsnamen.
AppHost:Sha256	Sie wird aus dem App-Hostnamen erstellt, wenn sich der App-Host im Veröffentlichungsmodus befindet. Andernfalls wird sie aus dem App-Hostpfad erstellt.	Hex-codierter Hash für die aktuelle Anwendung. Der Hash basiert auf dem Speicherort der App auf dem aktuellen Computer, sodass er zwischen dem Start des App-Hosts stabil ist.
AppHost:OtlpApiKey	Automatisch generiertes 128-Bit-Entropietoken.	Der API-Schlüssel, der zum Authentifizieren von Anforderungen verwendet wird, die an den OTLP-Dashboarddienst gesendet werden. Der Wert ist bei Bedarf vorhanden: Der App-Host befindet sich im Ausführungsmodus, das Dashboard ist nicht deaktiviert, und das Dashboard ist nicht so konfiguriert, dass anonymer Zugriff mit DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUSzulässig ist.
AppHost:BrowserToken	Automatisch generiertes 128-Bit-Entropietoken.	Das Browsertoken, das zum Authentifizieren des Browsens am Dashboard verwendet wird, wenn es vom App-Host gestartet wird. Das Browsertoken kann durch DOTNET_DASHBOARD_FRONTEND_BROWSERTOKENfestgelegt werden. Der Wert ist bei Bedarf vorhanden: Der App-Host befindet sich im Ausführungsmodus, das Dashboard ist nicht deaktiviert, und das Dashboard ist nicht so konfiguriert, dass anonymer Zugriff mit DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUSzulässig ist.
AppHost:ResourceService:AuthMode	ApiKey. Wenn DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS "true" ist, wird der Wert Unsecured.	Der Authentifizierungsmodus, der für den Zugriff auf den Ressourcendienst verwendet wird. Der Wert ist bei Bedarf vorhanden: Der App-Host befindet sich im Ausführungsmodus und das Dashboard ist nicht deaktiviert.
AppHost:ResourceService:ApiKey	Automatisch generiertes 128-Bit-Entropietoken.	Der ZUM Authentifizieren von Anforderungen an den Ressourcendienst des App-Hosts verwendete API-Schlüssel. Der API-Schlüssel kann durch DOTNET_DASHBOARD_RESOURCESERVICE_APIKEYfestgelegt werden. Der Wert ist bei Bedarf vorhanden: Der App-Host befindet sich im Ausführungsmodus, das Dashboard ist nicht deaktiviert, und das Dashboard ist nicht so konfiguriert, dass anonymer Zugriff mit DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUSzulässig ist.