コンテナーとAzure Functionsを操作する

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

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

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

Azure Container Appsへのデプロイの詳細については、Azure Container Apps Azure Functions。

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

コンテナーと Azure Functions を使用した作業

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

Azure portalを使用してコンテナー化された関数アプリを作成する

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

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

1. Azure portal メニューまたは Home ページで、リソースの作成を選択します。

2. [ 新規 ] ページで、[ Web>Function App] を選択します。

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

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

4. [ 基本 ] ページで、次の表に示すように関数アプリの設定を使用します。

   Setting	推奨値	Description
   Subscription	あなたのサブスクリプション	関数アプリを作成するサブスクリプション。
   Resource Group	myResourceGroup	関数アプリを作成する新しいリソース グループの名前。 既存のリソース グループに新しい関数アプリを作成するときの既知の制限があるため、リソース グループを作成する必要があります。
   関数アプリ名	アプリ名	新しい関数アプリを識別する名前。 有効な文字は、a-z (大文字と小文字の区別をしない)、0-9、および -です。
   安全な一意かつ既定のホスト名	Enabled	アプリ名に関係なく、ドメイン名の競合を心配する必要がないように、この機能を有効にします。
   コードまたはコンテナー イメージをデプロイしますか?	コンテナー イメージ	レジストリからコンテナー化された関数アプリをデプロイします。 レジストリで関数アプリを作成するには、「 ローカル Linux コンテナーに関数アプリを作成する」を参照してください。
   Region	優先リージョン	あなたや、関数がアクセスできる他のサービスに近い region を選択します。
   Linux プラン	新しいプラン (既定)	アプリをホストする新しい Premium プランを作成します。 既存の Premium プランを選択することもできます。
   料金プラン	エラスティックプレミアム EP1	EP1 は最もリーズナブルなプランです。 必要に応じて、より大きなプランを選択できます。
   ゾーン冗長性	Disabled	非運用アプリでは、この機能は必要ありません。

5. Storage タブで新しいstorage アカウントを作成し、Monitoring タブに新しい Application Insight インスタンスを作成する既定のオプションをそのまま使用します。既存のstorage アカウントまたは Application Insights インスタンスを使用することもできます。

6. Review + create を選択して、app configurationの選択内容を確認します。

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

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

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

Azure portalを使用してコンテナー化された関数アプリを作成する

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

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

1. Azure portal メニューまたは Home ページで、リソースの作成を選択します。

2. [ 新規 ] ページで、[ Web>Function App] を選択します。

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

4. [ 基本 ] ページで、次の表に示すように関数アプリの設定を使用します。

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

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

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

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

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

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

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

9. Review + create を選択して、app configurationの選択内容を確認します。

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

コンテナー アプリのワークロード プロファイルを使用する

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

アプリに割り当てられる 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 Actions

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

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

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

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

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

Update-AzFunctionAppSetting -Name <APP_NAME> -ResourceGroupName AzureFunctionsContainers-rg -AppSetting @{"DOCKER_ENABLE_CI" = "true"}
Get-AzWebAppContainerContinuousDeploymentUrl -Name <APP_NAME> -ResourceGroupName AzureFunctionsContainers-rg

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

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

2. Docker Hub を開き、サインインし、ナビゲーション バーの Repositories を選択します。 イメージを見つけて選択し、[ Webhook ] タブを選択し、 Webhook 名を指定して、 Webhook URL に URL を貼り付けて、[ 作成] を選択します。

   

3. webhookを設定すると、Azure FunctionsがDocker Hub でイメージを更新するたびにイメージを再デプロイします。

SSH 接続を有効にする

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

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

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

   この例では、Node.js バージョン 18 の基本イメージの SSH 対応バージョンを使用します。 Azure Functions基本イメージ repos にアクセスして、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. Azure portalで、関数アプリを見つけます。 左側のメニューで、 開発ツール>SSH を選択します。 [Go] \(移動) を選択します。 Azureがまだコンテナー イメージを更新している場合は、接続にしばらく時間がかかる場合があります。

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