Краткое руководство: Создание приложения на JavaScript с использованием Durable Functions

• Расширение Visual Studio Code Azure Functions установлено.

• Для Visual Studio Code установлено расширение Azure Functions версии 1.10.4 или более поздней.

• Последняя версия Azure Functions Core Tools установлена.

• Azure Functions Core Tools версии 4.0.5382 или более поздней.

• установлен Node.js версии 16.x+ .

• установлен Node.js версии 18.x+ .

3. В подсказках укажите следующие сведения:

   Подсказка	Действие	Описание
   Выбор языка для проекта приложения-функции	Выберите JavaScript.	Создает локальный проект функций Node.js.
   Выбор модели программирования JavaScript	Выберите модель версии 3.	Задает модель программирования версии 3.
   Выбор версии	Выберите Azure Functions версии 4.	Этот параметр отображается только в том случае, если основные инструменты еще не установлены. В этом случае Core Tools устанавливается при первом запуске приложения.
   Выбор шаблона для первой функции проекта	выберите Пока пропустить.
   Выбор способа открытия проекта	Выберите "Открыть" в текущем окне.	Открывает Visual Studio Code в выбранной папке.

3. В подсказках укажите следующие сведения:

   Подсказка	Действие	Описание
   Выбор языка для проекта приложения-функции	Выберите JavaScript.	Создает локальный проект функций Node.js.
   Выбор модели программирования JavaScript	Выберите модель версии 4.	Выберите модель программирования версии 4.
   Выбор версии	Выберите Azure Functions версии 4.	Этот параметр отображается только в том случае, если основные инструменты еще не установлены. В этом случае Core Tools устанавливается при первом запуске приложения.
   Выбор шаблона для первой функции проекта	выберите Пока пропустить.
   Выбор способа открытия проекта	Выберите "Открыть" в текущем окне.	Открывает Visual Studio Code в выбранной папке.

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

Чтобы использовать модель программирования версии 3, установите библиотеку устойчивых функций версии 2.x.

2. Установите npm-пакет durable-functions, выполнив npm install durable-functions@2.1.4 в корневом каталоге функционального приложения.

2. Установите npm-пакет durable-functions, выполнив npm install durable-functions в корневом каталоге функционального приложения.

Функция оркестратора

Шаблон используется для создания кода приложения Durable Functions в проекте.

1. В палитре команд введите и выберите Azure Functions: Create Function.

2. В подсказках укажите следующие сведения:

   Подсказка	Действие	Описание
   Выбор шаблона для функции	Выберите Durable Functions orchestrator.	Создает оркестрацию приложения Durable Functions.
   Выбор типа устойчивого хранилища	Выберите Azure Storage (по умолчанию).	Выбирает подсистему хранилища, используемую для приложения Durable Functions.
   Укажите имя функции	Введите HelloOrchestrator.	Имя для вашей надежной функции.

Вы добавили оркестратор для координации функций действий. Откройте файл HelloOrchestrator/index.js и изучите функцию оркестратора. Каждый вызов context.df.callActivity приводит к вызову функции действия с именем Hello.

Затем добавьте указанную Hello функцию действия.

Функция активности

1. В палитре команд введите и выберите Azure Functions: Create Function.

2. В подсказках укажите следующие сведения:

   Подсказка	Действие	Описание
   Выбор шаблона для функции	Выберите действие Durable Functions.	Создает функцию активности.
   Укажите имя функции	Введите Hello.	Имя для вашей надежной функции.

Вы добавили Hello функцию активности, вызываемую оркестратором. Откройте hello/index.js , чтобы увидеть, что он принимает имя в качестве входных данных и возвращает приветствие. Функция действия — это выполнение "реальной работы" в рабочем процессе, например вызов базы данных или выполнение некоторых недетерминированных вычислений.

Наконец, добавьте функцию с HTTP-триггером, которая запускает оркестрацию.

Клиентская функция (инициатор HTTP)

1. В палитре команд введите и выберите Azure Functions: Create Function.

2. В подсказках укажите следующие сведения:

   Подсказка	Действие	Описание
   Выбор шаблона для функции	Выберите Durable Functions HTTP стартер.	Создает начальную функцию HTTP.
   Укажите имя функции	Введите DurableFunctionsHttpStart.	Название функции активности.
   Уровень авторизации	Выберите "Анонимный".	Для демонстрационных целей это значение позволяет вызывать функцию без использования проверки подлинности.

Вы добавили функцию, вызываемую HTTP-запросом, которая запускает оркестрацию. Откройте DurableFunctionsHttpStart/index.js, чтобы увидеть, что используется client.startNew для запуска новой оркестрации. Затем client.createCheckStatusResponse используется для возврата HTTP-ответа, содержащего URL-адреса, которые можно использовать для мониторинга и управления новой оркестрацией.

Теперь у вас есть приложение Durable Functions, которое можно запустить локально и развернуть в Azure.

Одним из преимуществ модели программирования версии 4 является гибкость при написании функций. В модели версии 4 можно использовать один шаблон для создания всех трех функций в одном файле проекта.

1. В палитре команд введите и выберите Azure Functions: Create Function.

2. В подсказках укажите следующие сведения:

   Подсказка	Действие	Описание
   Выбор шаблона для функции	Выберите Durable Functions orchestrator.	Создает файл с оркестрацией приложения Durable Functions, функцией активности и функцией запуска клиента Durable.
   Выбор типа устойчивого хранилища	Выберите Azure Storage (по умолчанию).	Задает подсистему хранения, используемую для приложения Durable Functions.
   Укажите имя функции	Введите привет.	Имя устойчивой функции.

Откройте src/functions/hello.js , чтобы просмотреть созданные вами функции.

Вы создали оркестратор под названием helloOrchestrator для координации функций действий. Каждый вызов context.df.callActivity инициирует функцию действия hello.

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

Наконец, вы также добавили HTTP-триггерную функцию, которая запускает оркестрацию. В том же файле видно, что используется client.startNew, чтобы запустить новую оркестрацию. Затем client.createCheckStatusResponse используется для возврата HTTP-ответа, содержащего URL-адреса, которые можно использовать для мониторинга и управления новой оркестрацией.

Теперь у вас есть приложение Durable Functions, которое можно запустить локально и развернуть в Azure.

1. Чтобы проверить функцию, установите точку останова Hello в коде функции действия (в Hello/index.js). Выберите F5 или выберите "Отладка " в палитре команд, чтобы запустить проект приложения-функции. Выходные данные основных инструментов отображаются на панели терминала.

   Замечание

   Дополнительные сведения об отладке см. в разделе диагностика Durable Functions.

1. Чтобы проверить функцию, установите точку останова hello в коде функции действия (в src/functions/hello.js). Выберите F5 или выберите "Отладка " в палитре команд, чтобы запустить проект приложения-функции. Выходные данные основных инструментов отображаются на панели терминала.

   Замечание

   Дополнительные сведения об отладке см. в разделе диагностика Durable Functions.

5. Используйте браузер или средство тестирования HTTP для отправки HTTP-запроса POST в конечную точку URL-адреса.

   Последний сегмент замените именем функции оркестратора (HelloOrchestrator в нашем примере). URL-адрес должен выглядеть приблизительно так: http://localhost:7071/api/orchestrators/HelloOrchestrator.

   Ответ — это начальный результат функции HTTP. Это позволяет узнать, что устойчивая оркестрация успешно запущена. Он еще не отображает конечный результат оркестрации. Ответ включает несколько полезных URL-адреса. Теперь запросите состояние оркестрации.

5. Используйте браузер или средство тестирования HTTP для отправки HTTP-запроса POST в конечную точку URL-адреса.

   Последний сегмент замените именем функции оркестратора (helloOrchestrator в нашем примере). URL-адрес должен выглядеть приблизительно так: http://localhost:7071/api/orchestrators/helloOrchestrator.

   Ответ — это начальный результат функции HTTP. Это позволяет узнать, что устойчивая оркестрация успешно запущена. Он еще не отображает конечный результат оркестрации. Ответ включает несколько полезных URL-адреса. Теперь запросите состояние оркестрации.

6. Скопируйте значение statusQueryGetUriURL-адреса, вставьте его в адресную строку браузера и выполните запрос. Кроме того, вы также можете продолжать использовать средство тестирования HTTP для выдачи запроса GET.

   Запрос к экземпляру оркестрации для проверки статуса. Вы увидите, что экземпляр завершен и содержит выходные данные или результаты приложения Durable Functions, как показано в следующем примере:

   {
       "name": "HelloOrchestrator",
       "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a",
       "runtimeStatus": "Completed",
       "input": null,
       "customStatus": null,
       "output": [
           "Hello Tokyo!",
           "Hello Seattle!",
           "Hello London!"
       ],
       "createdTime": "2020-03-18T21:54:49Z",
       "lastUpdatedTime": "2020-03-18T21:54:54Z"
   }
   

6. Скопируйте значение statusQueryGetUriURL-адреса, вставьте его в адресную строку браузера и выполните запрос. Вы также можете продолжать использовать средство тестирования HTTP для выдачи запроса GET.

   Запрос к экземпляру оркестрации для проверки статуса. Вы увидите, что экземпляр завершен и содержит выходные данные или результаты приложения Durable Functions, как показано в следующем примере:

   {
       "name": "helloOrchestrator",
       "instanceId": "6ba3f77933b1461ea1a3828c013c9d56",
       "runtimeStatus": "Completed",
       "input": "",
       "customStatus": null,
       "output": [
           "Hello, Tokyo",
           "Hello, Seattle",
           "Hello, Cairo"
       ],
       "createdTime": "2023-02-13T23:02:21Z",
       "lastUpdatedTime": "2023-02-13T23:02:25Z"
   }
   

1. На панели вывода скопируйте URL-адрес триггера HTTP. URL-адрес, вызывающий функцию, активируемую HTTP, должен иметь следующий формат:

   https://<functionappname>.azurewebsites.net/api/orchestrators/HelloOrchestrator

1. На панели вывода скопируйте URL-адрес триггера HTTP. URL-адрес, вызывающий функцию, активируемую HTTP, должен иметь следующий формат:

   https://<functionappname>.azurewebsites.net/api/orchestrators/helloOrchestrator