Udostępnij za pośrednictwem

Konfiguracja hosta aplikacji

  • Artykuł

Projekt hosta aplikacji konfiguruje i uruchamia aplikację rozproszoną (DistributedApplication). Po uruchomieniu DistributedApplication odczytuje konfigurację z hosta aplikacji. Konfiguracja jest ładowana ze zmiennych środowiskowych ustawionych na hoście aplikacji i DistributedApplicationOptions.

Konfiguracja obejmuje:

  • Ustawienia hostowania usługi zasobów, takie jak adres i opcje uwierzytelniania.
  • Ustawienia używane do uruchamiania pulpitu nawigacyjnego .NET.NET Aspire, takich jak fronton pulpitu nawigacyjnego i OpenTelemetry adresy protokołu (OTLP).
  • Ustawienia wewnętrzne, które .NET.NET Aspire używać do uruchamiania hosta aplikacji. Są one ustawiane wewnętrznie, ale mogą być dostępne przez integracje, które rozszerzają .NET.NET Aspire.

Konfiguracja hosta aplikacji jest dostarczana przez profil uruchamiania hosta aplikacji. Host aplikacji ma wywołanie pliku ustawień uruchamiania launchSettings.json z listą profilów uruchamiania. Każdy profil uruchamiania to kolekcja powiązanych opcji, które definiują sposób dotnet uruchamiania aplikacji.

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

Poprzedni plik ustawień uruchamiania:

  • Ma jeden profil uruchamiania o nazwie https.
  • Konfiguruje projekt hosta aplikacji .NET.NET Aspire:
    • Właściwość applicationUrl konfiguruje adres uruchamiania pulpitu nawigacyjnego (ASPNETCORE_URLS).
    • Zmienne środowiskowe, takie jak DOTNET_DASHBOARD_OTLP_ENDPOINT_URL i DOTNET_RESOURCE_SERVICE_ENDPOINT_URL, są ustawiane na hoście aplikacji.

Aby uzyskać więcej informacji, zobacz .NET.NET Aspire i uruchom profile.

Nuta

Konfiguracja opisana na tej stronie dotyczy projektu hosta aplikacji .NET.NET Aspire. Aby skonfigurować autonomiczny pulpit nawigacyjny, zobacz konfiguracja pulpitu nawigacyjnego.

Typowa konfiguracja

Opcja Wartość domyślna Opis
ASPIRE_ALLOW_UNSECURED_TRANSPORT false Umożliwia komunikację z hostem aplikacji bez protokołu HTTPS. ASPNETCORE_URLS (adres pulpitu nawigacyjnego) i DOTNET_RESOURCE_SERVICE_ENDPOINT_URL (adres usługi zasobów hosta aplikacji) muszą być zabezpieczone przy użyciu protokołu HTTPS, chyba że prawda.
DOTNET_ASPIRE_CONTAINER_RUNTIME docker Umożliwia użytkownikowi alternatywnych środowisk uruchomieniowych kontenerów dla zasobów wspieranych przez kontenery. Możliwe wartości to docker (wartość domyślna) lub podman. Zobacz Setup and tooling overview (Omówienie instalacji i narzędzi), aby uzyskać więcej szczegółów.

Usługa zasobów

Usługa zasobów jest hostowana przez hosta aplikacji. Usługa zasobów jest używana przez pulpit nawigacyjny do pobierania informacji o zasobach, które są orkiestrowane przez .NET.NET Aspire.

Opcja Wartość domyślna Opis
DOTNET_RESOURCE_SERVICE_ENDPOINT_URL null Konfiguruje adres usługi zasobów hostowanej przez hosta aplikacji. Automatycznie generowane przy użyciu launchSettings.json, aby mieć losowy port na localhost. Na przykład https://localhost:17037.
DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY Automatycznie wygenerowano 128-bitowy token entropii. Klucz interfejsu API używany do uwierzytelniania żądań wysyłanych do usługi zasobów hosta aplikacji. Klucz interfejsu API jest wymagany, jeśli host aplikacji jest w trybie uruchamiania, pulpit nawigacyjny nie jest wyłączony, a pulpit nawigacyjny nie jest skonfigurowany do zezwalania na dostęp anonimowy za pomocą DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.

Deska rozdzielcza

Domyślnie pulpit nawigacyjny jest automatycznie uruchamiany przez hosta aplikacji. Pulpit nawigacyjny obsługuje własny zestawkonfiguracji, a niektóre ustawienia można skonfigurować na hoście aplikacji.

Opcja Wartość domyślna Opis
ASPNETCORE_URLS null Adres pulpitu nawigacyjnego. Musi być https, chyba że ASPIRE_ALLOW_UNSECURED_TRANSPORT lub DistributedApplicationOptions.AllowUnsecuredTransport jest prawdziwe. Automatycznie generowane przy użyciu launchSettings.json, aby mieć losowy port na localhost. Wartość w ustawieniach uruchamiania jest ustawiana we właściwości applicationUrls.
ASPNETCORE_ENVIRONMENT Production Konfiguruje środowisko, w ramach których jest uruchamiany pulpit nawigacyjny. Aby uzyskać więcej informacji, zobacz Use multiple environments in ASP.NET Core.
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL http://localhost:18889, jeśli nie skonfigurowano punktu końcowego gRPC. Konfiguruje adres gRPC pulpitu nawigacyjnego OTLP. Używany przez pulpit nawigacyjny do odbierania danych telemetrycznych za pośrednictwem protokołu OTLP. Ustaw dla zasobów jako OTEL_EXPORTER_OTLP_ENDPOINT env var. Wariancja OTEL_EXPORTER_OTLP_PROTOCOL env jest grpc. Automatycznie generowane przy użyciu launchSettings.json, aby mieć losowy port na localhost.
DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL null Konfiguruje adres HTTP OTLP pulpitu nawigacyjnego. Używany przez pulpit nawigacyjny do odbierania danych telemetrycznych za pośrednictwem protokołu OTLP. Jeśli skonfigurowano tylko DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL, jest ona ustawiana na zasobach jako OTEL_EXPORTER_OTLP_ENDPOINT env var. Wariancja OTEL_EXPORTER_OTLP_PROTOCOL env jest http/protobuf.
DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN Automatycznie wygenerowano 128-bitowy token entropii. Konfiguruje token przeglądarki frontonu. Jest to wartość, którą należy wprowadzić, aby uzyskać dostęp do pulpitu nawigacyjnego, gdy tryb uwierzytelniania to BrowserToken. Jeśli nie określono tokenu przeglądarki, nowy token jest generowany za każdym razem, gdy host aplikacji zostanie uruchomiony.

Wewnętrzny

Ustawienia wewnętrzne są używane przez hosta aplikacji i integracje. Ustawienia wewnętrzne nie są przeznaczone do bezpośredniej konfiguracji.

Opcja Wartość domyślna Opis
AppHost:Directory Katalog główny zawartości, jeśli nie ma projektu. Katalog projektu, w którym znajduje się host aplikacji. Dostępny z IDistributedApplicationBuilder.AppHostDirectory.
AppHost:Path Katalog połączony z nazwą aplikacji. Ścieżka do hosta aplikacji. Łączy katalog z nazwą aplikacji.
AppHost:Sha256 Jest on tworzony na podstawie nazwy hosta aplikacji, gdy host aplikacji jest w trybie publikowania. W przeciwnym razie zostanie on utworzony na podstawie ścieżki hosta aplikacji. Skrót zakodowany szesnastkowy dla bieżącej aplikacji. Skrót jest oparty na lokalizacji aplikacji na bieżącej maszynie, więc jest stabilna między uruchamianiem hosta aplikacji.
AppHost:OtlpApiKey Automatycznie wygenerowano 128-bitowy token entropii. Klucz interfejsu API używany do uwierzytelniania żądań wysyłanych do usługi OTLP pulpitu nawigacyjnego. Wartość jest obecna w razie potrzeby: host aplikacji jest w trybie uruchamiania, pulpit nawigacyjny nie jest wyłączony, a pulpit nawigacyjny nie jest skonfigurowany do zezwalania na dostęp anonimowy za pomocą DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:BrowserToken Automatycznie wygenerowano 128-bitowy token entropii. Token przeglądarki używany do uwierzytelniania przeglądania pulpitu nawigacyjnego podczas jego uruchamiania przez hosta aplikacji. Token przeglądarki można ustawić za pomocą DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN. Wartość jest obecna w razie potrzeby: host aplikacji jest w trybie uruchamiania, pulpit nawigacyjny nie jest wyłączony, a pulpit nawigacyjny nie jest skonfigurowany do zezwalania na dostęp anonimowy za pomocą DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:ResourceService:AuthMode ApiKey. Jeśli DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS ma wartość true, wartość jest Unsecured. Tryb uwierzytelniania używany do uzyskiwania dostępu do usługi zasobów. Wartość jest obecna w razie potrzeby: host aplikacji jest w trybie uruchamiania i pulpit nawigacyjny nie jest wyłączony.
AppHost:ResourceService:ApiKey Automatycznie wygenerowano 128-bitowy token entropii. Klucz interfejsu API używany do uwierzytelniania żądań wysyłanych do usługi zasobów hosta aplikacji. Klucz interfejsu API można ustawić za pomocą DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY. Wartość jest obecna w razie potrzeby: host aplikacji jest w trybie uruchamiania, pulpit nawigacyjny nie jest wyłączony, a pulpit nawigacyjny nie jest skonfigurowany do zezwalania na dostęp anonimowy za pomocą DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.