Azure CLI を使用してワークロードプロファイルを管理する

[アーティクル]
11/15/2023

Azure CLI でワークロードプロファイル環境を管理する方法について説明します。

プロファイルでコンテナーアプリを作成する

既定では、Container Apps 環境は、自動的に生成されるマネージド VNet を使用して作成されます。生成される VNet は、Microsoft のテナント内に作成されるため、ユーザーはアクセスできません。

一方、以下のいずれかの機能が必要な場合は、カスタム VNet を使用して環境を作成できます。

ユーザー定義ルート
Application Gateway との統合
ネットワークセキュリティグループ
仮想ネットワーク内のプライベートエンドポイントの背後にあるリソースとの通信

カスタム VNet を使用して環境を作成するときには、VNet の構成を完全に制御できます。この多大な制御により、以下の機能を実装する選択肢が用意されています。

ユーザー定義ルート
Application Gateway との統合
ネットワークセキュリティグループ
仮想ネットワーク内のプライベートエンドポイントの背後にあるリソースとの通信

以下のコマンドを使用してワークロードプロファイル環境を作成します。

VNet を作成する。

az network vnet create \
  --address-prefixes 13.0.0.0/23 \
  --resource-group "<RESOURCE_GROUP>" \
  --location "<LOCATION>" \
  --name "<VNET_NAME>"

Microsoft.App/environments に委任されるサブネットを作成します。

az network vnet subnet create \
  --address-prefixes 13.0.0.0/23 \
  --delegations Microsoft.App/environments \
  --name "<SUBNET_NAME>" \
  --resource-group "<RESOURCE_GROUP>" \
  --vnet-name "<VNET_NAME>" \
  --query "id"

ID 値をコピーし、次のコマンドに貼り付けます。

Container Apps ランタイムに、Container Apps 環境でワークロードプロファイルを実行するために必要な VNet に対する制御を付与するには、Microsoft.App/environments の委任が必要です。

サブネットには、/27 CIDR (32 IP - 8 個が予約済み) のように小さな値を指定できます。 /27 CIDR を指定する場合は、以下の点を考慮に入れてください。

Container Apps インフラストラクチャ用に予約されている IP アドレスが 11 個あります。そのため、/27 CIDR には使用可能な IP アドレスが最大 21 個あります。

IP アドレスの割り当ては、従量課金プランと専用プランでは異なる方法で行われます。

消費量のみ	専用
すべてのレプリカに 1 つの IP が必要です。ユーザーは、アプリ全体で 21 個より多いレプリカを使用するアプリを持つことができません。ダウンタイムなしのデプロイでは、新しいリビジョンが正常にデプロイされるまで古いリビジョンが実行中であるため、2 倍の IP が必要です。	すべてのインスタンス (VM ノード) に必要なのは 1 つの IP です。すべてのワークロードプロファイルで最大 21 個のインスタンスを使用でき、これらのワークロードプロファイルでは数百個以上のレプリカを実行できます。

"ワークロードプロファイル" 環境を作成します

Note

コンテナーアプリで、パブリックイングレスを許可するか、環境レベルで VNet 内からのイングレスのみを許可するかを構成できます。お使いの VNet のみにイングレスを制限するには、--internal-only フラグを設定します。

外部環境
内部環境

az containerapp env create \
  --enable-workload-profiles \
  --resource-group "<RESOURCE_GROUP>" \
  --name "<NAME>" \
  --location "<LOCATION>"

az containerapp env create \
  --enable-workload-profiles \
  --resource-group "<RESOURCE_GROUP>" \
  --name "<NAME>" \
  --location "<LOCATION>" \
  --infrastructure-subnet-resource-id "<SUBNET_ID>" \
  --internal-only true

az containerapp env create \
  --enable-workload-profiles \
  --resource-group "<RESOURCE_GROUP>" \
  --name "<NAME>" \
  --location "<LOCATION>"

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

お使いの環境の状態を確認します。次のコマンドでは、環境が正常に作成されているかどうかが報告されます。
```
az containerapp env show \
  --name "<ENVIRONMENT_NAME>" \
  --resource-group "<RESOURCE_GROUP>"
```
provisioningState は、次のコマンドに進む前に Succeeded を報告する必要があります。

新しいコンテナーアプリを作成します。

外部環境
内部環境

az containerapp create \
  --resource-group "<RESOURCE_GROUP>" \
  --name "<CONTAINER_APP_NAME>" \
  --target-port 80 \
  --ingress external \
  --image mcr.microsoft.com/k8se/quickstart:latest \
  --environment "<ENVIRONMENT_NAME>" \
  --workload-profile-name "Consumption"

az containerapp create \
  --resource-group "<RESOURCE_GROUP>" \
  --name "<CONTAINER_APP_NAME>" \
  --target-port 80 \
  --ingress internal \
  --image mcr.microsoft.com/k8se/quickstart:latest \
  --environment "<ENVIRONMENT_NAME>" \
  --workload-profile-name "Consumption"

このコマンドは、組み込みの従量課金ワークロードプロファイルにアプリケーションをデプロイします。専用プロファイルでアプリを作成する場合は、まず、環境にプロファイルを追加する必要があります。

このコマンドでは、特定のワークロードプロファイルを使用して、環境内に新しいアプリケーションを作成します。

プロファイルを追加する

既存の環境に新しいワークロードプロファイルを追加します。

az containerapp env workload-profile add \
  --resource-group <RESOURCE_GROUP> \
  --name <ENVIRONMENT_NAME> \
  --workload-profile-type <WORKLOAD_PROFILE_TYPE> \
  --workload-profile-name <WORKLOAD_PROFILE_NAME> \
  --min-nodes <MIN_NODES> \
  --max-nodes <MAX_NODES>

<WORKLOAD_PROFILE_NAME> プレースホルダーに選択する値は、ワークロードプロファイルの "フレンドリ名" です。

フレンドリ名を使用すると、同じ種類の複数のプロファイルを環境に追加できます。フレンドリ名は、ワークロードプロファイルでコンテナーアプリのデプロイと管理を行うときに使用する名前です。

プロファイルの編集

update コマンドを介して、ワークロードプロファイルによって使用されるノードの最小数と最大数を変更できます。

az containerapp env workload-profile update \
  --resource-group <RESOURCE_GROUP> \
  --name <ENV_NAME> \
  --workload-profile-type <WORKLOAD_PROFILE_TYPE> \
  --workload-profile-name <WORKLOAD_PROFILE_NAME> \
  --min-nodes <MIN_NODES> \
  --max-nodes <MAX_NODES>

プロファイルを削除

次のコマンドを使用してワークロードプロファイルを削除します。

az containerapp env workload-profile delete \
  --resource-group "<RESOURCE_GROUP>" \
  --name <ENVIRONMENT_NAME> \
  --workload-profile-name <WORKLOAD_PROFILE_NAME>

Note

"従量課金" ワークロードプロファイルは削除できません。

プロファイルを検査する

次のコマンドでは、ユーザーのリージョンで使用可能なプロファイルと、特定の環境で使用されているプロファイルを一覧表示できます。

使用可能なワークロードプロファイルを一覧表示する

list-supported コマンドを使用して、ユーザーのリージョンでサポートされているワークロードプロファイルを一覧表示します。

次の Azure CLI コマンドでは、結果が表で表示されます。

az containerapp env workload-profile list-supported \
  --location <LOCATION>  \
  --query "[].{Name: name, Cores: properties.cores, MemoryGiB: properties.memoryGiB, Category: properties.category}" \
  -o table

応答は、下の例のような表に似ています。

Name         Cores    MemoryGiB    Category
-----------  -------  -----------  ---------------
D4           4        16           GeneralPurpose
D8           8        32           GeneralPurpose
D16          16       64           GeneralPurpose
E4           4        32           MemoryOptimized
E8           8        64           MemoryOptimized
E16          16       128          MemoryOptimized
E32          32       256          MemoryOptimized
Consumption  4        8            Consumption

az containerapp env workload-profile set を実行するときの --workload-profile-type オプションについては、ワークロードプロファイルを選択し、その Name フィールドを使用します。

ワークロードプロファイルを表示する

ワークロードプロファイルに関する詳細を表示します。

az containerapp env workload-profile show \
  --resource-group <RESOURCE_GROUP> \
  --name <ENVIRONMENT_NAME> \
  --workload-profile-name <WORKLOAD_PROFILE_NAME>

次のステップ

ワークロードプロファイルプレビュー

Azure CLI を使用してワークロード プロファイルを管理する

プロファイルでコンテナー アプリを作成する