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


Настройка Dapr в существующем приложении-контейнере

Dapr можно настроить с помощью различных аргументов и заметок на основе контекста среды выполнения. Конфигурации Dapr, доступные в приложениях контейнеров Azure, считаются изменениями области приложений . При запуске приложения-контейнера в режиме нескольких редакций изменения этих параметров не создают новую редакцию. Вместо этого все существующие редакции перезапускаются, чтобы убедиться, что они настроены с самыми актуальными значениями.

Приложения контейнеров Azure предоставляют три канала, с помощью которых можно включить и настроить Dapr:

В следующей таблице приведен список поддерживаемых в настоящее время конфигураций бокового автомобиля Dapr для включения Dapr в приложениях контейнеров Azure:

Интерфейс командной строки для приложений контейнеров Поле шаблона Описание
--enable-dapr dapr.enabled Включает Dapr в контейнере приложения.
--dapr-app-port dapr.appPort Порт приложения прослушивает, который используется Dapr для взаимодействия с приложением.
--dapr-app-protocol dapr.appProtocol Передает в Dapr информацию о протоколе, используемом в приложении. Поддерживаются варианты http и grpc. Параметр по умолчанию — http.
--dapr-app-id dapr.appId Уникальный идентификатор Dapr для приложения контейнера, используемого для обнаружения служб, инкапсуляции состояния и идентификатора издателя или дочернего потребителя.
--dapr-max-request-size dapr.httpMaxRequestSize Задайте максимальный размер http-сервера текста запроса и сервера grpc для обработки отправки больших файлов. Параметр по умолчанию — 4 MB.
--dapr-read-buffer-size dapr.httpReadBufferSize Задайте максимальный размер буфера чтения заголовка HTTP для обработки при отправке заголовков с несколькими КБ. Параметр по умолчанию — 4 KB.
--dapr-api-logging dapr.enableApiLogging Позволяет просматривать вызовы API из приложения на боковую панель Dapr.
--dapr-log-level dapr.logLevel Задайте уровень журнала для бокового автомобиля Dapr. Допустимые значения: отладка, ошибка, информация, предупреждение. Параметр по умолчанию — info.
--dapr-app-health-enabled dapr.appHealth.enabled Необязательная конфигурация для включения проверок работоспособности контейнерного приложения в формате Boolean. Параметр по умолчанию — false.
--dapr-app-health-path dapr.appHealth.path Задайте путь, который Dapr вызывает для проб работоспособности, если канал приложения — HTTP. Это значение игнорируется, если канал приложений использует gRPC. Параметр по умолчанию — /healthz.
--dapr-app-health-probe-interval dapr.appHealth.probeIntervalSeconds Количество секунд между каждой пробой работоспособности. Параметр по умолчанию — 3.
--dapr-app-health-probe-timeout dapr.appHealth.probeTimeoutMilliseconds Время ожидания в миллисекундах для запросов проверки работоспособности. Это значение должно быть меньше probeIntervalSeconds значения. Параметр по умолчанию — 500.
--dapr-app-health-threshold dapr.appHealth.threshold Максимальное число последовательных сбоев до того, как приложение считается неработоспособным. Параметр по умолчанию — 3.
--dapr-max-concurrency dapr.maxConcurrency Ограничьте конкурентность вашего приложения. Допустимое значение — любое число больше 0. -1 означает, что нет ограничения на параллелизм.

Использование интерфейса командной строки

Вы можете включить Dapr в приложении контейнера с помощью Azure CLI.

az containerapp dapr enable

Дополнительные сведения и примеры см. в справочной документации.

Использование Bicep или ARM

При использовании шаблона IaC укажите следующие аргументы в properties.configuration разделе определения ресурса приложения контейнера.

 dapr: {
   enabled: true
   appId: 'nodeapp'
   appProtocol: 'http'
   appPort: 3000
   httpReadBufferSize: 30
   httpMaxRequestSize: 10
   logLevel: 'debug'
   enableApiLogging: true
   appHealth: {
     enabled: true
     path: '/health'
     probeIntervalSeconds: 3
     probeTimeoutMilliseconds: 1000
     threshold: 3
   },
   maxConcurrency: 10
  }

Использование портала Azure

Вы также можете включить Dapr с помощью представления портала приложений контейнеров.

Примечание.

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

Перейдите к приложению-контейнеру в портал Azure и выберите Dapr в разделе "Параметры" в меню слева.

Снимок экрана: где включить Dapr в приложении контейнера с помощью представления портал Azure.

По умолчанию Dapr отключен. Выберите "Включено" , чтобы развернуть параметры Dapr.

Снимок экрана: отключение Dapr по умолчанию и расположение, чтобы включить его.

Введите идентификатор приложения компонента и выберите соответствующие заголовки. Если применимо, в заголовке "Компоненты" выберите ссылку, чтобы добавить компоненты Dapr и управлять ими в среду приложения контейнера.

Снимок экрана: некоторые основные параметры включения Dapr в приложении контейнера.

Следующие шаги

Дополнительные сведения о компонентах Dapr в приложениях контейнеров Azure.