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

この記事では、Linux コンテナーで実行されている関数アプリを作成し、コンテナー レジストリから Azure Container Apps 環境にデプロイします。 Container Apps にデプロイすると、関数アプリをクラウドネイティブなマイクロサービスに統合できます。 詳細については、「Azure Functions の Azure Container Apps ホスティング」を参照してください。

この記事では、Linux コンテナーで実行されている関数を作成し、コンテナーを Container Apps 環境にデプロイする方法について説明します。

このクイックスタートを完了すると、お使いの Azure アカウントで数米国ドル以下の少量のコストが発生します。このコストは、完了時にリソースをクリーンアップすることによって最小限に抑えることができます。

開発言語を選択する

まず、Azure Functions ツールで、言語固有の Linux 基本イメージを使用して、Docker コンテナーに関数アプリとしてプロジェクト コードを作成します。 記事の冒頭で言語を必ず選択してください。

Core Tools では、お使いの関数言語の正しい基本イメージの最新バージョンを使用するプロジェクトの Dockerfile が自動的に生成されます。 最新の基本イメージからコンテナーを定期的に更新し、コンテナーの更新されたバージョンから再デプロイする必要があります。 詳細については、「コンテナー化された関数アプリの作成」を参照してください。

前提条件

操作を始める前に、以下の要件を満たしておく必要があります。

• Azure CLI バージョン 2.4 以降のバージョン。

Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。

作成したコンテナー化された関数アプリ イメージをコンテナー レジストリにを発行するには、Docker ID とローカル コンピューターで実行されている Docker が必要です。 Docker ID がない場合は、Docker アカウントを作成することができます。

python -m venv .venv

source .venv/bin/activate

sudo apt-get install python3-venv

py -m venv .venv

.venv\scripts\activate

py -m venv .venv

.venv\scripts\activate

ローカル関数プロジェクトを作成してテストする

func init --worker-runtime dotnet-isolated --docker

func init --worker-runtime node --language javascript --docker

func init --worker-runtime powershell --docker

func init --worker-runtime python --docker

func init --worker-runtime node --language typescript --docker

mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=8 -Ddocker

mvn archetype:generate "-DarchetypeGroupId=com.microsoft.azure" "-DarchetypeArtifactId=azure-functions-archetype" "-DjavaVersion=8" "-Ddocker"

mvn archetype:generate "-DarchetypeGroupId=com.microsoft.azure" "-DarchetypeArtifactId=azure-functions-archetype" "-DjavaVersion=8" "-Ddocker"

--docker オプションによって、プロジェクトの Dockerfile が生成されます。これにより、Azure Functions および選択されたランタイムで使用するための適切なコンテナーが定義されます。

cd fabrikam-functions

func new --name HttpExample --template "HTTP trigger"

func new --name HttpExample --template "HTTP trigger"

関数をローカルでテストするために、プロジェクト フォルダーのルートでローカルの Azure Functions ランタイム ホストを起動します。

func start  

func start  

npm install
npm start

mvn clean package  
mvn azure-functions:run

Ctrl+C (macOS の場合は Command+C) キーを押してホストを停止します。

コンテナー イメージを作成してローカルで検証する

ルート プロジェクト フォルダーで、docker build コマンドを実行し、名前に azurefunctionsimage、タグに v1.0.0 を指定します。 <DOCKER_ID> を Docker Hub アカウント ID で置換します。 このコマンドでは、コンテナーの Docker イメージがビルドされます。

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

コマンドが完了すると、新しいコンテナーをローカルで実行できます。

ビルドを検証するために、ローカル コンテナーで docker run コマンドを使用してイメージを実行します。この場合も、<DOCKER_ID> は実際の Docker Hub アカウント ID に置き換え、ポート引数として -p 8080:80 を追加してください。

docker run -p 8080:80 -it <DOCKER_ID>/azurefunctionsimage:v1.0.0

コンテナーで関数アプリを検証したら、Ctrl+C (macOS の場合は Command+C) キーを押して実行を停止します。

コンテナー イメージをレジストリに発行する

コンテナー イメージをホスティング環境にデプロイできるようにするには、コンテナー レジストリにプッシュする必要があります。

関数用の関連 Azure リソースを作成する

コンテナーを Azure にデプロイする前に、3 つのリソースを作成する必要があります。

• リソース グループ。関連リソースの論理コンテナーです。
• ストレージ アカウント。関数についての情報 (状態など) を維持する目的で使用されます。
• Azure Container Apps 環境と Log Analytics ワークスペース。

以下のコマンドを使用してこれらの項目を作成します。

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

   az login コマンドで Azure アカウントにサインインします。 アカウントに複数のサブスクリプションが関連付けられている場合は az account set を使用します。

2. 次のコマンドを実行して、Azure CLI を最新バージョンに更新します。

   az upgrade
   

   Azure CLI のバージョンが最新でない場合はインストールが開始されます。 アップグレードの方法は、お使いのオペレーティング システムによって異なります。 アップグレードの完了後に続行できます。

3. 次のコマンドを実行して、Azure Container Apps 拡張機能をアップグレードし、Container Apps に必要な名前空間を登録します。

   az extension add --name containerapp --upgrade -y
   az provider register --namespace Microsoft.Web 
   az provider register --namespace Microsoft.App 
   az provider register --namespace Microsoft.OperationalInsights 
   

4. AzureFunctionsContainers-rg という名前のリソース グループを作成します。

   az group create --name AzureFunctionsContainers-rg --location eastus
   

   この az group create コマンドは、リソース グループを米国東部リージョンに作成します。 代わりに自分の近くのリージョンを使用する場合は、az account list-locations コマンドから返された使用可能なリージョン コードを使用します。 eastus の代わりにカスタム リージョンを使用するように、後続のコマンドを変更する必要があります。

5. ワークロード プロファイルを有効にして Azure Container App 環境を作成します。

   az containerapp env create --name MyContainerappEnvironment --enable-workload-profiles --resource-group AzureFunctionsContainers-rg --location eastus
   

   このコマンドが完了するまでに最大で 10 分かかります。

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

   az storage account create --name <STORAGE_NAME> --location eastus --resource-group AzureFunctionsContainers-rg --sku Standard_LRS
   

   az storage account create コマンドでストレージ アカウントを作成します。

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

7. 先に進む前に、このコマンドを使って環境の準備ができていることを確認します。

   az containerapp env show -n MyContainerappEnvironment -g AzureFunctionsContainers-rg
   

イメージを使用して Azure 上の関数アプリを作成、構成する

Azure 上の関数アプリでは、Azure Container Apps 環境で関数の実行を管理します。 このセクションでは、前のセクションの Azure リソースを使用して、Container Apps 環境のコンテナー レジストリ内のイメージから関数アプリを作成します。 また、必要な Azure Storage アカウントに、接続文字列を使用して新しい環境を構成します。

az functionapp create コマンドを使用して、Azure Container Apps でサポートされる新しいマネージド環境に関数アプリを作成します。

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime dotnet-isolated --image <LOGIN_SERVER>/azurefunctionsimage:v1.0.0 --registry-server <LOGIN_SERVER> --registry-username <REGISTRY_NAME> --registry-password <ADMIN_PASSWORD> 

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime node --image <LOGIN_SERVER>/azurefunctionsimage:v1.0.0 --registry-server <LOGIN_SERVER> --registry-username <REGISTRY_NAME> --registry-password <ADMIN_PASSWORD> 

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime java --image <LOGIN_SERVER>/azurefunctionsimage:v1.0.0 --registry-server <LOGIN_SERVER> --registry-username <REGISTRY_NAME> --registry-password <ADMIN_PASSWORD> 

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime powershell --image <LOGIN_SERVER>/azurefunctionsimage:v1.0.0 --registry-server <LOGIN_SERVER> --registry-username <REGISTRY_NAME> --registry-password <ADMIN_PASSWORD> 

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime python --image <LOGIN_SERVER>/azurefunctionsimage:v1.0.0 --registry-server <LOGIN_SERVER> --registry-username <REGISTRY_NAME> --registry-password <ADMIN_PASSWORD> 

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime node --image <LOGIN_SERVER>/azurefunctionsimage:v1.0.0 --registry-server <LOGIN_SERVER> --registry-username <REGISTRY_NAME> --registry-password <ADMIN_PASSWORD> 

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime dotnet-isolated --image <DOCKER_ID>/azurefunctionsimage:v1.0.0 

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime node --image <DOCKER_ID>/azurefunctionsimage:v1.0.0

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime java --image <DOCKER_ID>/azurefunctionsimage:v1.0.0

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime powershell --image <DOCKER_ID>/azurefunctionsimage:v1.0.0

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime python --image <DOCKER_ID>/azurefunctionsimage:v1.0.0

az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --environment MyContainerappEnvironment --resource-group AzureFunctionsContainers-rg --functions-version 4 --runtime node --image <DOCKER_ID>/azurefunctionsimage:v1.0.0

--workload-profile-name "Consumption" を指定すると、既定の Consumption ワークロード プロファイルを使う環境にアプリが作成されます。これには、Container Apps 従量課金プランで実行する場合と同じコストがかかります。 関数アプリを初めて作成すると、レジストリから最初のイメージがプルされます。

この時点で、関数は Container Apps 環境で実行されており、必要なアプリケーション設定が既に追加されています。 必要に応じて、Azure Functions の標準の方法で関数アプリに他の設定を追加できます。 詳細については、アプリケーション設定の使用に関する記事を参照してください。

Azure 上で関数を確認する

イメージを Azure の関数アプリにデプロイしたら、HTTP 要求を通じて関数を呼び出すことができます。

1. 次の az functionapp function show コマンドを実行し、新しい関数の URL を取得します。

   az functionapp function show --resource-group AzureFunctionsContainers-rg --name <APP_NAME> --function-name HttpExample --query invokeUrlTemplate 
   

   <APP_NAME> をお使いの関数アプリの名前に置き換えます。

この URL にアクセスすると、この関数をローカルで実行したときと同様の出力がブラウザーに表示されるはずです。

要求の URL は次のようになります。

リソースをクリーンアップする

この記事で作成したリソースを使用して、引き続き Azure 関数に取り組む場合は、それらのリソースをすべてそのままにしてかまいません。

この関数アプリのデプロイの作業が完了したら、AzureFunctionsContainers-rg リソース グループを削除して、そのグループ内のすべてのリソースをクリーンアップします。

az group delete --name AzureFunctionsContainers-rg

次の手順