Durable Functions拡張機能のバージョンをアップグレードする

オーケストレーションの失敗、再生速度の低下、または予期しない動作が発生している場合は、Durable Functions拡張機能をアップグレードすることをお勧めします。 新しいリリースには、多くの場合、重要なバグ修正とパフォーマンスの向上が含まれています。 新しいリリースの通知を受け取るには、GitHubでリリースをウォッチします。

アプリの種類に一致するアップグレード方法を選択します。

アプリの種類 アップグレード方法
.NET (インプロセス型または分離型) 最新の NuGet パッケージを参照する
非.NET (JavaScript、Python、Java、PowerShell) 拡張機能バンドルをアップグレードする
高度な/時間的に敏感な修正が必要 拡張機能を手動でアップグレードする

.NET アプリの最新の NuGet パッケージを参照する

プロジェクトのDurable Functions NuGet パッケージ参照を更新します。 正しいパッケージは、ホスティング モデルと ストレージ プロバイダーによって異なります。

ストレージ プロバイダー プロセス内作業者 アイソレートワーカー
Azure Storage (既定) Microsoft.Azure.WebJobs.Extensions.DurableTask Microsoft.Azure.Functions.Worker.Extensions.DurableTask
Netherite Microsoft.Azure.DurableTask.Netherite.AzureFunctions Microsoft.Azure.Functions.Worker.Extensions.DurableTask.Netherite
MSSQL Microsoft.DurableTask.SqlServer.AzureFunctions Microsoft.Azure.Functions.Worker.Extensions.DurableTask.SqlServer

たとえば、分離された worker アプリで既定のAzure Storage拡張機能をアップグレードするには、次のようにします。

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.DurableTask

拡張機能バンドルをアップグレードする

.NET以外のアプリ (JavaScript、Python、Java、PowerShell) では、extension バンドルを使用して、Durable Functions拡張機能を含むトリガーとバインドにアクセスします。 バージョン範囲に、最新のバンドル リリース

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

必要に応じてバージョン範囲を更新し、アプリを再デプロイします。

Durable Functions拡張機能のバージョンを手動でアップグレードする

拡張機能バンドルをアップグレードしても問題が解決せず、新しいDurable Functions拡張機能リリースに必要な修正プログラムが含まれている場合は、特定の拡張機能バージョンを手動でインストールできます。

Caution

拡張機能を手動で管理すると、拡張機能バンドルから自動更新が失われ、拡張機能間で互換性の問題が発生する可能性があります。 この方法は、時間の影響を受けやすい修正プログラムにのみ使用してください。

  1. extensionBundle ファイルから host.json セクションを削除します。

  2. .NET CLI をまだインストールしていない場合はインストールします。

  3. 拡張機能をインストールします。 拡張機能バンドルでサポートされているすべての拡張機能をインストールするには、次のコマンドを実行します。

    func extensions install
    

    特定のバージョンでDurable Functions拡張機能のみをインストールするには、次のコマンドを実行します。

    func extensions install -p Microsoft.Azure.WebJobs.Extensions.DurableTask -v <version>
    

    <version>を、releases ページのターゲット バージョンに置き換えます。

次のステップ