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

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

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

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

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

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

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

Включение Dapr

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

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

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

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 считаются изменениями области приложения. При запуске приложения-контейнера в режиме нескольких редакций изменения этих параметров не будут создавать новую редакцию. Вместо этого все существующие редакции перезапускаются, чтобы убедиться, что они настроены с наибольшими значениями up-to-date.

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

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

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

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

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

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

Устранение неполадок

В этом разделе описывается устранение неполадок, которые могут возникнуть при использовании расширения Dapr для функций Azure.

Убедитесь, что Dapr включен в вашей среде

Если вы используете привязки и триггеры Dapr в Функциях Azure, а Dapr не включено в вашей среде, может появиться сообщение об ошибке: Чтобы включить Dapr в вашей среде: Dapr sidecar isn't present. Please see (https://aka.ms/azure-functions-dapr-sidecar-missing) for more information.

• Если функция Azure развернута в приложениях контейнеров Azure, ознакомьтесь с инструкциями по включению Dapr для расширения Dapr для Функций Azure.

• Если функция Azure развернута в Kubernetes, убедитесь, что конфигурация YAML развертывания содержит следующие заметки:

  annotations:
    ...
    dapr.io/enabled: "true"
    dapr.io/app-id: "functionapp"
    # You should only set app-port if you are using a Dapr trigger in your code.
    dapr.io/app-port: "<DAPR_APP_PORT>"
    ...
  

• Если вы используете функцию Azure локально, выполните следующую команду, чтобы убедиться, что вы запускаете приложение-функцию с dapr:

  dapr run --app-id functionapp --app-port <DAPR_APP_PORT>  --components-path <COMPONENTS_PATH> -- func host start 
  

Проверка значения порта приложения в конфигурации Dapr

Расширение Dapr для функций Azure запускает HTTP-сервер на порту 3001 по умолчанию. Этот порт можно настроить с помощью переменнойDAPR_APP_PORT среды.

Если при запуске приложения "Функции Azure" задано неправильное значение порта приложения, может появиться сообщение об ошибке: Чтобы устранить это сообщение об ошибке: The Dapr sidecar is configured to listen on port {portInt}, but the app server is running on port {appPort}. This may cause unexpected behavior. For more information, visit [this link](https://aka.ms/azfunc-dapr-app-config-error).

1. В параметрах Dapr приложения контейнера:

   • Если в коде используется триггер Dapr, убедитесь, что для порта приложения задано 3001 значение или значение переменной DAPR_APP_PORT среды.

   • Если в коде не используется триггер Dapr, убедитесь, что порт приложения не задан. Он должен быть пустым.

2. Убедитесь, что вы указали правильное значение порта приложения в конфигурации Dapr.

   • Если вы используете приложения контейнеров Azure, укажите порт приложения в Bicep:

     DaprConfig: {
        ...
        appPort: <DAPR_APP_PORT>
        ...
     }
     

   • Если вы используете среду Kubernetes, задайте заметку dapr.io/app-port :

     annotations:
        ...
        dapr.io/app-port: "<DAPR_APP_PORT>"
        ...
     

   • Если вы разрабатываете локально, убедитесь, что вы устанавливаете --app-port при запуске приложения-функции с помощью Dapr:

     dapr run --app-id functionapp --app-port <DAPR_APP_PORT> --components-path <COMPONENTS_PATH> -- func host start 
     

Дальнейшие шаги

Дополнительные сведения о Dapr.