C# アプリをインプロセス モデルから分離ワーカー モデルに移行する

重要

インプロセス モデルのサポートは、2026 年 11 月 10 日に終了します。 この記事の指示に従って、アプリをアイソレーテッドワーカーモデルに移行してください。

この記事では、.NET関数アプリを in-process モデルから isolated worker モデルに安全に移行するプロセスについて説明します。 これらのモデル間の高レベルの違いについては、「実行モードの比較」を参照してください。

このガイドでは、アプリが Functions ランタイムのバージョン 4.x で実行されていることを前提としています。 もしそうでなければ、以下のガイドを使ってホストバージョンをアップグレードしてください。 これらのホスト バージョンの移行ガイドは、作業を進める際に分離されたワーカー モデルに移行するのにも役立ちます。

サポートされている場合、この記事では分離ワーカー モデルのASP.NET Core統合を利用します。これにより、アプリで HTTP トリガーを使用するときにパフォーマンスが向上し、使い慣れたプログラミング モデルが提供されます。

移行する関数アプリを特定する

次のAzure PowerShell スクリプトを使用して、現在インプロセス モデルを使用している関数アプリの一覧をサブスクリプションに生成します。

スクリプトは、現在使用するように構成されているAzure PowerShellサブスクリプションを使用します。 まず Set-AzContext -Subscription '<YOUR SUBSCRIPTION ID>' を実行し、評価したいサブスクリプションのIDに <YOUR SUBSCRIPTION ID> を入れ替えることでサブスクリプションを変更できます。

$FunctionApps = Get-AzFunctionApp

$AppInfo = @{}

foreach ($App in $FunctionApps)
{
     if ($App.Runtime -eq 'dotnet')
     {
          $AppInfo.Add($App.Name, $App.Runtime)
     }
}

$AppInfo

ターゲット .NET バージョンを選択する

孤立ワーカーモデルに移行する際は、関数アプリとその依存関係が.NET(旧.NET Core)上で動作できるかどうかに基づいてターゲットを選びます。

  • もしあなたのアプリとその依存関係が.NET上で動作するなら、.NET 10をターゲットにしてください。
  • もしアプリが.NET Frameworkでしか利用できないライブラリやAPIに依存している場合は、.NET Framework 4.8をターゲットにしてください。

移行を準備する

アプリを分離されたワーカーモデルに移行する前に、このガイドの内容を十分に確認してください。 また、 孤立労働者モデル の特徴や 両モデルの違いにも慣れておくこと。

アプリケーションを移行するには:

  1. 「ローカル プロジェクトを移行する」の手順に従って、ローカル プロジェクトを分離ワーカー モデルに移行します。
  2. プロジェクトを移行した後は、Azure Functions Core Toolsのバージョン4.xを使ってローカルで完全にテストしてください。
  3. Azureの関数アプリを分離モデルに更新します。

ローカル プロジェクトを移行する

このセクションでは、ローカルプロジェクトを孤立労働者モデルに移行させるために必要なさまざまな変更点を概説します。 一部の手順は、ターゲット バージョンの.NETに基づいて変更されます。 タブを使用して、目的のバージョンに一致する手順を選択します。

ヒント

.NET 10に移行する場合、.NETアップグレードアシスタントは以下のセクションで述べた多くの変更を自動的に行えます。

最初に、プロジェクト ファイルを変換して、依存関係を更新します。 あなたが作業していると、プロジェクトのビルドエラーが表示されます。 以降の手順では、対応する変更を行ってこれらのエラーを除去します。

プロジェクトファイル

以下の例は、バージョン4.xで.NET 8を使用した.csprojプロジェクトファイルを示しています:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
    <RootNamespace>My.Namespace</RootNamespace>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.NET.Sdk.Functions" Version="4.1.1" />
  </ItemGroup>
  <ItemGroup>
    <None Update="host.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
    <None Update="local.settings.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <CopyToPublishDirectory>Never</CopyToPublishDirectory>
    </None>
  </ItemGroup>
</Project>

次のいずれかの手順を使用して、分離ワーカー モデルで実行されるようにこの XML ファイルを更新します。

これらの手順では、ローカルの C# プロジェクトを想定しています。アプリで代わりに C# スクリプト (.csx ファイル) を使用する場合は、先 に進む前にプロジェクト モデルに変換する 必要があります。

.csproj XML プロジェクト ファイルでは、次の変更が必要です。

  1. Project要素のSdk属性をAzure.Functions.Sdk/1.0.0に設定します。

  2. PropertyGroup の値を設定します。 TargetFramework から net10.0。

  3. ItemGroup で。 PackageReference リストで、パッケージ参照を Microsoft.NET.Sdk.Functions から以下の参照に置き換えます。 Microsoft.Azure.Functions.Workerパッケージは明確な参考として残してください:

    <FrameworkReference Include="Microsoft.AspNetCore.App" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker" Version="2.52.0" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" Version="2.1.0" />
    <PackageReference Include="Microsoft.ApplicationInsights.WorkerService" Version="2.22.0" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.ApplicationInsights" Version="1.2.0" />
    

    Microsoft.Azure.WebJobs.* 名前空間内の他のパッケージへの参照を書き留めます。 これらのパッケージは後の手順で置き換えます。

  4. 次の新しい ItemGroup を追加します。

    <ItemGroup>
      <Using Include="System.Threading.ExecutionContext" Alias="ExecutionContext"/>
    </ItemGroup>
    

これらの変更を行うと、更新されたプロジェクトは次の例のようになります。

<Project Sdk="Azure.Functions.Sdk/1.0.0">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <RootNamespace>My.Namespace</RootNamespace>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
  <ItemGroup>
    <FrameworkReference Include="Microsoft.AspNetCore.App" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker" Version="2.52.0" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" Version="2.1.0" />
    <PackageReference Include="Microsoft.ApplicationInsights.WorkerService" Version="2.22.0" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.ApplicationInsights" Version="1.2.0" />
    <!-- Other packages may also be in this list -->
  </ItemGroup>
  <ItemGroup>
    <None Update="host.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
    <None Update="local.settings.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <CopyToPublishDirectory>Never</CopyToPublishDirectory>
    </None>
  </ItemGroup>
  <ItemGroup>
    <Using Include="System.Threading.ExecutionContext" Alias="ExecutionContext"/>
  </ItemGroup>
</Project>

プロジェクトのターゲット フレームワークを変更するには、プロジェクト コードの外部でツールチェーンの一部を変更する必要がある場合もあります。 たとえば、VS Code では、ユーザー設定またはプロジェクトの azureFunctions.deploySubpath ファイルを使用して、拡張機能の設定を更新する必要がある場合があります。 ビルド ステップまたは CI/CD パイプラインの一部として、プロジェクト コードの外部に存在する可能性があるフレームワーク バージョンへの依存関係があるかどうかを確認します。

パッケージ参照

アイソレーテッドワーカーモデルに移行する際は、アプリケーションが参照するパッケージを変更してください。

まだであれば、プロジェクトの最新安定バージョンを以下に更新してください:

アプリが使用するトリガーとバインドによっては、アプリは別のパッケージ セットを参照する必要がある場合があります。 次の表に、最も一般的に使用されるいくつかの拡張機能の置換を示します。

シナリオ パッケージ参照の変更
タイマー トリガー 追加
Microsoft.Azure.Functions.Worker.Extensions.Timer
ストレージバインディング 置き換える
Microsoft.Azure.WebJobs.Extensions.Storage
with
Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs
Microsoft.Azure.Functions.Worker.Extensions.Storage.Queues、
Microsoft.Azure.Functions.Worker.Extensions.Tables
BLOB のバインド 参照を...に置き換える
Microsoft.Azure.WebJobs.Extensions.Storage.Blobs
最新バージョンを使用して
Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs
キューのバインド 参照を...に置き換える
Microsoft.Azure.WebJobs.Extensions.Storage.Queues
最新バージョンを使用して
Microsoft.Azure.Functions.Worker.Extensions.Storage.Queues
テーブルバインディング 参照を...に置き換える
Microsoft.Azure.WebJobs.Extensions.Tables
最新バージョンを使用して
Microsoft.Azure.Functions.Worker.Extensions.Tables
Cosmos DB のバインディング 参照を...に置き換える
Microsoft.Azure.WebJobs.Extensions.CosmosDB
および/または
Microsoft.Azure.WebJobs.Extensions.DocumentDB
最新バージョンを使用して
Microsoft.Azure。Functions.Worker.Extensions.CosmosDB
Service Bus のバインド 参照を...に置き換える
Microsoft.Azure.WebJobs.Extensions.ServiceBus
最新バージョンを使用して
Microsoft.Azure.Functions.Worker.Extensions.ServiceBus
Event Hubs のバインド 参照を...に置き換える
Microsoft.Azure.WebJobs.Extensions.EventHubs
最新バージョンを使用して
Microsoft.Azure.Functions.Worker.Extensions.EventHubs
Event Grid のバインド 参照を...に置き換える
Microsoft.Azure.WebJobs.Extensions.EventGrid
最新バージョンを使用して
Microsoft.Azure。Functions.Worker.Extensions.EventGrid
SignalR Service バインディング 参照を...に置き換える
Microsoft.Azure.WebJobs.Extensions.SignalRService
最新バージョンを使用して
Microsoft.Azure.Functions.Worker.Extensions.SignalRService
Durable Functions 参照を...に置き換える
Microsoft.Azure.WebJobs.Extensions.DurableTask
最新バージョンを使用して
Microsoft.Azure.Functions.Worker.Extensions.DurableTask
Durable Functions
(SQL ストレージ プロバイダー)
参照を...に置き換える
Microsoft.DurableTask.SqlServer.AzureFunctions
最新バージョンを使用して
Microsoft.Azure.Functions.Worker.Extensions.DurableTask.SqlServer
Durable Functions
(Netherite ストレージ プロバイダー)
参照を...に置き換える
Microsoft.Azure.DurableTask.Netherite.AzureFunctions
最新バージョンを使用して
Microsoft.Azure.Functions.Worker.Extensions.DurableTask.Netherite
SendGrid のバインド 参照を...に置き換える
Microsoft.Azure.WebJobs.Extensions.SendGrid
最新バージョンを使用して
Microsoft.Azure.Functions.Worker.Extensions.SendGrid
Kafka のバインド 参照を...に置き換える
Microsoft.Azure.WebJobs.Extensions.Kafka
最新バージョンを使用して
Microsoft.Azure.Functions.Worker.Extensions.Kafka
RabbitMQ のバインド 参照を...に置き換える
Microsoft.Azure.WebJobs.Extensions.RabbitMQ
最新バージョンを使用して
Microsoft.Azure.Functions.Worker.Extensions.RabbitMQ
依存関係の挿入
とスタートアップ設定
参照を削除します
Microsoft.Azure.Functions.Extensions
(分離ワーカー モデルでは、この機能が既定で提供されます)

検討するべき拡張機能の全一覧については、「サポートされているバインド」を参照し、分離プロセス モデルの完全なインストール手順については、各拡張機能のドキュメントを参照してください。 対象としているすべてのパッケージの最新の安定バージョンをインストールするようにしてください。

ヒント

このプロセス中に拡張機能のバージョンを変更するとき、場合によっては、host.json ファイルの更新も必要になります。 使用する各拡張機能のドキュメントを必ず読んでください。 たとえば、Service Bus拡張機能では、バージョン 4.x と 5.x の間の構造に破壊的変更があります。 詳細については、Azure Functions の Azure Service Bus バインド を参照してください。

分離ワーカー モデル アプリケーションでは、Microsoft.Azure.WebJobs.* 名前空間または Microsoft.Azure.Functions.Extensions 内のパッケージを参照しないでください。 これらへの参照が何か残っている場合は、それらを削除する必要があります。

ヒント

また、アプリは、トリガーとバインドの一部として、またはスタンドアロンの依存関係として、Azure SDKの種類に依存する場合もあります。 この機会を利用して、これらも同様に更新する必要があります。 Functions 拡張機能の最新バージョンは、.NET の Azure SDK の最新バージョンで動作し、ほとんどのパッケージは 形式です。

Program.cs ファイル

分離されたワーカープロセスで動作する際は、以下の内容の Program.cs ファイルを追加してください。

using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

var host = new HostBuilder()
    .ConfigureFunctionsWebApplication()
    .ConfigureServices(services => {
        services.AddApplicationInsightsTelemetryWorkerService();
        services.ConfigureFunctionsApplicationInsights();
    })
    .Build();

host.Run();

この例にはASP.NET Core統合が含まれており、アプリで HTTP トリガーを使用する場合にパフォーマンスを向上させ、使い慣れたプログラミング モデルを提供します。 HTTP トリガーを使用しない場合は、 ConfigureFunctionsWebApplication の呼び出しを ConfigureFunctionsWorkerDefaultsの呼び出しに置き換えることができます。 その場合は、プロジェクト ファイルから Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore への参照を削除できます。 ただし、パフォーマンスを最大限に高めるには、他のトリガーの種類の関数であっても、FrameworkReferenceを ASP.NET Coreしておく必要があります。

Program.cs ファイルは、FunctionsStartup属性を持つファイル (通常はStartup.cs ファイル) を置き換えます。 FunctionsStartupコードがIFunctionsHostBuilder.Servicesを参照する場所では、代わりにProgram.csの.ConfigureServices()のHostBuilder メソッド内にステートメントを追加できます。 Program.csの操作の詳細については、分離ワーカー モデル ガイドのスタートアップと構成に関するページを参照してください。

前述のデフォルトの Program.cs 例は、Application Insights SDKを使ってアプリケーションインサイトを設定するものでした。 孤立したワーカーモデルガイドで説明されているOpenTelemetryベースのApplication Insights構成については、 Application Insightsをご覧ください。 Program.csでは、プロジェクト内のコードからのログに適用する必要があるログ フィルター処理も構成する必要があります。 分離ワーカー モデルでは、 host.json ファイルは Functions ホスト ランタイムによって出力されるイベントのみを制御します。 Program.csでフィルター規則を構成しない場合は、テレメトリのさまざまなカテゴリに対してログ レベルの違いが表示されることがあります。

カスタム構成ソースは HostBuilderの一部として登録できますが、これらは同様にプロジェクト内のコードにのみ適用されます。 プラットフォームにはトリガーとバインドの構成も必要です。これは、アプリケーション設定、Key Vault参照、または App Configuration references 機能を通じて提供する必要があります。

既存の FunctionsStartup から Program.cs ファイルにすべてを移動した後、 FunctionsStartup 属性とその適用先のクラスを削除できます。

関数シグネチャの変更

一部の主要な種類は、インプロセス モデルと分離ワーカー モデルの間で変更されます。 これらの変更の多くは、関数シグネチャを構成する属性、パラメータ、リターン型に関連しています。 各機能ごとに、以下の点を変更してください:

  • 関数の名前も設定する関数属性
  • 関数がどのように ILogger/ILogger<T> を取得するか
  • トリガーとバインドの属性とパラメーター

このセクションの残りの部分では、これらの手順について説明します。

関数の属性

分離ワーカー モデルの Function 属性は FunctionName 属性に置き換えられます。 新しい属性は同じシグネチャを持ち、唯一の違いは名前にあります。 したがって、プロジェクト全体で弦の交換を行うことができます。

ログ記録

インプロセス モデルでは、関数の省略可能な ILogger パラメーターを含めたり、依存関係の挿入を使用して ILogger<T>を取得したりできます。 アプリに既に依存関係の挿入を使用していた場合、同じメカニズムが分離ワーカー モデルでも作用します。

ただし、ILogger メソッド パラメーターに依存した関数の場合は、変更を行う必要があります。 依存注入を使って ILogger<T>を得てください。 次の手順を使用して関数のログ記録メカニズムを移行します。

  1. 関数クラスで、private readonly ILogger<MyFunction> _logger; プロパティを追加して、MyFunction を関数クラスの名前に置き換えます。

  2. ILogger<T> をパラメーターとして受け取る関数クラスのコンストラクターを作成します。

    public MyFunction(ILogger<MyFunction> logger) {
        _logger = logger;
    }
    

    先ほどのコード スニペットに含まれる MyFunction の両インスタンスを、関数クラスの名前に置き換えます。

  3. 関数コードの中のログ記録操作で、ILogger パラメーターへの参照を _logger に置き換えます。

  4. ILogger パラメーターを関数シグネチャから削除します。

詳細については、「分離ワーカー モデルでのログ記録」をご覧ください。

トリガーとバインディングの変更

前の 手順でパッケージ参照を変更したときに、トリガーとバインドのエラーが発生しました。このエラーを修正できるようになりました。

  1. using Microsoft.Azure.WebJobs; ステートメントを削除します。

  2. using Microsoft.Azure.Functions.Worker; ステートメントを追加します。

  3. 各バインディング属性で、属性の名前をそのリファレンス ドキュメントの指定のとおりに変更します。「サポートされるバインディング」インデックスをご覧ください。 一般的に、属性名の変更は次のとおりです。

    • トリガーは、通常は同じ名前のままです。 たとえば、QueueTrigger が両モデルの属性名になります。
    • 通常、入力バインディングには Input を名前に追加する必要があります。 たとえば、CosmosDB 入力バインディング属性をインプロセス モデルで使用した場合、この属性は CosmosDBInput になります。
    • 通常、出力バインドにはOutputを名前に追加する必要があります。 たとえば、Queue 出力バインディング属性をインプロセス モデルで使用した場合、この属性は QueueOutput になります。
  4. 属性パラメーターを、バインディングのリファレンス ドキュメントで指定されているように、分離ワーカー モデル バージョンが反映されるように更新します。

    たとえば、インプロセス モデルで、BLOB 出力バインディングは、[Blob(...)] プロパティを含む Access 属性で表現されます。 分離ワーカー モデルでは、BLOB 出力属性は [BlobOutput(...)] になります。 バインディングはもはや Access プロパティを必要としないので、そのパラメータを削除できます。 だから [Blob("sample-images-sm/{fileName}", FileAccess.Write, Connection = "MyStorageConnection")] は [BlobOutput("sample-images-sm/{fileName}", Connection = "MyStorageConnection")]になります.

  5. 出力バインディングを関数パラメーター リストから取り出します。 出力バインディングが1つだけの場合は、そのバインディングを関数のリターン型に適用できます。 複数の出力がある場合、各出力のプロパティで新しいクラスを作成し、属性をこれらのプロパティに適用します。 詳細については、「複数の出力バインディング」を参照してください。

  6. それぞれのバインディングのリファレンスドキュメントを確認し、バインド可能な種類を調べてください。 場合によっては、種類の変更が必要になることがあります。 出力バインディングの場合、進行中のモデルバージョンが IAsyncCollector<T>を使っていた場合、この型をターゲット型の配 T[]にバインディングすることで置き換えることができます。 出力バインディングを、それが表すサービスのクライアント オブジェクトに、使用可能な場合は入力バインディングのバインディングの種類として、あるいはクライアントを自分で挿入することにより、置き換えることも検討できます。

  7. 関数に IBinder パラメーターが含まれる場合は、それを除去してください。 機能を、それが表すサービスのクライアント オブジェクトに、使用可能な場合は入力バインディングのバインディングの種類として、あるいはクライアントを自分で挿入することにより、置き換えます。

  8. 関数コードを更新して、すべての新しい種類で機能するようにします。

非同期HTTPストリームI/Oへの移行

HTTPトリガー関数がASP.NET Core統合を使用している場合、HTTPリクエストおよびレスポンスストリームからの同期読み書きを非同期メソッドに置き換えます。 同期操作は InvalidOperationException: Synchronous operations are disallowedで失敗することがあります。 例えば、 ReadToEnd を ReadToEndAsyncに、 Write を WriteAsyncに、 WriteString を WriteStringAsyncに、 Flush を FlushAsyncに置き換えます。

これらの操作を待つ間は、関数メソッドを async としてマークし、返還型を Task<T>でラップします。 例えば、 IActionResult を Task<IActionResult> に、 MultiResponse を Task<MultiResponse>に変えるなどです。 ASP.NET Coreは、同期I/Oがスレッドプールスターベーションを引き起こす可能性があるため、同期リクエストおよびレスポンスI/Oをデフォルトで禁止しています。 依存関係やシリアライザが非同期I/Oをサポートしていない場合は、同期I/O(AllowSynchronousIO)を可能にする手順として、ASP.NET Core統合付きのJSONシリアライズを参照してください。

local.settings.json ファイル

local.settings.json ファイルは、ローカルで実行されている場合にのみ使用されます。 詳細については、「ローカル設定ファイル」を参照してください。

インプロセスの実行中から分離されたワーカー プロセスでの実行に移行する場合は、 FUNCTIONS_WORKER_RUNTIME 値を dotnet-isolated に変更する必要があります。 local.settings.json ファイルに少なくとも以下の要素が含まれていることを確認してください。

{
    "IsEncrypted": false,
    "Values": {
        "AzureWebJobsStorage": "UseDevelopmentStorage=true",
        "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated"
    }
}

AzureWebJobsStorageの値が異なる場合があります。 移行の一環として値を変更する必要はありません。

host.json ファイル

host.json ファイルに変更は必要ありません。 ただし、Application Insights の構成がインプロセス モデル プロジェクトのこのファイルにある場合は、 Program.cs ファイルにさらに変更を加える必要があります。 host.json ファイルはFunctionsホストランタイムからのログのみを制御します。 孤立ワーカーモデルでは、これらのログの一部はアプリケーションから直接提供されるため、より多くのコントロールが可能になります。 これらのログをフィルター処理する方法の詳細については、「分離ワーカー モデルでのログ レベルの管理」を参照してください。

その他のコード変更

このセクションでは、移行を行う際に考慮する必要があるその他のコード変更に焦点を当てます。 これらの変更はすべてのアプリケーションで必要なわけではありませんが、シナリオに関連するかどうかを評価する必要があります。

JSON シリアル化

既定では、分離されたワーカー モデルでは、JSON シリアル化に System.Text.Json が使用されます。 シリアライザー のオプションをカスタマイズしたり、JSON に切り替えたりするには.NET (Newtonsoft.Json) を参照してください JSON シリアル化のカスタマイズ。

進行中のモデルは Newtonsoft.Jsonを使っていたので、関数がバインドする型のシリアライゼーション属性も必ずチェックしてください。 System.Text.JsonはNewtonsoft.Jsonの属性[JsonProperty]や[JsonIgnore]を無視します。 エラーを報告せずに、影響を受けたプロパティをデフォルト値にバインドします。 それらを System.Text.Json の同等のもの(例えば [JsonPropertyName])に置き換えるか、ペイロードを処理するレイヤーに Newtonsoft.Json を設定してください。

Application Insights のログ レベルとフィルター処理

ログは、Functions ホスト ランタイムとプロジェクト内のコードの両方から Application Insights に送信できます。 host.json を使用すると、ホスト ログの規則を構成できますが、コードからのログを制御するには、Program.csの一部としてフィルター規則を構成する必要があります。 これらのログをフィルター処理する方法の詳細については、「分離ワーカー モデルでのログ レベルの管理」を参照してください。

HTTPトリガー移行の例

以下の例は、HTTPトリガー関数を移行前後に分離されたワーカーモデルと比較しています。

インプロセス モデルの HTTP トリガーは次の例のようになります。

using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.Extensions.Logging;

namespace Company.Function
{
    public static class HttpTriggerCSharp
    {
        [FunctionName("HttpTriggerCSharp")]
        public static IActionResult Run(
            [HttpTrigger(AuthorizationLevel.Function, "get", Route = null)] HttpRequest req,
            ILogger log)
        {
            log.LogInformation("C# HTTP trigger function processed a request.");

            return new OkObjectResult($"Welcome to Azure Functions, {req.Query["name"]}!");
        }
    }
}

移行後のバージョンの HTTP トリガーは次の例のようになります。

using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.Logging;

namespace Company.Function
{
    public class HttpTriggerCSharp(ILogger<HttpTriggerCSharp> logger)
    {
        [Function("HttpTriggerCSharp")]
        public IActionResult Run(
            [HttpTrigger(AuthorizationLevel.Function, "get")] HttpRequest req)
        {
            logger.LogInformation("C# HTTP trigger function processed a request.");

            return new OkObjectResult($"Welcome to Azure Functions, {req.Query["name"]}!");
        }
    }
}

Azureで関数アプリを更新する

ローカルプロジェクトを移行した後、関数アプリの構成を更新し、移行したコードをデプロイして分離されたワーカーモデルへの移行を完了させます。

移行したプロジェクトを公開する前に

更新されたコードプロジェクトを公開する前に、以下の2つの変更を同時に完了する計画を立ててください。

  • FUNCTIONS_WORKER_RUNTIMEアプリケーション設定をdotnet-isolatedに変更してください。
  • 移行した孤立したワーカープロジェクトを関数アプリに公開してください。

変更のたびにアプリが再起動します。 最初の変更を完了した後、デプロイされたコードと設定されたランタイムが一致せず、2回目の変更を終えるまで実行時とペイロードのミスマッチ(AZFD0013)が発生します。

可能であれば、移動中に ステージングスロット を使いましょう。 ステージングスロットには以下の利点があります:

  • コードと実行時の不一致による一時的なエラー状態を本番環境から除外します。
  • 移行したコードや設定を本番環境に切り替える前にテストできます。

2つの変更を完了する際に、ステージングスロットのログにエラーが見られることがあります。 スロットを交換する前に、エラーが止まりアプリが正常に動作しているかを確認してください。

スロットを使って機能アプリを更新しましょう

ステージングスロットを使って関数アプリを孤立ワーカーモデルに更新するには、以下の手順をご利用ください。

  1. まだの場合はデプロイ スロットを作成します。 また、スロット スワップ プロセスを理解し、中断を最小限に抑えて既存のアプリケーションを更新できるようにすることもできます。

  2. FUNCTIONS_WORKER_RUNTIME アプリケーション設定を dotnet-isolated に設定して、ステージング (非運用) スロットの構成を分離ワーカー モデルを使用するように変更します。 を FUNCTIONS_WORKER_RUNTIMEとしてマークしないでください。

    もしアップデートの一環として別のバージョンの.NETをターゲットにしているなら、スタック構成を変更してください。 これを行うには、 スタック構成の更新に関する記事を参照してください。 今後の.NETバージョンの更新にも同じ手順を使用できます。

    CI/CD パイプラインなどの自動インフラ プロビジョニングがある場合は、自動化処理についても、dotnet-isolated が FUNCTIONS_WORKER_RUNTIME に設定されたままになっており、正しい .NET バージョンを対象としていることを確認してください。

  3. 移行したプロジェクトを関数アプリのステージング (非運用) スロットに発行します。

    Visual Studioを使用して、インプロセス モデルを使用する既存のアプリまたはスロットに分離ワーカー モデル プロジェクトを発行する場合は、前の手順を同時に完了することもできます。 前の手順を完了していない場合は、Visual Studio展開中に関数アプリを更新するように求められます。 Visual Studioはこのアップデートを単一の操作として提示しますが、これらの更新は依然として2つの別々の操作です。 中間状態の間、ステージング (非運用) スロットのログにエラーが引き続き表示される場合があります。

  4. ステージング (非運用) スロット内でアプリケーションが想定どおりに動作していることを確認します。

  5. スロット スワップ操作を実行して、ステージング (非運用) スロットで行った変更を運用スロットに適用します。 スロット スワップは 1 回の更新として行われるため、運用環境での一時的なエラー状態が発生することを回避できます。

  6. アプリケーションが運用スロット内で期待どおりに機能していることを確認します。

これらの手順を完了すると、移行が完了し、アプリは分離モデル上で動作します。 お疲れさまでした。 移行が必要な他のアプリについては、このガイドの手順を必要に応じて繰り返します。

次のステップ