Configurazione dell'host dell'app

Il progetto host dell'app configura e avvia l'applicazione distribuita (DistributedApplication). Quando un DistributedApplication viene eseguito, legge la configurazione dall'host dell'app. La configurazione viene caricata dalle variabili di ambiente impostate nell'host dell'app e DistributedApplicationOptions.

La configurazione include:

• Impostazioni per l'hosting del servizio risorse, ad esempio le opzioni di indirizzo e autenticazione.
• Impostazioni usate per avviare il dashboard di .NET.NET Aspire, ad esempio gli indirizzi front-end del dashboard e OTLP (OpenTelemetry Protocol).
• Impostazioni interne che .NET.NET Aspire usano per eseguire l'host dell'app. Questi vengono impostati internamente, ma possono essere accessibili dalle integrazioni che estendono .NET.NET Aspire.

La configurazione dell'host dell'app viene fornita dal profilo di avvio dell'host dell'app. L'host dell'app ha una chiamata file di impostazioni di avvio launchSettings.json con un elenco di profili di avvio. Ogni profilo di avvio è una raccolta di opzioni correlate che definisce come si vuole dotnet avviare l'applicazione.

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

Il file delle impostazioni di avvio precedente:

• Ha un profilo di avvio denominato https.
• Configura un progetto host dell'app .NET.NET Aspire:
  • La proprietà applicationUrl configura l'indirizzo di avvio del dashboard (ASPNETCORE_URLS).
  • Le variabili di ambiente, ad esempio DOTNET_DASHBOARD_OTLP_ENDPOINT_URL e DOTNET_RESOURCE_SERVICE_ENDPOINT_URL, vengono impostate nell'host dell'app.

Per altre informazioni, vedere profili di avvio e .NET.NET Aspire.

Nota

La configurazione descritta in questa pagina riguarda .NET.NET Aspire progetto host dell'app. Per configurare il dashboard autonomo, vedere configurazione del dashboard.

Configurazione comune

Opzione	Valore predefinito	Descrizione
ASPIRE_ALLOW_UNSECURED_TRANSPORT	false	Consente la comunicazione con l'host dell'app senza https. ASPNETCORE_URLS (indirizzo del dashboard) e DOTNET_RESOURCE_SERVICE_ENDPOINT_URL (indirizzo del servizio risorse host dell'app) devono essere protetti con HTTPS, a meno che non sia true.
DOTNET_ASPIRE_CONTAINER_RUNTIME	docker	Consente all'utente di runtime di contenitori alternativi per le risorse supportate dai contenitori. I valori possibili sono docker (impostazione predefinita) o podman. Per altre informazioni, vedere Panoramica dell'installazione e degli strumenti.

Servizio risorse

Un servizio risorse è ospitato dall'host dell'app. Il servizio risorse viene usato dal dashboard per recuperare informazioni sulle risorse orchestrate da .NET.NET Aspire.

Opzione	Valore predefinito	Descrizione
DOTNET_RESOURCE_SERVICE_ENDPOINT_URL	null	Configura l'indirizzo del servizio risorse ospitato dall'host dell'app. Generato automaticamente con launchSettings.json per avere una porta casuale in localhost. Ad esempio, https://localhost:17037.
DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY	Token di entropia a 128 bit generato automaticamente.	Chiave API usata per autenticare le richieste effettuate al servizio risorse dell'host dell'app. La chiave API è necessaria se l'host dell'app è in modalità di esecuzione, il dashboard non è disabilitato e il dashboard non è configurato per consentire l'accesso anonimo con DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.

Cruscotto

Per impostazione predefinita, il dashboard viene avviato automaticamente dall'host dell'app. Il dashboard supporta proprio set di configurazionie alcune impostazioni possono essere configurate dall'host dell'app.

Opzione	Valore predefinito	Descrizione
ASPNETCORE_URLS	null	Indirizzo del dashboard. Deve essere https a meno che non sia true ASPIRE_ALLOW_UNSECURED_TRANSPORT o DistributedApplicationOptions.AllowUnsecuredTransport. Generato automaticamente con launchSettings.json per avere una porta casuale in localhost. Il valore nelle impostazioni di avvio è impostato sulla proprietà applicationUrls.
ASPNETCORE_ENVIRONMENT	Production	Configura l'ambiente in cui viene eseguito il dashboard. Per altre informazioni, vedere Usare più ambienti in ASP.NET Core.
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL	http://localhost:18889 se non è configurato alcun endpoint gRPC.	Configura l'indirizzo OTLP gRPC del dashboard. Usato dal dashboard per ricevere i dati di telemetria tramite OTLP. Impostare sulle risorse come OTEL_EXPORTER_OTLP_ENDPOINT env var. La OTEL_EXPORTER_OTLP_PROTOCOL env var è grpc. Generato automaticamente con launchSettings.json per avere una porta casuale in localhost.
DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL	null	Configura l'indirizzo HTTP OTLP del dashboard. Usato dal dashboard per ricevere i dati di telemetria tramite OTLP. Se viene configurato solo DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL, viene impostato sulle risorse come OTEL_EXPORTER_OTLP_ENDPOINT var env. La OTEL_EXPORTER_OTLP_PROTOCOL env var è http/protobuf.
DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN	Token di entropia a 128 bit generato automaticamente.	Configura il token del browser front-end. Si tratta del valore che deve essere immesso per accedere al dashboard quando la modalità di autenticazione è BrowserToken. Se non viene specificato alcun token del browser, viene generato un nuovo token ogni volta che viene avviato l'host dell'app.

Interno

Le impostazioni interne vengono usate dall'host e dalle integrazioni dell'app. Le impostazioni interne non sono progettate per essere configurate direttamente.

Opzione	Valore predefinito	Descrizione
AppHost:Directory	Radice del contenuto se non è presente alcun progetto.	Directory del progetto in cui si trova l'host dell'app. Accessibile dal IDistributedApplicationBuilder.AppHostDirectory.
AppHost:Path	Directory combinata con il nome dell'applicazione.	Percorso dell'host dell'app. Combina la directory con il nome dell'applicazione.
AppHost:Sha256	Viene creato dal nome host dell'app quando l'host dell'app è in modalità di pubblicazione. In caso contrario, viene creato dal percorso host dell'app.	Hash con codifica esadecimale per l'applicazione corrente. L'hash si basa sulla posizione dell'app nel computer corrente, in modo che sia stabile tra l'avvio dell'host dell'app.
AppHost:OtlpApiKey	Token di entropia a 128 bit generato automaticamente.	Chiave API usata per autenticare le richieste inviate al servizio OTLP del dashboard. Il valore è presente se necessario: l'host dell'app è in modalità di esecuzione, il dashboard non è disabilitato e il dashboard non è configurato per consentire l'accesso anonimo con DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:BrowserToken	Token di entropia a 128 bit generato automaticamente.	Token del browser usato per autenticare l'esplorazione al dashboard quando viene avviato dall'host dell'app. Il token del browser può essere impostato da DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN. Il valore è presente se necessario: l'host dell'app è in modalità di esecuzione, il dashboard non è disabilitato e il dashboard non è configurato per consentire l'accesso anonimo con DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:ResourceService:AuthMode	ApiKey. Se DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS è true, il valore è Unsecured.	Modalità di autenticazione usata per accedere al servizio risorse. Il valore è presente se necessario: l'host dell'app è in modalità di esecuzione e il dashboard non è disabilitato.
AppHost:ResourceService:ApiKey	Token di entropia a 128 bit generato automaticamente.	Chiave API usata per autenticare le richieste effettuate al servizio risorse dell'host dell'app. La chiave API può essere impostata da DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY. Il valore è presente se necessario: l'host dell'app è in modalità di esecuzione, il dashboard non è disabilitato e il dashboard non è configurato per consentire l'accesso anonimo con DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.