az-func-learn (durable functions)

※2022/06にNodeJS向けにDurable Functionsの新しいバージョン(durable-functions v2.x)がリリースされています。

概要

サーバレス環境でステートフル関数を記述できる拡張機能
スケーラビリティやエラーハンドリングなどを考慮すると複雑になりがちなワークフローの実装をサポートする拡張機能

https://docs.microsoft.com/ja-jp/azure/azure-functions/durable/quickstart-js-vscode

durable functions の機能・特徴

機能的には orchestrator関数 と entity関数 の2種類

関数	機能
orchestrator関数	ステートフルなワークフローの定義が簡単に行える ※コードは決定論的でなければいけない
entity関数	ステートフルなエンティティの定義が簡単に行える ※状態・情報の保存先として利用できる

関数の種類

Durable Functions activity
Durable Functions HTTP starter
Durable Functions orchestrator

Durable Functions entity
Durable Functions Entity HTTP starter

アプリケーション パターン

#	パターン名	簡単な説明
#1	関数チェーン	ワークフローの実現
#2	ファンアウト/ファンイン	並列処理の実現
#3	非同期 HTTP API	実行時間の長い処理の調整 ※オーケストレーター関数の状態をクエリするWebhook HTTP APIが組み込みサポートされている
#4	モニター	柔軟な監視処理
#5	人による操作	タイマーを利用したワークフロー
#6	アグリゲーター	データの集計 (※entityの利用)

詳細な説明はこちらを参照

開発に必要なもの

Azure Account
Visual Studio Code
Azure Functions VS Code 拡張
Azure ストレージアカウント (Azure サブスクリプション)
Node.js 10.x または 12.x ※v14で試しています。
Azure Functions Core Tools (funcコマンド)

Azureリソースの準備

リソースグループとストレージアカウント、Functionsを作成

az login
az account show

az group create --name az-func-example-rg --location japaneast

# Azure Functions用のstorage account
az storage account create --name durablefunc0001 --resource-group az-func-example-rg --location japaneast --sku Standard_LRS --kind StorageV2
az storage account show-connection-string -g az-func-example-rg -n durablefunc0001

# durable functions taskhub用のstorage account (汎用v1[--kind Storage]で作成)
az storage account create --name durablefunc0001taskhub --resource-group az-func-example-rg --location japaneast --sku Standard_LRS --kind Storage
az storage account show-connection-string -g az-func-example-rg -n durablefunc0001taskhub

# functions (--functions-version 4 ランタイムバージョン)
az functionapp create --resource-group az-func-example-rg --consumption-plan-location japaneast --runtime node --runtime-version 14 --functions-version 4 --name durable-sample-func --storage-account durablefunc0001

※従量課金プランで作成しているので開発中は不用意にスケーリングされないようにScaleLimitを設定しておきます。

az resource update --resource-type Microsoft.Web/sites -g az-func-example-rg -n durable-sample-func/config/web --set properties.functionAppScaleLimit=1

Durable Functions 作成時にストレージアカウントに自動的にdurabel functions 管理用のキュー、テーブルが作成されます。

(注意) 不要になったら削除する

az group delete --name az-func-example-rg -y

サンプルと解説

フォルダ名	内容
1st-df-project	vs codeを使って初めの関数を作成
2nd-df-project	Core Tools(funcコマンド)を使って作成
3rd-df-project	Entityのサンプル (単純なcounter)
E2_sample	ファインイン・ファンアウトのサンプル
E3_sample_Monitor	監視のサンプル twilio を利用 OpenWeather API を利用
E4_sample_sms_verification	人による操作のサンプル Twilio を利用したSMSでの本人確認
Training1_Sample_App	実践的なサンプルとして ワークフローでエラーが発生した場合のサンプル 簡単な補正トランザクションの例
Training2_TaskHub	TaskHub(タスク管理)について durable functionsの操作・管理
Training3_version	バージョン管理について
Training4_performance	パフォーマンスとスケーリングについて
Training5_ErrorHandling	オーケストレーターでのエラーの取り扱い
Training6_EventGrid	EventGridを利用してTaskの状態を管理する
Training7_Typescript	TypescriptでDurable Functionsの動作確認
Training8_custom_container	Dockerコンテナーとしてデプロイする
Training9_keda_k8s	KEDAを使用したAzure Functions

New major release of Durable Functions for NodeJS

https://techcommunity.microsoft.com/t5/apps-on-azure-blog/new-major-release-of-durable-functions-for-nodejs/ba-p/3451227

package.json

{
  "name": "",
  "version": "",
  "description": "",
  "scripts": {
    "test": "echo \"No tests yet...\""
  },
  "author": "",
  "dependencies": {
    "@azure/cosmos": "^3.15.1",
    "applicationinsights": "^2.3.2",
    "durable-functions": "^2.0.2", ★2022/06/06 時点
    "uuid": "^8.3.2"
  }
}