クイック スタート: Durable Task Scheduler を使用するようにDurable Functions アプリを構成する

Durable Task Scheduler をDurable Functions アプリのバックエンドとして使用して、オーケストレーションとエンティティのランタイム状態を格納します。 このクイック スタートでは、Durable Task Scheduler を使用するように既に構成されている Hello Cities サンプルを複製し、エミュレーターでローカルに実行してから、Azureにデプロイします。

前提条件

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

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

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

{
  "Values": {
    "DURABLE_TASK_SCHEDULER_CONNECTION_STRING": "Endpoint=http://localhost:8080;TaskHub=default;Authentication=None"
  }
}

Azureでアプリを実行する

必要なリソースを作成する

関数アプリ統合作成フローに従って、Durable Task Scheduler インスタンスと Azure Functions アプリを Azure 上に作成します。 このエクスペリエンスでは、ID ベースのアクセスが自動的に設定され、スケジューラにアクセスするためにアプリに必要な環境変数が構成されます。

1. [関数アプリの作成] ブレードに移動します。

   

2. [ 関数アプリの作成 (Flex Consumption)] ブレードで、[ 基本 ] タブの情報を入力します。

   

   フィールド	説明
   Subscription	Azure のサブスクリプションを選択します。
   リソース グループ	既存のリソース グループを選択するか、[ 新規作成 ] をクリックして新しいリソース グループを作成します。
   関数アプリ名	関数アプリの一意の名前を作成します。
   コードまたはコンテナー イメージをデプロイしますか?	[コード] オプションをオンのままにします。
   リージョン	サポートされているリージョンのいずれかを選択します。
   ランタイム スタック	このクイック スタートで使用しているランタイムを選択します。
   バージョン	ランタイム スタックのバージョンを選択します。
   インスタンスのサイズ	インスタンス サイズを選択するか、既定の選択を使用します。 インスタンス サイズの詳細を確認します。
   ゾーン冗長	既定の [無効] 設定のままにします。

3. Durable Functions タブを選択します。

4. Durable Functionsのバックエンド プロバイダーとしてAzureマネージド: Durable Task Scheduler を選択します。

5. スケジューラ リソースを作成します。 このアクションにより、タスク ハブが自動的に作成されます。

   

   フィールド	説明
   ストレージ バックエンド	Azure managed: Durable Task Scheduler を選択します。
   リージョン	スケジューラと関数アプリのリージョンが同じであることを確認します。
   耐久性のあるタスクスケジューラ	提供されているスケジューラ名を使用するか、[ 新規作成 ] をクリックしてカスタム名を作成します。
   Plan	プロジェクトに最適な 価格プラン を選択します。 運用環境で使用するのに最適なプランを決定するには、「 オーケストレーション フレームワークの選択 」ガイドを確認してください。
   容量ユニット	"専用" 価格プランが選択されている場合にのみ適用されます。 最大 3 つの容量ユニットを選択できます。

6. [ 確認と作成 ] をクリックして、リソースの作成を確認します。

   必要なロールベースのアクセス制御 (RBAC) アクセス許可を持つユーザー割り当てマネージド ID が自動的に作成され、関数アプリに追加されます。 次のようなマネージド ID リソースに関連する概要ビュー情報を確認できます。

   • 割り当てられたロール (永続タスク データ共同作成者)

   • タスク ハブ レベルにスコープが設定された割り当て

     

7. 検証に合格したら、[ 作成 ] をクリックします。

リソースのデプロイには約 15 ~ 20 分かかる場合があります。 完了したら、アプリをAzureにデプロイできます。

関数アプリを Azure にデプロイする

1. コマンド パレットで、入力して [Azure Functions: 関数アプリにデプロイする] を選択します。

2. 作成したばかりの関数アプリを選びます。 前のデプロイの上書きを求められたら、[デプロイ] を選択して、関数コードを新しい関数アプリ リソースにデプロイします。

3. デプロイの完了後、[出力の表示] を選択すると、作成済みの Azure リソースなど、作成とデプロイの結果が表示されます。 通知を見逃した場合は、右下隅にあるベル アイコンを選択して、再度確認します。

   

Functions Premium プラン上のアプリ

アプリが Functions Premium プランで実行されている場合は、デプロイ後に ランタイム スケール監視 設定をオンにして、読み込みに基づいてアプリが自動スケーリングされるようにします。

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

オーケストレーションの状態を確認する

Durable Task Scheduler ダッシュボードで、オーケストレーション インスタンスの状態とアクティビティの詳細を確認します。 ダッシュボードにアクセスするには、ログインする必要があります。

1. ポータルで Durable Task Scheduler リソースに移動します。

2. タスク ハブ名をクリックします。

3. 左側のメニューで [アクセス制御 (IAM)] を選択します。

4. [ 追加] をクリックしてロールの割り当てを追加します。

   

5. [永続タスク データ共同作成者] を検索して選択します。 [次へ] をクリックします。

   

6. [ メンバー ] タブの [ アクセスの割り当て] で、[ ユーザー、グループ、またはサービス プリンシパル] を選択します。

7. [メンバー] の場合は、[+ メンバーの選択] をクリックします。

8. [ メンバーの選択 ] ウィンドウで、自分の名前または電子メールを検索します。

   

9. メールを選び、[ 選択 ] ボタンをクリックします。

10. [ 確認と割り当て ] をクリックしてロールの割り当てを完了します。

11. ロールが割り当てられたら、タスク ハブ リソースの左側のメニューで [ 概要 ] をクリックし、上部の [要点 ] セクションにあるダッシュボードの URL に移動します。

リソースをクリーンアップする

クイック スタートを完了するために作成したリソースが不要になった場合は、Azure サブスクリプションの関連コストを回避するために、リソース グループおよびすべての関連リソースを削除します。

次のステップ

• Durable Task Scheduler ダッシュボードの詳細を確認します。
• Durable Task Scheduler の使用中に発生する可能性があるエラーのトラブルシューティングを行います。