Расширение Dapr для Функции Azure

Статья
02/06/2024

Важно!

Расширение Dapr для Функции Azure в настоящее время находится в предварительной версии и поддерживается только в средах приложений контейнеров Azure.

Расширение Dapr для Функции Azure — это набор средств и служб, которые позволяют разработчикам легко интегрировать Функции Azure с платформой распределенной среды выполнения приложений (Dapr).

Функции Azure — это служба вычислений на основе событий, которая предоставляет набор триггеров и привязок для легкого подключения к другим службам Azure. Dapr предоставляет набор стандартных блоков и рекомендаций по созданию распределенных приложений, включая микрослужбы, управление состоянием, паб/вложенный обмен сообщениями и многое другое.

Интеграция между Dapr и Functions позволяет создавать функции, реагирующие на события из Dapr или внешних систем.

Действие	Направление	Тип
Триггер входной привязки Dapr	Н/П	daprBindingTrigger
Триггер вызова службы Dapr	Н/П	daprServiceInvocationTrigger
Активация подписки на раздел Dapr	Н/П	daprTopicTrigger
Извлечение в состоянии Dapr для выполнения	In	daprState
Извлечение секретов Dapr для выполнения	In	daprSecret
Сохранение значения в состоянии Dapr	выход	daprState
Вызов другого приложения Dapr	выход	daprInvoke
Публикация сообщения в разделе Dapr	выход	daprPublish
Отправка значения в выходную привязку Dapr	выход	daprBinding

Установка расширения

Установленный пакет NuGet расширения зависит от режима C# в процессе или изолированном рабочем процессе, который вы используете в приложении-функции:

Внутрипроцессный процесс
Изолированный процесс

Это расширение доступно путем установки пакета NuGet версии 0.17.0-preview01.

С использованием .NET CLI:

dotnet add package Microsoft.Azure.WebJobs.Extensions.Dapr --prerelease

Добавьте расширение в проект, установив пакет NuGet версии 0.17.0-preview01.

С использованием .NET CLI:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Dapr --prerelease

Установка пакета

Предварительная версия пакета 4.x

Вы можете добавить расширение предварительного просмотра, добавив или заменив следующий код в host.json файле:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

Включение Dapr

Можно настроить Dapr с помощью различных [аргументов и заметок][dapr-args] на основе контекста среды выполнения. Dapr можно настроить для Функции Azure через два канала:

Шаблоны инфраструктуры как кода (IaC), как в шаблонах Bicep или Azure Resource Manager (ARM)
Портал Azure

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

Bicep
ARM

DaprConfig: {
  enabled: true
  appId: '${envResourceNamePrefix}-funcapp'
  appPort: 3001
  httpReadBufferSize: ''
  httpMaxRequestSize: ''
  logLevel: ''
  enableApiLogging: true
}

"DaprConfig": {
  "enabled": true,
  "appId": "${envResourceNamePrefix}-funcapp",
  "appPort": 3001,
  "httpReadBufferSize": "",
  "httpMaxRequestSize": "",
  "logLevel": "",
  "enableApiLogging": true
}

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

При настройке Dapr с помощью портал Azure перейдите к приложению-функции и выберите Dapr в меню слева:

Screenshot demonstrating where to find Dapr enablement for a Function App in the Azure portal.

Порты и прослушиватели Dapr

При активации функции из Dapr расширение автоматически предоставляет порт 3001 для прослушивания входящих запросов из бокового автомобиля Dapr.

Важно!

Порт 3001 предоставляется только и прослушивается, если триггер Dapr определен в приложении-функции. При использовании Dapr боковой кареты ожидает получения ответа от определенного порта перед завершением создания экземпляра. Не определяйте заметку dapr.io/port или --app-port если у вас нет триггера. Это может заблокировать приложение с бокового автомобиля Dapr.

Если вы используете только входные и выходные привязки, порт 3001 не должен быть предоставлен или определен.

По умолчанию, когда Функции Azure пытается взаимодействовать с Dapr, он вызывает Dapr через порт, разрешенный из переменной DAPR_HTTP_PORTсреды. Если эта переменная имеет значение NULL, по умолчанию используется порт 3500.

Можно переопределить адрес Dapr, используемый входными и выходными привязками, задав DaprAddress свойство в function.json привязке (или атрибут). По умолчанию используется http://localhost:{DAPR_HTTP_PORT}.

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

Типы привязки

Типы привязки, поддерживаемые для .NET, зависят от версии расширения и режима выполнения C#, что может быть одним из следующих типов:

Библиотека внутрипроцессных классов
Изолированный процесс

Библиотека внутрипроцессных классов — это скомпилированная функция C#, которая выполняется в том же процессе, что и среда выполнения Функций.

Расширение Dapr поддерживает типы параметров в соответствии с таблицей ниже.

Привязка	Типы параметров
Триггер Dapr	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Входные данные Dapr	daprState daprSecret
Выходные данные Dapr	daprState daprInvoke daprPublish daprBinding

Примеры использования этих типов см. в разделе репозитория GitHub для расширения.