Быстрый старт: Настройка приложения Durable Functions для использования планировщика задач в Azure (предварительная версия)

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

Устойчивые функции поддерживают несколько поставщиков хранилища, также известных как бэкенды, для хранения состояния оркестрации и выполнения сущностей.

В этом кратком руководстве вы настроите приложение устойчивых функций для использования устойчивого планировщика задач в качестве серверной части и развертывания приложения в Azure с помощью Visual Studio Code.

Предпосылки

В этом кратком руководстве предполагается, что у вас уже есть проект Azure Functions на локальном компьютере.

• Устойчивые функции, добавленные в проект, включая:
  • Функция оркестратора.
  • Клиентская функция, которая запускает приложение durable functions.
• Проект, настроенный для локальной отладки.

Если вы не соответствуете этим предварительным требованиям, мы рекомендуем начать с одного из следующих кратких руководств, чтобы настроить локальный проект Functions.

Кроме того, вам понадобится следующее:

• Docker установлен для запуска эмулятора планировщика устойчивых задач.
• Установлен Azurite.
• Средство тестирования HTTP, которое обеспечивает безопасность данных.

Добавьте пакет планировщика устойчивых задач

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged --prerelease

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

Обновите host.json

Обновите host.json следующим образом, чтобы использовать планировщик устойчивых задач в качестве серверной части.

{
  "extensions": {
    "durableTask": {
      "hubName": "%TASKHUB_NAME%",
      "storageProvider": {
        "type": "azureManaged",
        "connectionStringName": "DURABLE_TASK_SCHEDULER_CONNECTION_STRING"
      }
    }
  }
}

Настройте local.settings.json

Добавьте сведения о подключении для локальной разработки:

{
  "IsEncrypted": false,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "<DEPENDENT ON YOUR PROGRAMMING LANGUAGE>",
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "DURABLE_TASK_SCHEDULER_CONNECTION_STRING": "Endpoint=http://localhost:8080;Authentication=None",
    "TASKHUB_NAME": "default"
  }
}

Получите номер порта эмулятора устойчивого планировщика задач на следующем этапе.

Настройка эмулятора планировщика долговременных задач

1. Загрузите образ Docker, содержащий эмулятор.

   docker pull mcr.microsoft.com/dts/dts-emulator:v0.0.5
   

2. Запустите эмулятор.

   docker run -d -p 8080:8080 -p 8082:8082 mcr.microsoft.com/dts/dts-emulator:v0.0.5
   

   Следующие выходные данные указывают, что эмулятор успешно запущен.

   

3. Запишите порты, экспонированные в Docker Desktop. Планировщик предоставляет несколько портов для различных целей:

   • 8080: конечная точка gRPC, которая позволяет приложению подключаться к планировщику
   • 8082: конечная точка для панели управления планировщиком долговременных задач

   

Локальное тестирование.

1. Перейдите в корневой каталог приложения и запустите Azurite.

   azurite start
   

2. Запустите приложение.

   func start
   

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

   

3. Запустите экземпляр оркестрации, отправив HTTP-запрос POST на конечный URL-адрес с помощью выбранного вами инструмента тестирования HTTP.

4. Скопируйте значение statusQueryGetUri URL-адреса и вставьте его в адресную строку браузера. Вам должно быть видно состояние экземпляра оркестрации:

     {
       "name": "DurableFunctionsOrchestrationCSharp1",
       "instanceId": "b50f8b723f2f44149ab9fd2e3790a0e8",
       "runtimeStatus": "Completed",
       "input": null,
       "customStatus": null,
       "output": [
         "Hello Tokyo!",
         "Hello Seattle!",
         "Hello London!"
       ],
       "createdTime": "2025-02-21T21:09:59Z",
       "lastUpdatedTime": "2025-02-21T21:10:00Z"
     }
   

5. Чтобы просмотреть дополнительные сведения об экземпляре оркестрации, откройте панель управления планировщиком долговечных задач http://localhost:8082/.

6. Щелкните узел задач по умолчанию, чтобы просмотреть его панель мониторинга.

Запуск приложения в Azure

Создание необходимых ресурсов

Создайте экземпляр устойчивого планировщика задач и приложение Azure Functions в Azure в соответствии с интегрированным процессом создания приложения Functions. Этот процесс автоматически настраивает идентификационный доступ и конфигурирует необходимые переменные среды, чтобы приложение могло обращаться к планировщику.

1. Перейдите в поле создания приложения-функции и выберите «Функции Premium» или «Служба приложений» в качестве варианта размещения.

   

2. В панели "Создание приложения-функции (служба приложений) введите информацию во вкладке Основное.

   

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

3. Перейдите на вкладку "Устойчивые функции ".

4. Выберите Durable Task Scheduler в качестве поставщика серверной части для ваших устойчивых функций.

5. Создайте ресурс планировщика. Это действие автоматически создает концентратор задач.

   

   Поле	Описание
   Система хранения данных	Выберите планировщик устойчивых задач.
   Область	Рекомендуется, чтобы регионы планировщика и приложения-функции были одинаковыми.
   Планировщик устойчивых задач	Используйте предлагаемое имя планировщика или нажмите Создать новое, чтобы создать пользовательское имя.
   Планирование	На данный момент доступен только Выделенный.
   Единицы емкости	В настоящее время в качестве параметра можно выбрать только одну единицу емкости.

6. Нажмите кнопку "Рецензирование" и "Создать ", чтобы просмотреть создание ресурса.

   Управляемое удостоверение, назначаемое пользователем, с необходимыми разрешениями на управление доступом на основе ролей (RBAC) создается автоматически, чтобы функциональное приложение смогло получить доступ к планировщику долговременных задач. Вы можете найти в сводном обзоре информацию, связанную с ресурсом управляемого удостоверения, например:

   • RBAC, назначенный ему (Участник Данных Для Устойчивых Задач)

   • Область охвата задания (имя планировщика или узла задач)

     

7. Нажмите кнопку "Создать после прохождения проверки".

Развертывание ресурсов может занять около 15–20 минут. После этого вы можете развернуть приложение в Azure.

Разверните ваше приложение-функцию в Azure

1. В командной палитре введите и выберите Функции Azure: Развернуть в функциональном приложении.

2. Выберите только что созданное функциональное приложение. При появлении запроса на перезапись предыдущих развертываний выберите «Развернуть», чтобы развернуть функциональный код в новом ресурсе функционального приложения.

3. После завершения развертывания выберите "Просмотреть выходные данные ", чтобы просмотреть результаты создания и развертывания, включая созданные ресурсы Azure. Если вы пропустили уведомление, выберите значок колокольчика в правом нижнем углу, чтобы увидеть его снова.

   

Приложения в плане "Функции Премиум"

Если приложение работает в плане "Функции Премиум", включите параметр мониторинга масштабирования среды выполнения после развертывания, чтобы обеспечить автомасштабирование приложения на основе нагрузки:

az resource update -g <resource_group> -n <function_app_name>/config/web --set properties.functionsRuntimeScaleMonitoringEnabled=1 --resource-type Microsoft.Web/sites

Тестируйте функциональное приложение

Выполните следующую команду, чтобы получить URL-адрес функции:

az functionapp function list --resource-group <RESOURCE_GROUP_NAME> --name <FUNCTION_APP_NAME>  --query '[].{Function:name, URL:invokeUrlTemplate}' --output json

Проверка состояния оркестрации

Проверьте состояние экземпляра оркестрации и сведения о действиях на панели мониторинга планировщика устойчивых задач. Для доступа к панели мониторинга требуется войти в систему.

1. Перейдите к ресурсу планировщика устойчивых задач на портале.

2. Щелкните название узла задач.

3. В меню слева выберите Управление доступом (IAM).

4. Нажмите кнопку "Добавить ", чтобы добавить назначение роли.

   

5. Найдите и выберите вкладчика данных для устойчивых задач. Нажмите кнопку Далее.

   

6. На вкладке "Участники" для назначения доступа выберите "Пользователь", "Группа" или "Субъект-служба".

7. Для участников нажмите + Выбрать участников.

8. В области "Выбор членов" найдите имя или сообщение электронной почты:

   

9. Выберите сообщение электронной почты и нажмите кнопку "Выбрать ".

10. Нажмите "Рецензирование + назначение", чтобы завершить назначение роли.

11. После назначения роли щелкните "Обзор" в меню слева ресурса концентратора задач и перейдите по URL-адресу панели мониторинга, расположенному в верхней части раздела Essentials .

Очистка ресурсов

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

Дальнейшие действия

• Узнайте больше о панели мониторинга планировщика устойчивых задач.
• Устраните ошибки, которые могут возникнуть при использовании планировщика устойчивых задач.