Compartir a través de

Configuración del host de la aplicación

  • Artículo

El proyecto host de la aplicación configura e inicia la aplicación distribuida (DistributedApplication). Cuando un DistributedApplication ejecuta, lee la configuración del host de la aplicación. La configuración se carga desde variables de entorno que se establecen en el host de la aplicación y DistributedApplicationOptions.

La configuración incluye:

  • Configuración para hospedar el servicio de recursos, como las opciones de dirección y autenticación.
  • Configuración que se usa para iniciar el panel de .NET.NET Aspire, como las direcciones de front-end y OpenTelemetry Protocol (OTLP) del panel.
  • Configuración interna que .NET.NET Aspire usa para ejecutar el host de la aplicación. Se establecen internamente, pero se puede acceder a ellas mediante integraciones que extienden .NET.NET Aspire.

El perfil de inicio del host de la aplicación proporciona la configuración del host de la aplicación. El host de la aplicación tiene una llamada de archivo de configuración de inicio launchSettings.json que tiene una lista de perfiles de inicio. Cada perfil de inicio es una colección de opciones relacionadas que definen cómo desea dotnet iniciar la aplicación.

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

El archivo de configuración de inicio anterior:

  • Tiene un perfil de inicio denominado https.
  • Configura un proyecto host de aplicación .NET.NET Aspire:
    • La propiedad applicationUrl configura la dirección de inicio del panel (ASPNETCORE_URLS).
    • Las variables de entorno como DOTNET_DASHBOARD_OTLP_ENDPOINT_URL y DOTNET_RESOURCE_SERVICE_ENDPOINT_URL se establecen en el host de la aplicación.

Para obtener más información, vea .NET.NET Aspire e iniciar perfiles.

Nota

La configuración descrita en esta página es para .NET.NET Aspire proyecto host de la aplicación. Para configurar el panel independiente, consulte configuración del panel.

Configuración común

Opción Valor predeterminado Descripción
ASPIRE_ALLOW_UNSECURED_TRANSPORT false Permite la comunicación con el host de la aplicación sin https. ASPNETCORE_URLS (dirección del panel) y DOTNET_RESOURCE_SERVICE_ENDPOINT_URL (dirección del servicio de recursos del host de aplicaciones) deben protegerse con HTTPS a menos que sea true.
DOTNET_ASPIRE_CONTAINER_RUNTIME docker Permite al usuario de entornos de ejecución de contenedor alternativos para los recursos respaldados por contenedores. Los valores posibles son docker (valor predeterminado) o podman. Consulte información general sobre la configuración y las herramientas para obtener más detalles.

Servicio de recursos

El host de la aplicación hospeda un servicio de recursos. El panel usa el servicio de recursos para capturar información sobre los recursos que está orquestando .NET.NET Aspire.

Opción Valor predeterminado Descripción
DOTNET_RESOURCE_SERVICE_ENDPOINT_URL null Configura la dirección del servicio de recursos hospedado por el host de la aplicación. Se genera automáticamente con launchSettings.json tener un puerto aleatorio en localhost. Por ejemplo, https://localhost:17037.
DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY Token de entropía de 128 bits generado automáticamente. La clave de API que se usa para autenticar las solicitudes realizadas en el servicio de recursos del host de la aplicación. La clave de API es necesaria si el host de la aplicación está en modo de ejecución, el panel no está deshabilitado y el panel no está configurado para permitir el acceso anónimo con DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.

Salpicadero

De forma predeterminada, el host de la aplicación inicia automáticamente el panel. El panel admite su propio conjunto dede configuración y algunas opciones se pueden configurar desde el host de la aplicación.

Opción Valor predeterminado Descripción
ASPNETCORE_URLS null Dirección del panel. Debe ser https a menos que ASPIRE_ALLOW_UNSECURED_TRANSPORT o DistributedApplicationOptions.AllowUnsecuredTransport sea true. Se genera automáticamente con launchSettings.json tener un puerto aleatorio en localhost. El valor de la configuración de inicio se establece en la propiedad applicationUrls.
ASPNETCORE_ENVIRONMENT Production Configura el entorno en el que se ejecuta el panel. Para obtener más información, consulte Uso de varios entornos en ASP.NET Core.
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL http://localhost:18889 si no hay ningún punto de conexión gRPC configurado. Configura la dirección gRPC de OTLP del panel. Lo usa el panel para recibir telemetría sobre OTLP. Establezca en los recursos como OTEL_EXPORTER_OTLP_ENDPOINT env var. El OTEL_EXPORTER_OTLP_PROTOCOL var de desarrollo es grpc. Se genera automáticamente con launchSettings.json tener un puerto aleatorio en localhost.
DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL null Configura la dirección HTTP de OTLP del panel. Lo usa el panel para recibir telemetría sobre OTLP. Si solo DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL está configurado, se establece en los recursos como OTEL_EXPORTER_OTLP_ENDPOINT var de desarrollo. El OTEL_EXPORTER_OTLP_PROTOCOL var de desarrollo es http/protobuf.
DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN Token de entropía de 128 bits generado automáticamente. Configura el token del explorador de front-end. Este es el valor que se debe escribir para acceder al panel cuando el modo de autenticación es BrowserToken. Si no se especifica ningún token de explorador, se genera un nuevo token cada vez que se inicia el host de la aplicación.

Interno

El host de la aplicación y las integraciones usan la configuración interna. Las opciones internas no están diseñadas para configurarse directamente.

Opción Valor predeterminado Descripción
AppHost:Directory Raíz del contenido si no hay ningún proyecto. Directorio del proyecto donde se encuentra el host de la aplicación. Accesible desde el IDistributedApplicationBuilder.AppHostDirectory.
AppHost:Path Directorio combinado con el nombre de la aplicación. Ruta de acceso al host de la aplicación. Combina el directorio con el nombre de la aplicación.
AppHost:Sha256 Se crea a partir del nombre de host de la aplicación cuando el host de la aplicación está en modo de publicación. De lo contrario, se crea a partir de la ruta de acceso del host de la aplicación. Hash codificado hexadecimal para la aplicación actual. El hash se basa en la ubicación de la aplicación en la máquina actual, por lo que es estable entre los inicios del host de la aplicación.
AppHost:OtlpApiKey Token de entropía de 128 bits generado automáticamente. Clave de API que se usa para autenticar las solicitudes enviadas al servicio OTLP del panel. El valor está presente si es necesario: el host de la aplicación está en modo de ejecución, el panel no está deshabilitado y el panel no está configurado para permitir el acceso anónimo con DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:BrowserToken Token de entropía de 128 bits generado automáticamente. El token del explorador que se usa para autenticar la exploración en el panel cuando el host de la aplicación lo inicia. El token del explorador se puede establecer mediante DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN. El valor está presente si es necesario: el host de la aplicación está en modo de ejecución, el panel no está deshabilitado y el panel no está configurado para permitir el acceso anónimo con DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:ResourceService:AuthMode ApiKey. Si DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS es true, el valor es Unsecured. Modo de autenticación que se usa para acceder al servicio de recursos. El valor está presente si es necesario: el host de la aplicación está en modo de ejecución y el panel no está deshabilitado.
AppHost:ResourceService:ApiKey Token de entropía de 128 bits generado automáticamente. La clave de API que se usa para autenticar las solicitudes realizadas en el servicio de recursos del host de la aplicación. La clave de API se puede establecer mediante DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY. El valor está presente si es necesario: el host de la aplicación está en modo de ejecución, el panel no está deshabilitado y el panel no está configurado para permitir el acceso anónimo con DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.