Поделиться через

Конфигурация узла приложения

  • Статья

Проект узла приложения настраивает и запускает распределенное приложение (DistributedApplication). При запуске DistributedApplication он считывает конфигурацию с узла приложения. Конфигурация загружается из переменных среды, заданных на узле приложения и DistributedApplicationOptions.

Конфигурация включает:

  • Параметры размещения службы ресурсов, такие как параметры адреса и проверки подлинности.
  • Параметры, используемые для запуска .NET.NET Aspire панели мониторинга, например внешний интерфейс панели панели мониторинга и OpenTelemetry протокол (OTLP).
  • Внутренние параметры, которые .NET.NET Aspire используются для запуска узла приложения. Они задаются внутри системы, но доступ к ней можно получить с помощью интеграции, расширяющей .NET.NET Aspire.

Конфигурация узла приложения предоставляется профилем запуска узла приложения. Узел приложения имеет вызов параметров запуска launchSettings.json который содержит список профилей запуска. Каждый профиль запуска — это коллекция связанных параметров, определяющих способ dotnet запуска приложения.

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

Предыдущий файл параметров запуска:

  • Имеет один профиль запуска с именем https.
  • Настраивает проект узла приложения .NET.NET Aspire:
    • Свойство applicationUrl настраивает адрес запуска панели мониторинга (ASPNETCORE_URLS).
    • Переменные среды, такие как DOTNET_DASHBOARD_OTLP_ENDPOINT_URL и DOTNET_RESOURCE_SERVICE_ENDPOINT_URL, задаются на узле приложения.

Дополнительные сведения см. в .NET.NET Aspire и профилях запуска.

Заметка

Конфигурация, описанная на этой странице, предназначена для .NET.NET Aspire проекта узла приложения. Сведения о настройке автономной панели мониторинга см. в конфигурации панели мониторинга.

Общая конфигурация

Выбор Значение по умолчанию Описание
ASPIRE_ALLOW_UNSECURED_TRANSPORT false Разрешает обмен данными с узлом приложения без https. ASPNETCORE_URLS (адрес панели мониторинга) и DOTNET_RESOURCE_SERVICE_ENDPOINT_URL (адрес службы ресурсов узла приложения) должны быть защищены с помощью HTTPS, если только значение true.
DOTNET_ASPIRE_CONTAINER_RUNTIME docker Позволяет пользователю альтернативных сред выполнения контейнеров для ресурсов, поддерживаемых контейнерами. Возможные значения: docker (по умолчанию) или podman. Дополнительные сведения осм. в этой статье.

Служба ресурсов

Служба ресурсов размещается узлом приложения. Служба ресурсов используется панелью мониторинга для получения сведений о ресурсах, управляемых .NET.NET Aspire.

Выбор Значение по умолчанию Описание
DOTNET_RESOURCE_SERVICE_ENDPOINT_URL null Настраивает адрес службы ресурсов, размещенной узлом приложения. Автоматически созданный с помощью launchSettings.json случайный порт на localhost. Например, https://localhost:17037.
DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY Автоматически создан 128-разрядный энтропийный токен. Ключ API, используемый для проверки подлинности запросов, сделанных в службе ресурсов узла приложения. Ключ API требуется, если узел приложения находится в режиме выполнения, панель мониторинга не отключена, а панель мониторинга не настроена для предоставления анонимного доступа с помощью DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.

Щиток

По умолчанию панель мониторинга автоматически запускается узлом приложения. Панель мониторинга поддерживает собственный набор конфигураций, а некоторые параметры можно настроить на узле приложения.

Выбор Значение по умолчанию Описание
ASPNETCORE_URLS null Адрес панели мониторинга. Должен быть https, если ASPIRE_ALLOW_UNSECURED_TRANSPORT или DistributedApplicationOptions.AllowUnsecuredTransport значение true. Автоматически созданный с помощью launchSettings.json случайный порт на localhost. Значение в параметрах запуска задано в свойстве applicationUrls.
ASPNETCORE_ENVIRONMENT Production Настраивает среду, в которой выполняется панель мониторинга. Дополнительные сведения см. в разделе Использование нескольких сред в ASP.NET Core.
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL http://localhost:18889, если конечная точка gRPC не настроена. Настраивает адрес OTLP gRPC панели мониторинга. Используется панелью мониторинга для получения данных телеметрии по OTLP. Задайте для ресурсов значение OTEL_EXPORTER_OTLP_ENDPOINT env var. OTEL_EXPORTER_OTLP_PROTOCOL env var grpc. Автоматически созданный с помощью launchSettings.json случайный порт на localhost.
DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL null Настраивает HTTP-адрес панели мониторинга OTLP. Используется панелью мониторинга для получения данных телеметрии по OTLP. Если настроено только DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL, он устанавливается в качестве OTEL_EXPORTER_OTLP_ENDPOINT env var. OTEL_EXPORTER_OTLP_PROTOCOL env var http/protobuf.
DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN Автоматически создан 128-разрядный энтропийный токен. Настраивает маркер внешнего браузера. Это значение, которое необходимо ввести для доступа к панели мониторинга, когда режим проверки подлинности — BrowserToken. Если маркер браузера не указан, при каждом запуске узла приложения создается новый маркер.

Внутренний

Внутренние параметры используются узлом приложения и интеграцией. Внутренние параметры не предназначены для настройки напрямую.

Выбор Значение по умолчанию Описание
AppHost:Directory Корневой каталог содержимого, если нет проекта. Каталог проекта, на котором расположен узел приложения. Доступен из IDistributedApplicationBuilder.AppHostDirectory.
AppHost:Path Каталог в сочетании с именем приложения. Путь к узлу приложения. Он объединяет каталог с именем приложения.
AppHost:Sha256 Он создается из имени узла приложения, когда узел приложения находится в режиме публикации. В противном случае он создается из пути узла приложения. Хэш в шестнадцатеричной кодировке для текущего приложения. Хэш основан на расположении приложения на текущем компьютере, поэтому оно стабильно между запусками узла приложения.
AppHost:OtlpApiKey Автоматически создан 128-разрядный энтропийный токен. Ключ API, используемый для проверки подлинности запросов, отправленных службе OTLP панели мониторинга. Значение присутствует при необходимости: узел приложения находится в режиме выполнения, панель мониторинга не отключена, а панель мониторинга не настроена, чтобы разрешить анонимный доступ с помощью DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:BrowserToken Автоматически создан 128-разрядный энтропийный токен. Маркер браузера, используемый для проверки подлинности просмотра на панели мониторинга при запуске узлом приложения. Маркер браузера можно задать DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN. Значение присутствует при необходимости: узел приложения находится в режиме выполнения, панель мониторинга не отключена, а панель мониторинга не настроена, чтобы разрешить анонимный доступ с помощью DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.
AppHost:ResourceService:AuthMode ApiKey. Если DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS имеет значение true, то значение Unsecured. Режим проверки подлинности, используемый для доступа к службе ресурсов. Значение присутствует при необходимости: узел приложения находится в режиме выполнения, и панель мониторинга не отключена.
AppHost:ResourceService:ApiKey Автоматически создан 128-разрядный энтропийный токен. Ключ API, используемый для проверки подлинности запросов, сделанных в службе ресурсов узла приложения. Ключ API можно задать DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY. Значение присутствует при необходимости: узел приложения находится в режиме выполнения, панель мониторинга не отключена, а панель мониторинга не настроена, чтобы разрешить анонимный доступ с помощью DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS.