Configuração do host do aplicativo

O projeto de host do aplicativo configura e inicia seu aplicativo distribuído (DistributedApplication). Quando um DistributedApplication é executado, ele lê a configuração do host do aplicativo. A configuração é carregada a partir de variáveis de ambiente definidas no host e no DistributedApplicationOptionsdo aplicativo.

A configuração inclui:

• Configurações para hospedar o serviço de recurso, como as opções de endereço e autenticação.
• As configurações usadas para iniciar o painel .NET.NET Aspire, como os endereços frontend e OTLP (OpenTelemetry Protocol) do painel.
• Configurações internas que .NET.NET Aspire usa para executar o host do aplicativo. Eles são definidos internamente, mas podem ser acessados por integrações que se estendem .NET.NET Aspire.

A configuração do host do aplicativo é fornecida pelo perfil de inicialização do host do aplicativo. O host do aplicativo tem uma chamada de arquivo de configurações de inicialização launchSettings.json que tem uma lista de perfis de lançamento. Cada perfil de inicialização é uma coleção de opções relacionadas que define como você gostaria que dotnet iniciassem seu aplicativo.

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

O arquivo de configurações de inicialização anterior:

• Tem um perfil de lançamento chamado https.
• Configura um projeto de host de aplicativo .NET.NET Aspire:
  • A propriedade applicationUrl configura o endereço de inicialização do painel (ASPNETCORE_URLS).
  • As variáveis de ambiente, como DOTNET_DASHBOARD_OTLP_ENDPOINT_URL e DOTNET_RESOURCE_SERVICE_ENDPOINT_URL, são definidas no host do aplicativo.

Para obter mais informações, consulte .NET.NET Aspire e iniciar perfis.

Observação

A configuração descrita nesta página é para .NET.NET Aspire projeto de host de aplicativo. Para configurar o painel autônomo, consulte configuração do painel.

Configuração comum

Opção	Valor padrão	Descrição
ASPIRE_ALLOW_UNSECURED_TRANSPORT	false	Permite a comunicação com o host do aplicativo sem https. ASPNETCORE_URLS (endereço do painel) e DOTNET_RESOURCE_SERVICE_ENDPOINT_URL (endereço do serviço de recursos do host do aplicativo) devem ser protegidos com HTTPS, a menos que sejam verdadeiros.
DOTNET_ASPIRE_CONTAINER_RUNTIME	docker	Permite que o usuário de tempos de execução de contêineres alternativos para recursos apoiados por contêineres. Os valores possíveis são docker (padrão) ou podman. Consulte Visão geral de configuração e ferramentas para obter mais detalhes.

Serviço de recursos

Um serviço de recurso é hospedado pelo host do aplicativo. O serviço de recursos é usado pelo painel para buscar informações sobre recursos que estão sendo orquestrados por .NET.NET Aspire.

Opção	Valor padrão	Descrição
DOTNET_RESOURCE_SERVICE_ENDPOINT_URL	null	Configura o endereço do serviço de recursos hospedado pelo host do aplicativo. Gerado automaticamente com launchSettings.json ter uma porta aleatória no localhost. Por exemplo, https://localhost:17037.
DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY	Token de entropia de 128 bits gerado automaticamente.	A chave de API usada para autenticar solicitações feitas ao serviço de recursos do host do aplicativo. A chave de API é necessária se o host do aplicativo estiver no modo de execução, o painel não estiver desativado e o painel não estiver configurado para permitir acesso anônimo com DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.

Painel de instrumentos

Por padrão, o painel é iniciado automaticamente pelo host do aplicativo. O painel suporta seu próprio conjunto dede configuração e algumas configurações podem ser definidas a partir do host do aplicativo.

Opção	Valor padrão	Descrição
ASPNETCORE_URLS	null	Endereço do painel. Deve ser https a menos que ASPIRE_ALLOW_UNSECURED_TRANSPORT ou DistributedApplicationOptions.AllowUnsecuredTransport seja verdade. Gerado automaticamente com launchSettings.json ter uma porta aleatória no localhost. O valor nas configurações de inicialização é definido na propriedade applicationUrls.
ASPNETCORE_ENVIRONMENT	Production	Configura o ambiente em que o painel é executado. Para obter mais informações, consulte Usar vários ambientes no ASP.NET Core.
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL	http://localhost:18889 se nenhum ponto de extremidade gRPC estiver configurado.	Configura o endereço gRPC OTLP do painel. Usado pelo painel para receber telemetria por OTLP. Defina em recursos como o OTEL_EXPORTER_OTLP_ENDPOINT env var. O OTEL_EXPORTER_OTLP_PROTOCOL env var é grpc. Gerado automaticamente com launchSettings.json ter uma porta aleatória no localhost.
DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL	null	Configura o endereço HTTP OTLP do painel. Usado pelo painel para receber telemetria por OTLP. Se apenas DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL estiver configurado, ele será definido em recursos como o OTEL_EXPORTER_OTLP_ENDPOINT env var. O OTEL_EXPORTER_OTLP_PROTOCOL env var é http/protobuf.
DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN	Token de entropia de 128 bits gerado automaticamente.	Configura o token do navegador frontend. Este é o valor que deve ser inserido para acessar o painel quando o modo de autenticação é BrowserToken. Se nenhum token do navegador for especificado, um novo token será gerado cada vez que o host do aplicativo for iniciado.

Interno

As configurações internas são usadas pelo host do aplicativo e pelas integrações. As configurações internas não foram projetadas para serem configuradas diretamente.

Opção	Valor padrão	Descrição
AppHost:Directory	A raiz do conteúdo se não houver nenhum projeto.	Diretório do projeto onde o host do aplicativo está localizado. Acessível a partir do IDistributedApplicationBuilder.AppHostDirectory.
AppHost:Path	O diretório combinado com o nome do aplicativo.	O caminho para o host do aplicativo. Ele combina o diretório com o nome do aplicativo.
AppHost:Sha256	Ele é criado a partir do nome do host do aplicativo quando o host do aplicativo está no modo de publicação. Caso contrário, ele será criado a partir do caminho do host do aplicativo.	Hash codificado hexadecimal para o aplicativo atual. O hash é baseado na localização do aplicativo na máquina atual, portanto, é estável entre as inicializações do host do aplicativo.
AppHost:OtlpApiKey	Token de entropia de 128 bits gerado automaticamente.	A chave de API usada para autenticar solicitações enviadas para o serviço OTLP do painel. O valor está presente se necessário: o host do aplicativo está no modo de execução, o painel não está desativado e o painel não está configurado para permitir acesso anônimo com DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:BrowserToken	Token de entropia de 128 bits gerado automaticamente.	O token do navegador usado para autenticar a navegação no painel quando ele é iniciado pelo host do aplicativo. O token do navegador pode ser definido por DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN. O valor está presente se necessário: o host do aplicativo está no modo de execução, o painel não está desativado e o painel não está configurado para permitir acesso anônimo com DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:ResourceService:AuthMode	ApiKey. Se DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS for verdadeiro, então o valor é Unsecured.	O modo de autenticação usado para acessar o serviço de recurso. O valor está presente se necessário: o host do aplicativo está no modo de execução e o painel não está desativado.
AppHost:ResourceService:ApiKey	Token de entropia de 128 bits gerado automaticamente.	A chave de API usada para autenticar solicitações feitas ao serviço de recursos do host do aplicativo. A chave da API pode ser definida por DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY. O valor está presente se necessário: o host do aplicativo está no modo de execução, o painel não está desativado e o painel não está configurado para permitir acesso anônimo com DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.