コンテナーと Azure Functions を使用する

この記事では、Azure Container Apps 環境で実行されている関数アプリを操作するために Azure Functions が提供するサポートについて説明します。 詳細については、「Azure Functions の Azure Container Apps ホスティング」を参照してください。

この記事では、Linux コンテナーで実行されている関数アプリを操作するために Azure Functions が提供するサポートについて説明します。

Azure Container Apps で最初のコンテナ化された Azure Functions を作成する

Azure Container Apps へのデプロイの詳細については、Azure Functions の Azure Container Apps ホスティングに関するページを参照してください。

コンテナ化された最初の Azure Functions を作成する

Azure Arc でコンテナ化された最初の Azure Functions を作成する (プレビュー)

継続的デプロイを有効にすることも検討する必要があります。

コンテナーを使用した Azure portal での作成

Azure portal で関数アプリを作成するときに、コンテナー レジストリ内のイメージから関数アプリをデプロイすることを選択できます。 コンテナー レジストリでコンテナー化された関数アプリを作成する方法については、「コンテナーでの関数アプリを作成する」を参照してください。

次の手順では、コンテナー レジストリから既存のコンテナー化された関数アプリを作成してデプロイします。

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

2. [新規] ページで、 [計算]>、 [関数アプリ] の順に選択します。

3. [ホスティング オプションの選択] で、[Premium プラン]>[選択] を選択します。

   これにより、動的スケーリングをサポートする Premium プランで Azure Functions によってホストされる関数アプリが作成されます。 App Service プランで実行することもできますが、このような専用プランでは、関数アプリのスケーリングを管理する必要があります。

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

   設定	提案された値	説明
   サブスクリプション	該当するサブスクリプション	関数アプリを作成するサブスクリプション。
   リソース グループ	myResourceGroup	関数アプリを作成する新しいリソース グループの名前。 既存のリソース グループに新しい関数アプリを作成するときの既知の制限があるため、リソース グループを作成する必要があります。
   関数アプリ名	一意の名前*	新しい関数アプリを識別する名前。 有効な文字は、a-z (大文字と小文字の区別をしない)、0-9、および -です。
   コードまたはコンテナー イメージをデプロイしますか?	コンテナー イメージ	レジストリからコンテナー化された関数アプリをデプロイします。 レジストリで関数アプリを作成するには、ローカル コンテナーでの関数アプリの作成に関する記事を参照してください。
   リージョン	優先リージョン	自分の近く、または関数がアクセスできる他のサービスの近くのリージョンを選択します。
   Linux プラン	新しいプラン (既定)	アプリをホストする新しい Premium プランを作成します。 既存の Premium プランを選択することもできます。
   料金プラン	エラスティック Premium EP1	EP1 は最もリーズナブルなプランです。 必要に応じて、より大きなプランを選択できます。
   ゾーン冗長性	無効	非運用アプリでは、この機能は必要ありません。

   ^*アプリ名は、Azure Functions でホストされているすべてのアプリ間でグローバルに一意である必要があります。

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

6. [確認および作成] を選択して、アプリ構成の選択内容を確認します。

7. [確認と作成] ページで設定を確認した後、[作成] を選択して、既定の基本イメージを使用して関数アプリをプロビジョニングします。

8. 関数アプリ リソースが作成されたら、[リソースに移動] を選択し、関数アプリ ページで [デプロイ センター] を選択します。

9. [デプロイ センター] で、イメージのソースとしてコンテナー レジストリを接続できます。 また、レジストリ内のコンテナーへの更新プログラムのより堅牢な継続的デプロイのために、GitHub Actions または Azure Pipelines を有効にすることもできます。

コンテナーを使用した Azure portal での作成

Azure portal で Container Apps でホストされた関数アプリを作成するときに、コンテナー レジストリ内のイメージから関数アプリをデプロイすることを選択できます。 コンテナー レジストリでコンテナー化された関数アプリを作成する方法については、「コンテナーでの関数アプリを作成する」を参照してください。

次の手順では、コンテナー レジストリから既存のコンテナー化された関数アプリを作成してデプロイします。

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

2. [新規] ページで、 [計算]>、 [関数アプリ] の順に選択します。

3. [ホスティング オプションの選択] で、[Container Apps 環境]>[選択] を選択します。

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

   設定	提案された値	説明
   サブスクリプション	該当するサブスクリプション	関数アプリを作成するサブスクリプション。
   リソース グループ	myResourceGroup	関数アプリを作成する新しいリソース グループの名前。 既存のリソース グループに新しい関数アプリを作成するときの既知の制限があるため、リソース グループを作成する必要があります。
   関数アプリ名	一意の名前*	新しい関数アプリを識別する名前。 有効な文字は、a-z (大文字と小文字の区別をしない)、0-9、および -です。
   リージョン	優先リージョン	自分の近く、または関数がアクセスできる他のサービスの近くのリージョンを選択します。

   ^*アプリ名は、Azure Container Apps 環境内で一意である必要があります。

5. 引き続き 基本 ページで、Azure Container Apps 環境で推奨される新しい環境を受け入れます。 コストを最小限に抑えるために、新しい既定の環境は、既定のワークロード プロファイルとゾーン冗長性のない 従量課金 + 専用 に作成されます。 詳細については、「Azure Functions の Azure Container Apps ホスティング」を参照してください。

   既存の Container Apps 環境の使用を選択することもできます。 カスタム環境を作成するには、[新規作成] を選択します。 [Container Apps 環境の作成] ページでは、既定以外のワークロード プロファイルを追加したり、ゾーン冗長を有効にしたりできます。 環境の詳細については、「Azure Container Apps 環境」 を参照してください。

6. [デプロイ] タブを選択し、[クイックスタート イメージを使用する] の選択を解除します。 それ以外の場合、関数アプリは関数アプリ言語の基本イメージからデプロイされます。

7. [イメージの種類] としてパブリックまたはプライベートを選択します。 Azure Container Registryまたはその他のプライベート レジストリを使用している場合は、[プライベート] を選択します。 レジストリ プレフィックスを含む [イメージ] 名を指定します。 プライベート レジストリを使用している場合は、イメージ レジストリの認証資格情報を指定します。 [公開用] 設定では、Docker Hub に公開に格納されているイメージのみがサポートされます。

8. [コンテナー リソース割り当て] で、目的の CPU コア数と使用可能なメモリを選択します。 環境に他のワークロード プロファイルが追加されている場合は、既定以外のワークロード プロファイルを選択できます。 このページの選択肢は、アプリのホスティングのコストに影響します。 潜在的なコストを見積もるには Container Apps の価格ページを参照してください。

9. [確認および作成] を選択して、アプリ構成の選択内容を確認します。

10. [確認と作成] ページで設定を確認し、[作成] を選択して関数アプリをプロビジョニングし、レジストリからコンテナー イメージをデプロイします。

Container Apps のワークロード プロファイル

ワークロード プロファイルは、デプロイ リソースをより適切に制御できるようにする Container Apps の機能です。 また、Azure Container Apps 上の Azure Functions でもワークロード プロファイルがサポートされています。 詳細については、「Azure Container Apps のワークロード プロファイル」を参照してください。

アプリに割り当てられる CPU およびメモリ リソースの量を設定することもできます。

ワークロード プロファイルとリソース割り当ては、両方とも Azure CLI を使用して、または Azure portal で作成および管理できます。

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime <LANGUAGE_STACK> --image <IMAGE_URI> --workload-profile-name <PROFILE_NAME> --cpu <CPU_COUNT> --memory <MEMORY_SIZE> 

az functionapp container set --name <APP_NAME> --resource-group AzureFunctionsContainers-rg --workload-profile-name  <PROFILE_NAME> --cpu <CPU_COUNT> --memory <MEMORY_SIZE> 

Azure への継続的デプロイを有効にする

Azure Container Apps でコンテナー化された関数アプリをホストする場合、ソース コード リポジトリから継続的デプロイを設定する方法は 2 つあります:

• Azure Pipelines
• GitHub のアクション

現在、コンテナー レジストリのイメージの変更に基づいてコンテナーを継続的にデプロイすることはできません。 代わりに、これらのソース コード ベースの継続的デプロイ パイプラインを使用する必要があります。

Azure への継続的デプロイを有効にする

レジストリ内のイメージを更新するたびに、イメージのデプロイを Azure Functions に自動的に更新させることができます。

1. 次のコマンドを使用して継続的デプロイを有効にし、Webhook URL を取得します。

   • Azure CLI
   • Azure PowerShell

   az functionapp deployment container config --enable-cd --query CI_CD_URL --output tsv --name <APP_NAME> --resource-group AzureFunctionsContainers-rg
   

   az functionapp deployment container config コマンドは、継続的デプロイを有効にして、デプロイの Webhook URL を返します。 この URL は、後から az functionapp deployment container show-cd-url コマンドを使用していつでも取得できます。

   これまでと同様に、<APP_NAME> をお使いの関数アプリ名に置き換えます。

2. デプロイの Webhook URL をクリップボードにコピーします。

3. [Docker Hub] を開いてサインインし、ナビゲーション バーの [リポジトリ] を選択します。 イメージを検索して選択し、[Webhooks] タブを選択します。次に、Webhook の名前を指定して、[Webhook URL] に URL を貼り付け、[作成] を選択します。

   

4. Webhook の設定後は、Docker Hub でイメージを更新するたびに、それが Azure Functions によって再デプロイされます。

SSH 接続を有効にする

SSH では、コンテナーとクライアント間の通信をセキュリティで保護できます。 SSH が有効になっている場合は、App Service Advanced Tools (Kudu) を使用してコンテナーに接続できます。 SSH を使用してコンテナーに簡単に接続できるように、Azure Functions には、SSH が既に有効になっている基本イメージが用意されています。 必要な作業は、Dockerfile を編集してから、イメージをリビルドして再デプロイするだけです。 その後、[高度なツール (Kudu)] を使用してコンテナーに接続することができます。

1. Dockerfile で、次の例に示すように、FROM 命令の基本イメージに文字列 -appservice を追加します。

   FROM mcr.microsoft.com/azure-functions/node:4-node18-appservice
   

   この例では、Node.js バージョン 18 の基本イメージの SSH 対応バージョンを使用します。 Azure Functions 基本イメージ リポジトリにアクセスして、SSH 対応の基本イメージを最新バージョンで使用していることを確認します。

2. docker build コマンドを使用してイメージをリビルドします。次の例に示すように、<DOCKER_ID> は、実際の Docker Hub アカウント ID に置き換えてください。

   docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .
   

3. 更新済みのイメージを Docker Hub にプッシュします。初回プッシュ時よりもはるかに短時間で済みます。 イメージの更新されたセグメントのみを今すぐアップロードする必要があります。

   docker push <DOCKER_ID>/azurefunctionsimage:v1.0.0
   

4. Azure Functions によってイメージが自動的に関数アプリに再デプロイされます。この処理の所要時間は 1 分未満です。

5. ブラウザーで https://<app_name>.scm.azurewebsites.net/ を開きます。<app_name> は、一意の名前に置き換えてください。 この URL は、関数アプリ コンテナーの [高度なツール (Kudu)] エンドポイントです。

6. 自分の Azure アカウントにサインインし、 [SSH] を選択して、コンテナーとの接続を確立します。 Azure によるコンテナー イメージの更新がまだ行われている場合、接続に少し時間がかかる場合があります。

7. コンテナーとの接続が確立されたら、top コマンドを実行して、現在実行中のプロセスを表示します。