Azure portal を使用して Durable Functions を作成する

[アーティクル]
03/29/2023

Azure Functions の Durable Functions 拡張機能は、NuGet パッケージ Microsoft.Azure.WebJobs.Extensions.DurableTask に提供されます。この拡張機能は、お使いの関数アプリにインストールする必要があります。この記事では、Azure portal で Durable Functions を開発できるように、このパッケージをインストールする方法を示します。

Note

C# で Durable Functions を開発している場合は、代わりに Visual Studio 2019 開発を検討します。
JavaScript で Durable Functions を開発している場合は、代わりに Visual Studio Code での開発を検討してください。

Function App を作成する

すべての関数の実行をホストするには関数アプリが必要です。関数アプリを使用すると、リソースの管理、デプロイ、スケーリング、および共有を容易にするための論理ユニットとして関数をグループ化できます。 .NET アプリまたは JavaScript アプリを作成することができます。

Azure portal のメニューまたは [ホーム] ページから [リソースの作成] を選択します。
[新規] ページで、 [計算]>、 [関数アプリ] の順に選択します。

[基本] ページで、下の表に指定されている関数アプリの設定を使用します。

設定	推奨値	説明
サブスクリプション	該当するサブスクリプション	新しい関数アプリを作成するサブスクリプション。
リソースグループ	myResourceGroup	関数アプリを作成する新しいリソースグループの名前。既存のリソースグループに新しい関数アプリを作成するときの既知の制限があるため、新しいリソースグループを作成する必要があります。
関数アプリ名	グローバルに一意の名前	新しい Function App を識別する名前。有効な文字は、`a-z` (大文字と小文字の区別をしない)、`0-9`、および `-`です。
発行	コード	コードファイルまたは Docker コンテナーの発行オプション。
ランタイムスタック	優先言語	お気に入りの関数プログラミング言語をサポートするランタイムを選択します。ポータル内編集は、JavaScript、PowerShell、TypeScript、および C# スクリプトでのみ利用できます。 C# クラスライブラリ、Java、Python の関数はローカルで開発する必要があります。
Version	バージョン番号	インストールされているランタイムのバージョンを選択します。
リージョン	優先リージョン	自分の近く、または関数がアクセスできる他のサービスの近くのリージョンを選択します。

[次へ :ホスティング] を選択します。 [ホスティング] ページで、次の設定を入力します。

設定	推奨値	説明
ストレージアカウント	グローバルに一意の名前	Function App で使用されるストレージアカウントを作成します。ストレージアカウント名は、3 文字から 24 文字までの長さにし、数字と小文字のみを使用する必要があります。既存のアカウントを使用することもできますが、ストレージアカウントの要件を満たしている必要があります。
オペレーティングシステム	Windows	オペレーティングシステムは、ランタイムスタックの選択に基づいてあらかじめ選択されますが、必要に応じて設定を変更できます。ポータルでの編集は Windows でのみサポートされます。
プラン	従量課金プラン (サーバーレス)	Function App にどのようにリソースが割り当てられるかを定義するホスティングプラン。既定の [従量課金プラン] では、リソースは関数の必要に応じて動的に追加されます。このサーバーレスのホスティングでは、関数が実行された時間にのみ課金されます。 App Service プランで実行する場合は、関数アプリのスケーリングを管理する必要があります。

[次へ :監視] を選択します。 [監視] ページで、次の設定を入力します。

設定	推奨値	説明
Application Insights	Default	最も近いサポートされているリージョン内に同じアプリ名の Application Insights リソースを作成します。この設定を展開するか、[新規作成] を選択して、Application Insights 名を変更したり、データを保存する Azure 地域内の別のリージョンを選択したりできます。

[確認および作成] を選択して、アプリ構成の選択内容を確認します。
[確認および作成] ページで設定を確認して、 [作成] を選択し、関数アプリをプロビジョニングしてデプロイします。
ポータルの右上隅の [通知] アイコンを選択し、"デプロイメントに成功しました" というメッセージが表示されるまで待ちます。
[リソースに移動] を選択して、新しい Function App を確認します。また、 [ダッシュボードにピン留めする] を選択することもできます。ピン留めすると、ダッシュボードからこの関数アプリリソースに戻るのが容易になります。

既定では、作成される関数アプリは、Azure Functions ランタイムのバージョン 2.x を使用します。 Durable Functions 拡張機能は、Azure Functions ランタイムのバージョン 1.x と 2.x の両方 (C# の場合) およびバージョン 2.x (JavaScript の場合) で機能します。ただし、選択した言語に関係なく、テンプレートはランタイムのバージョン 2.x をターゲットとしている場合にのみ使用できます。

durable-functions npm パッケージをインストールする (JavaScript のみ)

JavaScript Durable Functions を作成する場合、durable-functions npm パッケージをインストールする必要があります。

関数アプリのページで、左側のウィンドウの [開発ツール] の下の [高度なツール] を選択します。
[高度なツール] ページで、 [移動] を選択します。
Kudu コンソール内で、 [デバッグコンソール] 、 [CMD] を選択します。
関数アプリのファイルのディレクトリ構造が表示されます。 site/wwwroot フォルダーに移動します。そこから、package.json ファイルをファイルディレクトリウィンドウにドラッグアンドドロップしてアップロードすることができます。 package.json のサンプルを次に示します。
```
{
  "dependencies": {
    "durable-functions": "^1.3.1"
  }
}
```
package.json がアップロードされたら、Kudu リモート実行コンソールから npm install コマンドを実行します。

オーケストレーター関数を作成する

関数アプリで、左側のウィンドウから [関数] を選択し、上部のメニューから [追加] を選択します。
[新規関数] ページの検索フィールドに「durable」と入力し、 [Durable Functions HTTP スターター] テンプレートを選択します。
[新規関数] の名前を「HttpStart」と入力し、 [関数の作成] をクリックします。

作成された関数はオーケストレーションの開始に使用されます。
関数アプリで別の関数を作成します。今回は、 [Durable Functions オーケストレーター] テンプレートを使用します。新しいオーケストレーション関数の名前を「HelloSequence」にします。
[Durable Functions のアクティビティ] テンプレートを使用して、「Hello」という名前の 3 つ目の関数を作成します。

Durable Functions のオーケストレーションをテストする

HttpStart 関数に戻り、 [関数の URL の取得] を選択し、 [クリップボードにコピー] アイコンを選択して URL をコピーします。この URL を使用して HelloSequence 関数を開始します。
Postman や cURL などの HTTP ツールを使用して、コピーした URL に POST 要求を送信します。次の例は、Durable Functions に POST 要求を送信する cURL コマンドです。
```
curl -X POST https://{your-function-app-name}.azurewebsites.net/api/orchestrators/{functionName} --header "Content-Length: 0"
```
この例では、{your-function-app-name} は対象の関数アプリの名前であるドメインで、{functionName} は HelloSequence オーケストレーター関数です。応答メッセージには、実行を監視および管理するために使用できる、一連の URI エンドポイントが含まれます。次の例のようになります。
```
{  
   "id":"10585834a930427195479de25e0b952d",
   "statusQueryGetUri":"https://...",
   "sendEventPostUri":"https://...",
   "terminatePostUri":"https://...",
   "rewindPostUri":"https://..."
}
```

statusQueryGetUri エンドポイント URI を呼び出すと、その Durable Functions の現在の状態が表示されます。次の例のようになります。

    {
        "runtimeStatus": "Running",
        "input": null,
        "output": null,
        "createdTime": "2017-12-01T05:37:33Z",
        "lastUpdatedTime": "2017-12-01T05:37:36Z"
    }

状態が [完了] に変わるまで statusQueryGetUri の呼び出しを続けます。次の例のような応答が表示されます。

{
        "runtimeStatus": "Completed",
        "input": null,
        "output": [
            "Hello Tokyo!",
            "Hello Seattle!",
            "Hello London!"
        ],
        "createdTime": "2017-12-01T05:38:22Z",
        "lastUpdatedTime": "2017-12-01T05:38:28Z"
    }

これで最初の Durable Functions が稼働し、Azure で実行されるようになります。

次のステップ

Durable Functions の一般的なパターンについて学習する