Azure Functions ランタイムバージョンをターゲットにする方法

[アーティクル]
04/25/2024

関数アプリは、特定のバージョンの Azure Functions ランタイムで実行されます。既定では、関数アプリはバージョン 4.x の Functions ランタイムで作成されます。関数アプリは、サポートされているメジャーバージョンで実行されている場合にのみサポートされます。この記事では、必要に応じて特定のバージョンをターゲットにする、または "ピン留めする" ように、Azure の関数アプリを構成する方法について説明します。

特定のバージョンをターゲットにする方法は、Windows と Linux のどちらを実行しているかによって異なります。この記事のバージョンでは、Windows がサポートされています。記事の上部でお使いの OS をお選びください。

特定のバージョンをターゲットにする方法は、Windows と Linux のどちらを実行しているかによって異なります。この記事のバージョンでは、Linux がサポートされています。記事の上部でお使いの OS をお選びください。

重要

可能であれば、常に、サポートされている最新バージョンの Azure Functions ランタイムで関数を実行してください。最新バージョンに問題があるため、指示された場合にのみ、アプリを特定のバージョンにピン留めしてください。関数が正しく実行されるとすぐに、常に最新のランタイムバージョンに移行する必要があります。

ローカル開発時に、インストールされているバージョンの Azure Functions Core Tools は、Azure の関数アプリで使用されるメジャーランタイムバージョンと一致している必要があります。詳細については、「Core Tools バージョン」を参照してください。

ランタイムのバージョンを更新する

可能であれば、常に、サポートされている最新バージョンの Azure Functions ランタイムで関数アプリを実行してください。関数アプリが現在、以前のバージョンのランタイムで実行されている場合は、アプリをバージョン 4.x に移行する必要があります

アプリに既存の関数があるときは、以降のメジャーランタイムバージョンに移行する前に予防措置を講じる必要があります。次の記事では、言語固有の破壊的変更などの、メジャーバージョン間の破壊的変更について詳しく説明します。既存の関数アプリを正常に移行するための段階的な手順も提供されます。

現在のランタイムバージョンを確認するには、「現在のランタイムバージョンの表示」を参照してください。

現在のランタイムバージョンの表示

関数アプリの現在のランタイムバージョンは、次のいずれかの方法で表示できます。

関数アプリで現在使用されているランタイムバージョンを表示して更新するには、次の手順に従います。

Azure portal で、関数アプリに移動します。
[設定] で [構成] を選択します。 [関数のランタイム設定] タブで、 [ランタイムバージョン] を探します。特定のランタイムバージョンに注目してください。以下の例では、バージョンが ~4 に設定されています。

Azure CLI から FUNCTIONS_EXTENSION_VERSION を表示することができます。

Azure CLI を使用して、az functionapp config appsettings list コマンドで現在のランタイムバージョンを表示します。

az functionapp config appsettings list --name <function_app> \
--resource-group <my_resource_group>

このコードでは、<function_app> をお使いの関数アプリの名前に置き換えます。また、<my_resource_group> をお使いの関数アプリのリソースグループの名前に置き換えます。

明確にするために切り捨てられていますが、次の出力に FUNCTIONS_EXTENSION_VERSION が表示されます。

[
  {
    "name": "FUNCTIONS_EXTENSION_VERSION",
    "slotSetting": false,
    "value": "~4"
  },
  {
    "name": "FUNCTIONS_WORKER_RUNTIME",
    "slotSetting": false,
    "value": "dotnet"
  },
  
  ...
]

前のコード例で [Cloud Shell を開く] を選び、Azure Cloud Shell でコマンドを実行します。また、Azure CLI をローカルに実行して、このコマンドを実行することもできます。ローカルで実行する場合は、最初に az login を実行してサインインする必要があります。

Azure Functions ランタイムを確認するには、次のコマンドレットを使用します。

Get-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>"

<FUNCTION_APP> をお使いの Function App の名前に、<RESOURCE_GROUP> をリソースグループの名前に置き換えます。 FUNCTIONS_EXTENSION_VERSION 設定の現在の値がハッシュテーブルに返されます。

特定のバージョンをピン留めする

Azure Functions を使用すると、特定の関数アプリで使用されるランタイムバージョンをターゲットにするように、FUNCTIONS_EXTENSION_VERSION アプリケーション設定を使用できます。メジャーバージョン (~4) のみを指定した場合、関数アプリは、ランタイムの新しいマイナーバージョンが利用可能になった時点で、自動的に新しいマイナーバージョンに更新されます。新しいマイナーバージョンでは破壊的変更が発生しないようにするため、マイナーバージョンの更新は自動的に行われます。

Linux アプリでは、linuxFxVersion サイト設定と FUNCTIONS_EXTENSION_VERSION を使用して、関数を実行するための適切な Linux 基本イメージを決定します。 Linux で新しい関数アプリを作成すると、ランタイムは言語スタックのランタイムバージョンに基づいて適切な基本イメージを自動的に選択します。

特定のランタイムバージョンにピン留めすると、関数アプリが再起動されます。

FUNCTIONS_EXTENSION_VERSION で特定のマイナーバージョン (4.0.12345 など) を指定すると、関数アプリは、自動更新に戻るように明示的に選択するまで、その特定のバージョンのランタイムにピン留めされます。メジャーバージョンをターゲットにできない関数アプリの問題を解決するのに十分な時間がある場合にのみ、特定のマイナーバージョンにピン留めする必要があります。古いマイナーバージョンは、運用環境から定期的に削除されます。削除されるマイナーバージョンにピン留めされている場合、関数アプリは、FUNCTIONS_EXTENSION_VERSION で設定されたバージョンではなく、最も近い既存のバージョンで実行されます。マイナーバージョンの削除は、App Service のお知らせページで発表されます。

Note

Visual Studio から特定のマイナーバージョンのランタイムにピン留めされているアプリに発行しようとすると、最新バージョンへの更新または発行の取り消しを求めるダイアログが表示されます。特定のマイナーバージョンを使用する必要がある場合にこのチェックを回避するには、.csproj ファイルに <DisableFunctionExtensionVersionUpdate>true</DisableFunctionExtensionVersionUpdate> プロパティを追加します。

次のいずれかの方法を使用して、アプリを特定のバージョンのランタイムに一時的にピン留めします。

関数アプリで現在使用されているランタイムバージョンを表示して更新するには、次の手順に従います。

Azure portal で、関数アプリに移動します。
[設定] で [構成] を選択します。 [関数のランタイム設定] タブで、 [ランタイムバージョン] を探します。特定のランタイムバージョンに注目してください。以下の例では、バージョンが ~4 に設定されています。

アプリを特定のマイナーバージョンにピン留めするには、[アプリケーション設定]>[FUNCTIONS_EXTENSION_VERSION] を選択し、[値] を必要なマイナーバージョンに変更して、[OK] を選択します。
[保存]>[続行] を選択して変更を適用し、アプリを再起動します。

az functionapp config appsettings set コマンドで、Function App の FUNCTIONS_EXTENSION_VERSION の設定を更新できます。

az functionapp config appsettings set --name <FUNCTION_APP> \
--resource-group <RESOURCE_GROUP> \
--settings FUNCTIONS_EXTENSION_VERSION=<VERSION>

<FUNCTION_APP> を関数アプリの名前に、<RESOURCE_GROUP> を関数アプリのリソースグループの名前に置き換えます。また、<VERSION> も一時的にターゲットにする必要がある特定のマイナーバージョンに置き換えます。

前のコード例で [試してみる] を選択し、Azure Cloud Shell でコマンドを実行します。また、Azure CLI をローカルに実行して、このコマンドを実行することもできます。ローカルで実行する場合は、最初に az login を実行してサインインする必要があります。

Functions ランタイムをピン留めするには、次のスクリプトを使用します。

Update-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>" -AppSetting @{"FUNCTIONS_EXTENSION_VERSION" = "<VERSION>"} -Force

<FUNCTION_APP> を関数アプリの名前に、<RESOURCE_GROUP> を関数アプリのリソースグループの名前に置き換えます。また、<VERSION> も一時的にターゲットにする必要がある特定のマイナーバージョンに置き換えます。返されたハッシュテーブルで FUNCTIONS_EXTENSION_VERSION 設定の更新された値を確認できます。

アプリケーション設定に変更が加えられると、Function App が再起動します。

Linux で特定のホストバージョンに関数アプリをピン留めするには、linuxFxVersion サイト設定でバージョン固有の基本イメージ URL を DOCKER|<PINNED_VERSION_IMAGE_URI> の形式で設定します。

重要

Linux 上でピン留めされた関数アプリは、通常のセキュリティとホスト機能の更新プログラムを受け取りません。サポートプロフェッショナルが推奨しない限り、Python|3.9 などのお使いの言語やバージョンの FUNCTIONS_EXTENSION_VERSION 設定と標準 linuxFxVersion 値を使用してください。有効な値については、linuxFxVersion リファレンス記事を参照してください。

特定のランタイムへのピン留めは、従量課金プランで実行されている Linux 関数アプリでは現在サポートされていません。

次に、Node.js 16 関数アプリを 4.14.0.3 の特定のランタイムバージョンにピン留めするために必要な linuxFxVersion 値の例を示します。

DOCKER|mcr.microsoft.com/azure-functions/node:4.14.0.3-node16

必要に応じて、サポートプロフェッショナルがアプリケーションの有効な基本イメージ URI を提供できます。

次の Azure CLI コマンドを使用して、linuxFxVersion を表示および設定します。現在、ポータルで、または Azure PowerShell を使用して linuxFxVersion は設定できません。

現在のランタイムバージョンを表示するには、az functionapp config show コマンドと共に使用します。
```
az functionapp config show --name <function_app> \
--resource-group <my_resource_group> --query 'linuxFxVersion' -o tsv
```
このコードでは、<function_app> をお使いの関数アプリの名前に置き換えます。また、<my_resource_group> をお使いの関数アプリのリソースグループの名前に置き換えます。 linuxFxVersion の現在の値が返されます。
関数アプリの linuxFxVersion の設定を更新するには、az functionapp config set コマンドを使用します。
```
az functionapp config set --name <FUNCTION_APP> \
--resource-group <RESOURCE_GROUP> \
--linux-fx-version <LINUX_FX_VERSION>
```
<FUNCTION_APP> をお使いの関数アプリの名前に置き換えます。また、<RESOURCE_GROUP> をお使いの関数アプリのリソースグループの名前に置き換えます。最後に、<LINUX_FX_VERSION> をサポートプロフェッショナルが提供する特定の画像の値に置き換えます。

このコマンドは、前のコード例で [Cloud Shell を開く] をクリックすることで、Azure Cloud Shell から実行できます。また、Azure CLI をローカルに使用して、az loginを実行してサインインした後に、このコマンドを実行することもできます。

サイト構成に変更が加えられると、関数アプリが再起動されます。

次のステップ

ランタイムのバージョンについては、リリースノートを参照してください

Azure Functions ランタイム バージョンをターゲットにする方法

ランタイムのバージョンを更新する

現在のランタイム バージョンの表示

特定のバージョンをピン留めする

次のステップ

その他のリソース

Azure Functions ランタイムバージョンをターゲットにする方法

現在のランタイムバージョンの表示