Flex 従量課金プランの関数アプリを作成および管理する

1. まだ Azure にサインインしていない場合は、Azure にサインインします。

   az login
   

   az login コマンドで Azure アカウントにサインインします。

2. az functionapp list-flexconsumption-locations コマンドを使用して、現在 Flex 従量課金をサポートしているリージョンの一覧を確認します。

   az functionapp list-flexconsumption-locations --output table
   

3. 現在サポートされているリージョンのいずれかにリソース グループを作成します。

   az group create --name <RESOURCE_GROUP> --location <REGION>
   

   上記のコマンドで、<RESOURCE_GROUP> をサブスクリプション内で一意の値に、<REGION> を現在サポートされているリージョンのいずれかに置き換えます。 az group create コマンドでリソース グループを作成します。

4. リソース グループとリージョン内に汎用ストレージ アカウントを作成します。

   az storage account create --name <STORAGE_NAME> --location <REGION> --resource-group <RESOURCE_GROUP> --sku Standard_LRS --allow-blob-public-access false
   

   前の例の <STORAGE_NAME> は、適宜、Azure Storage 内で一意の名前に置き換えてください。 名前は 3 文字から 24 文字とし、小文字のみを使用する必要があります。 Standard_LRS は汎用アカウントを指定します。これは Functions でサポートされています。 az storage account create コマンドでストレージ アカウントを作成します。

   重要

   ストレージ アカウントは、アプリケーション コード自体を含む重要なアプリ データを格納するために使用されます。 他のアプリやユーザーからのアクセスをストレージ アカウントに制限する必要があります。

5. Azure に関数アプリを作成します。

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime dotnet-isolated --runtime-version 8.0 
   

   インプロセスで実行される C# アプリは現在、Flex 従量課金プランで実行される場合はサポートされていません。

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime java --runtime-version 17 
   

   Java アプリの場合は、Java 11 も現在サポートされています。

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime node --runtime-version 20 
   

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime python --runtime-version 3.11 
   

   Python アプリの場合は、Python 3.10 も現在サポートされています。

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime powershell --runtime-version 7.4 
   

   この例では、<RESOURCE_GROUP> と <STORAGE_NAME> の両方をそれぞれ、前の手順で使用したリソース グループとアカウントの名前に置き換えます。 また、<APP_NAME> も自分に適したグローバルに一意の名前に置き換えます。 <APP_NAME> はまた、関数アプリの既定のドメイン ネーム サーバー (DNS) ドメインでもあります。 az functionapp create コマンドは、Azure に関数アプリを作成します。

   このコマンドでは、Flex 従量課金プランで実行される関数アプリを作成します。

   このアプリは、常時使用可能なインスタンスを指定せずに作成したため、関数をアクティブに実行した場合にのみコストが発生します。 また、このコマンドを実行すると、関連する Azure Application Insights インスタンスが同じリソース グループに作成されます。このインスタンスを使用することで、関数アプリを監視し、ログを確認できます。 詳しくは、「Azure Functions を監視する」をご覧ください。

1. Azure portal で、メニューまたは [ホーム] ページから [リソースの作成] を選択します。

2. [作業の開始] を選択し、[関数アプリ] で [作成] を選択します。

3. [ホスティング オプションの選択] で、[Flex 従量課金]>[選択] の順に選択します。

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

   設定	提案された値	説明
   サブスクリプション	該当するサブスクリプション	新しい関数アプリを作成するサブスクリプション。
   リソース グループ	myResourceGroup	関数アプリを作成する新しいリソース グループの名前。
   関数アプリ名	グローバルに一意の名前	新しい関数アプリを識別する名前。 有効な文字は、a-z (大文字と小文字の区別をしない)、0-9、および -です。
   リージョン	優先リージョン	自分の近く、または関数がアクセスできる他のサービスの近くのリージョンを選択します。 サポートされていないリージョンは表示されません。 詳細については、「現在サポートされているリージョンを表示する」を参照してください。
   ランタイム スタック	優先言語	サポートされている言語ランタイム スタックのいずれかを選択します。 Web 用 Visual Studio Code を使用したポータル内編集は現在、Node.js、PowerShell、Python アプリでのみ使用できます。 C# クラス ライブラリ、Java の関数はローカルで開発する必要があります。
   Version	Language version (言語バージョン)	サポートされているバージョンの言語ランタイム スタックを選択します。
   インスタンス サイズ	既定値	アプリの各インスタンスに割り当てられるインスタンス メモリの量を決定します。 詳細については、「インスタンス メモリ」を参照してください。

5. 残りのタブの既定のオプション ([ストレージ] タブで新しいストレージ アカウントを作成する既定の動作や、[監視] タブの新しい Application Insights インスタンスなど) は、そのまま受け入れます。既存のストレージ アカウントまたは Application Insights インスタンスを使用することもできます。

6. [確認と作成] を選択して選択したアプリ設定をレビューし、[作成] を選択して関数アプリをプロビジョニングおよびデプロイします。

7. ポータルの右上隅の [通知] アイコンを選択し、"デプロイメントに成功しました" というメッセージが表示されるまで待ちます。

8. [リソースに移動] を選択して、新しい関数アプリを確認します。 また、 [ダッシュボードにピン留めする] を選択することもできます。 ピン留めすると、ダッシュボードからこの関数アプリ リソースに戻るのが容易になります。

1. F1 キーを押し、コマンド パレットに「Azure Functions: Create function app in Azure...(Advanced)」と入力します。

2. サインしていない場合は、Azure にサインインするよう求められます。 無料の Azure アカウントを作成することもできます。 ブラウザーからサインインしたら、Visual Studio Code に戻ります。

3. プロンプトに従って、次の情報を入力します。

   Prompt	[選択]
   関数アプリにグローバルで一意の名前を入力します。	新しい関数アプリを識別するグローバルに一意の名前を入力し、Enter キーを選択します。 関数アプリ名の有効な文字は、a-z、0-9、- です。
   Select a hosting plan. (ホスティング プランを選択してください。)	[Flex Consumption]\(Flex 従量課金\) を選択します。
   ランタイム スタックを選択してください	サポートされている言語スタック バージョンのいずれかを選択します。
   新しいリソース用のリソース グループの選択。	[新しいリソース グループの作成] を選択し、myResourceGroup のようなリソース グループ名を入力して、Enter キーを選択します。 既存のリソース グループを選択することもできます。
   新しいリソースの場所の選択。	最寄りの、または関数がアクセスする他のサービスの近くにあるサポートされているリージョン内の場所を選択します。 サポートされていないリージョンは表示されません。 詳細については、「現在サポートされているリージョンを表示する」を参照してください。
   ストレージ アカウントを選択します。	[新しいストレージ アカウントの作成] を選択し、そのプロンプトで、関数アプリで使用される新しいストレージ アカウントのグローバルに一意の名前を指定して Enter キーを押します。 ストレージ アカウント名の長さは 3 文字から 24 文字で、数字と小文字のみを使用できます。 既存のアカウントを選択することもできます。
   アプリの Application Insights のリソースを選択してください	[Application Insights リソースの新規作成] を選択し、そのプロンプトで、関数の実行時データを格納するために使用されるインスタンスの名前を指定します。

   関数アプリが作成されると、通知が表示されます。 この通知の [View Output](出力の表示) を選択すると、作成済みの Azure リソースなど、作成とデプロイの結果が表示されます。

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

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

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

   

ルート プロジェクト フォルダーで、次の func azure functionapp publish コマンドを実行します。

func azure functionapp publish <APP_NAME>

この例では、<APP_NAME> をご自身のアプリの名前に置き換えてください。 デプロイが成功すると、次の出力のような結果 (簡潔にするために切り詰められています) が表示されます。

...

Getting site publishing info...
Creating archive for current directory...
Performing remote build for functions project.

...

Deployment successful.
Remote build succeeded!
Syncing triggers...
Functions in msdocs-azurefunctions-qs:
    HttpExample - [httpTrigger]
        Invoke url: https://msdocs-azurefunctions-qs.azurewebsites.net/api/httpexample

仮想ネットワーク統合は、az functionapp create コマンドを実行し、--vnet および --subnet パラメーターを含めることによって有効にできます。

1. まだ行っていない場合は、仮想ネットワークとサブネットを作成します。

2. 「Flex 従量課金アプリを作成する」の手順 1 から 4 を完了して、アプリで必要なリソースを作成します。

3. 次の例のように、az functionapp create コマンドを実行し、--vnet および --subnet パラメーターを含めます。

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime <RUNTIME_NAME> --runtime-version <RUNTIME_VERSION> --vnet <VNET_RESOURCE_ID> --subnet <SUBNET_NAME>
   

   <VNET_RESOURCE_ID> 値は、仮想ネットワークのリソース ID であり、/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.Network/virtualNetworks/<VNET_NAME> という形式です。 az network vnet list --resource-group <RESOURCE_GROUP> --output tsv --query "[]".id コマンドを使用すると、<RESOURCE_GROUP> でフィルター処理された仮想ネットワーク ID の一覧を取得できます。

仮想ネットワーク統合と、関連する Azure リソースを含む関数アプリを作成するには、次の手順を使用します。

1. Azure portal で、メニューまたは [ホーム] ページから [リソースの作成] を選択します。

2. [作業の開始] を選択し、[関数アプリ] で [作成] を選択します。

3. [ホスティング オプションの選択] で、[Flex 従量課金]>[選択] の順に選択します。

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

   設定	提案された値	説明
   サブスクリプション	該当するサブスクリプション	新しい関数アプリを作成するサブスクリプション。
   リソース グループ	myResourceGroup	関数アプリを作成する新しいリソース グループの名前。
   関数アプリ名	グローバルに一意の名前	新しい関数アプリを識別する名前。 有効な文字は、a-z (大文字と小文字の区別をしない)、0-9、および -です。
   リージョン	優先リージョン	自分の近く、または関数がアクセスできる他のサービスの近くのリージョンを選択します。 サポートされていないリージョンは表示されません。 詳細については、「現在サポートされているリージョンを表示する」を参照してください。
   ランタイム スタック	優先言語	サポートされている言語ランタイム スタックのいずれかを選択します。 Web 用 Visual Studio Code を使用したポータル内編集は現在、Node.js、PowerShell、Python アプリでのみ使用できます。 C# クラス ライブラリ、Java の関数はローカルで開発する必要があります。
   Version	Language version (言語バージョン)	サポートされているバージョンの言語ランタイム スタックを選択します。
   インスタンス サイズ	既定値	アプリの各インスタンスに割り当てられるインスタンス メモリの量を決定します。 詳細については、「インスタンス メモリ」を参照してください。

5. 残りのタブの既定のオプション ([ストレージ] タブで新しいストレージ アカウントを作成する既定の動作や、[監視] タブの新しい Application Insights インスタンスなど) は、そのまま受け入れます。既存のストレージ アカウントまたは Application Insights インスタンスを使用することもできます。

6. [ネットワーク] タブで、[パブリック アクセスを有効にする] を [オフ] に、[ネットワーク インジェクションを有効にする] を [オン] に設定します。

7. [仮想ネットワーク] で、アプリと同じリージョンにある仮想ネットワークを選択または作成します。

8. [VNet 統合を有効にする] を [オン] に設定し、サブネットを選択または作成します。

9. [確認と作成] を選択して、選択したアプリ構成を確認してから、[作成] を選択して、仮想ネットワークを含む関数アプリをプロビジョニングおよびデプロイします。

10. ポータルの右上隅の [通知] アイコンを選択し、"デプロイメントに成功しました" というメッセージが表示されるまで待ちます。

11. [リソースに移動] を選択して、新しい関数アプリを確認します。 また、 [ダッシュボードにピン留めする] を選択することもできます。 ピン留めすると、ダッシュボードからこの関数アプリ リソースに戻るのが容易になります。

現在、Visual Studio Code を使用してアプリを作成するときは仮想ネットワークを有効にできません。

既存の関数アプリへの仮想ネットワーク統合を有効にするには、az functionapp vnet-integration add コマンドを使用します。

az functionapp vnet-integration add --resource-group <RESOURCE_GROUP> --name <APP_NAME> --vnet <VNET_RESOURCE_ID> --subnet <SUBNET_NAME>

アプリで仮想ネットワーク統合を無効にするには、az functionapp vnet-integration remove コマンドを使用します。

az functionapp vnet-integration remove --resource-group <RESOURCE_GROUP> --name <APP_NAME>

アプリの現在の仮想ネットワーク統合を一覧表示するには、az functionapp vnet-integration list コマンドを使用します。

az functionapp vnet-integration list --resource-group <RESOURCE_GROUP> --name <APP_NAME>

ポータルで、既存のアプリを既存の仮想ネットワークとサブネットと統合できます。

1. Azure portal の関数アプリ ページで、左側のメニューの [設定] を展開し、[ネットワーク] を選択します。

2. [送信トラフィックの構成] で、[未構成] を選択します。

3. [仮想ネットワーク統合] ページで、[仮想ネットワーク統合を追加する] を選択します。

4. 既存の [仮想ネットワーク] と [サブネット] を選択し、[接続] を選択します。

現在、Visual Studio Code では仮想ネットワークを構成できません。

az functionapp create コマンドを使用し、デプロイ ストレージをカスタマイズする次の追加オプションを指定します。

この例では、別のデプロイ ストレージ アカウントとユーザー割り当て ID を使用して Flex 従量課金プランの関数アプリを作成します。

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime dotnet-isolated --runtime-version 8.0 --flexconsumption-location "<REGION>" --deployment-storage-name <DEPLOYMENT_ACCOUNT_NAME> --deployment-storage-container-name <DEPLOYMENT_CONTAINER_NAME> --deployment-storage-auth-type UserAssignedIdentity --deployment-storage-auth-value <MI_RESOURCE_ID>

現在、Azure portal でアプリを作成するときはデプロイ ストレージを構成できません。 アプリの作成中にデプロイ ストレージを構成するには、代わりに Azure CLI を使用してアプリを作成します。

次のセクションで詳細に説明されているように、ポータルを使用すると、既存のアプリのデプロイ設定を変更できます。

現在、Visual Studio Code を使用して Azure でアプリを作成するときはデプロイ ストレージを構成できません。

デプロイ ストレージ構成を変更するには、az functionapp deployment config set コマンドを使用します。

az functionapp deployment config set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --deployment-storage-name <DEPLOYMENT_ACCOUNT_NAME> --deployment-storage-container-name <DEPLOYMENT_CONTAINER_NAME>

1. Azure portal の関数アプリ ページで、左側のメニューの [設定] を展開し、[デプロイ設定] を選択します。

2. アプリケーション パッケージの場所で、既存のストレージ アカウントを選択してから、そのアカウント内の既存の空のコンテナーを選択します。

3. ストレージ認証で、優先する認証の種類を選択します。

   • [接続文字列] を選択した場合、デプロイ ストレージ アカウントの接続文字列が含まれている設定のアプリ設定の名前を選択します。

   • [ユーザー割り当て ID] を選択した場合、使用する ID を選択します。

4. [保存] を選択してアプリを更新します。

現在、Visual Studio Code を使用して Azure でアプリのデプロイ ストレージを構成することはできません。

az functionapp create コマンドで --instance-memory パラメーターを指定します。 この例では、インスタンス サイズが 4096 の C# アプリを作成します。

az functionapp create --instance-memory 4096 --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime dotnet-isolated --runtime-version 8.0

Azure portal で Flex 従量課金プランのアプリを作成するときは、[基本] タブの [インスタンス サイズ] フィールドでインスタンス メモリ サイズを選択できます。詳細については、「Flex 従量課金アプリを作成する」を参照してください。

現在、Visual Studio Code を使用してアプリを作成するときはインスタンス メモリ サイズを制御できません。 既定のサイズが使用されます。

この例では、az functionapp scale config set コマンドを使用して、インスタンス メモリ サイズの設定を 4,096 MB に変更します。

az functionapp scale config set --resource-group <resourceGroup> --name <APP_NAME> --instance-memory 4096

1. Azure portal の関数アプリ ページで、左側のメニューの [設定] を展開し、[スケールとコンカレンシー] を選択します。

2. [インスタンス メモリ] オプションを選択し、[保存] を選択してアプリを更新します。

現在、Visual Studio Code を使用してアプリのインスタンス メモリ サイズの設定を変更することはできません。

常時使用可能なインスタンスの 1 つ以上の指定を定義するには、az functionapp create コマンドで --always-ready-instances パラメーターを使用します。 この例では、HTTP によってトリガーされるすべての関数の常時使用可能なインスタンス数を 5 に設定します。

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime <LANGUAGE_RUNTIME> --runtime-version <RUNTIME_VERSION> --flexconsumption-location <REGION> --always-ready-instances http=10

この例では、すべての Durable トリガー関数の常時使用可能なインスタンス数を 3 に設定し、function5 という名前の Service Bus によってトリガーされる関数の常時使用可能なインスタンス数を 2 に設定します。

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime <LANGUAGE_RUNTIME> --runtime-version <RUNTIME_VERSION> --flexconsumption-location <REGION> --always-ready-instances durable=3 function:function5=2

現在、Azure portal でアプリを作成するときは常時使用可能なインスタンスを定義できません。 アプリの作成中に常時使用可能なインスタンスを定義するには、代わりに Azure CLI を使用してアプリを作成します。

次のセクションで詳細に説明されているように、ポータルを使用すると、既存のアプリで常時使用可能なインスタンスを変更できます。

現在、Visual Studio Code を使用して Azure でアプリを作成するときは常時使用可能なインスタンスを定義できません。

この例では、az functionapp scale config always-ready set コマンドを使用して、HTTP トリガー グループの常時使用可能なインスタンス数を 10 に変更します。

az functionapp scale config always-ready set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --settings http=10

常時使用可能なインスタンスを削除するには、HTTP トリガー グループと hello_world という名前の関数の両方からすべての常時使用可能なインスタンスを削除する次の例のように、az functionapp scale config always-ready delete コマンドを使用します。

az functionapp scale config always-ready delete --resource-group <RESOURCE_GROUP> --name <APP_NAME> --setting-names http function:hello_world

1. Azure portal の関数アプリ ページで、左側のメニューの [設定] を展開し、[スケールとコンカレンシー] を選択します。

2. [常時使用可能なインスタンスの最小数] で http、blob、durable を入力するか、または function:<FUNCTION_NAME>=n 形式を使用して [トリガー] に特定の関数名を入力し、[常時使用可能なインスタンスの数] を入力します。

3. [保存] を選択してアプリを更新します。

現在、Visual Studio Code を使用して常時使用可能なインスタンスを変更することはできません。

インスタンス サイズには関係なく、アプリの特定の HTTP コンカレンシーの制限を設定するには、az functionapp scale config set コマンドを使用します。

az functionapp scale config set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --trigger-type http --trigger-settings perInstanceConcurrency=10

この例では、HTTP トリガーのコンカレンシー レベルを 10 に設定します。 HTTP コンカレンシーの値を具体的に設定すると、その値は、アプリのインスタンス サイズの設定を変更した場合でも維持されます。

1. Azure portal の関数アプリ ページで、左側のメニューの [設定] を展開し、[スケールとコンカレンシー] を選択します。

2. [インスタンスごとのコンカレンシー] で、[手動で割り当てる] を選択し、特定の制限を入力します。

3. [保存] を選択してアプリを更新します。

現在、Visual Studio Code を使用して HTTP コンカレンシーの制限を設定することはできません。