次の方法で共有


Microsoft.App containerApps 2022-03-01

Bicep リソース定義

containerApps リソースの種類は、次を対象とする操作と共にデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.App/containerApps リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.App/containerApps@2022-03-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    configuration: {
      activeRevisionsMode: 'string'
      dapr: {
        appId: 'string'
        appPort: int
        appProtocol: 'string'
        enabled: bool
      }
      ingress: {
        allowInsecure: bool
        customDomains: [
          {
            bindingType: 'string'
            certificateId: 'string'
            name: 'string'
          }
        ]
        external: bool
        targetPort: int
        traffic: [
          {
            label: 'string'
            latestRevision: bool
            revisionName: 'string'
            weight: int
          }
        ]
        transport: 'string'
      }
      registries: [
        {
          identity: 'string'
          passwordSecretRef: 'string'
          server: 'string'
          username: 'string'
        }
      ]
      secrets: [
        {
          name: 'string'
          value: 'string'
        }
      ]
    }
    managedEnvironmentId: 'string'
    template: {
      containers: [
        {
          args: [
            'string'
          ]
          command: [
            'string'
          ]
          env: [
            {
              name: 'string'
              secretRef: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          name: 'string'
          probes: [
            {
              failureThreshold: int
              httpGet: {
                host: 'string'
                httpHeaders: [
                  {
                    name: 'string'
                    value: 'string'
                  }
                ]
                path: 'string'
                port: int
                scheme: 'string'
              }
              initialDelaySeconds: int
              periodSeconds: int
              successThreshold: int
              tcpSocket: {
                host: 'string'
                port: int
              }
              terminationGracePeriodSeconds: int
              timeoutSeconds: int
              type: 'string'
            }
          ]
          resources: {
            cpu: json('decimal-as-string')
            memory: 'string'
          }
          volumeMounts: [
            {
              mountPath: 'string'
              volumeName: 'string'
            }
          ]
        }
      ]
      revisionSuffix: 'string'
      scale: {
        maxReplicas: int
        minReplicas: int
        rules: [
          {
            azureQueue: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              queueLength: int
              queueName: 'string'
            }
            custom: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              metadata: {
                {customized property}: 'string'
              }
              type: 'string'
            }
            http: {
              auth: [
                {
                  secretRef: 'string'
                  triggerParameter: 'string'
                }
              ]
              metadata: {
                {customized property}: 'string'
              }
            }
            name: 'string'
          }
        ]
      }
      volumes: [
        {
          name: 'string'
          storageName: 'string'
          storageType: 'string'
        }
      ]
    }
  }
}

プロパティ値

containerApps

名前 形容 価値
名前 リソース名 string (必須)

文字数制限: 2 から 32

有効な文字:
小文字、数字、ハイフン。.

文字で始まり、英数字で終わる。
場所 リソースが存在する地理的な場所 string (必須)
タグ リソース タグ。 タグ名と値のディクショナリ。 テンプレート の タグを参照してください
同一性 コード内のシークレットや資格情報を維持することなく、他の Azure サービスと対話するための Container App のマネージド ID。 ManagedServiceIdentity の
プロパティ ContainerApp リソース固有のプロパティ ContainerAppProperties

ManagedServiceIdentity

名前 形容 価値
種類 マネージド サービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (必須)
userAssignedIdentities リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリ キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。 ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。 UserAssignedIdentities の

UserAssignedIdentities

名前 形容 価値
{カスタマイズされたプロパティ} UserAssignedIdentity の

UserAssignedIdentity

このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

ContainerAppProperties

名前 形容 価値
構成 バージョン管理されていない Container App 構成プロパティ。 構成
managedEnvironmentId コンテナー アプリの環境のリソース ID。
テンプレート コンテナー アプリのバージョン管理されたアプリケーション定義。 テンプレートの

構成

名前 形容 価値
activeRevisionsMode ActiveRevisionsMode は、コンテナー アプリのアクティブなリビジョンの処理方法を制御します。
{list}{item}複数: 複数のリビジョンをアクティブにすることができます。{/item}{item}単一: 一度にアクティブにできるリビジョンは 1 つだけです。 リビジョンの重みは、このモードでは使用できません。 値が指定されていない場合は、これが既定値です。{/item}{/list}
'Multiple'
'Single'
dapr コンテナー アプリの Dapr 構成。 Dapr
イングレス イングレス構成。 イングレス
レジストリ コンテナー アプリによって使用されるコンテナーのプライベート コンテナー レジストリ資格情報のコレクション RegistryCredentials[]
秘密 コンテナー アプリによって使用されるシークレットのコレクション シークレット[]

Dapr

名前 形容 価値
appId Dapr アプリケーション識別子
appPort アプリケーションがリッスンしているポートを Dapr に通知します int
appProtocol アプリケーションが使用しているプロトコルを Dapr に通知します。 有効なオプションは http と grpc です。 既定値は http です 'grpc'
'http'
有効 Dapr 側の車が有効かどうかを示すブール値 bool

イングレス

名前 形容 価値
allowInsecure HTTP 接続が許可されているかどうかを示すブール値。 false に設定されている場合、HTTPS 接続に自動的にリダイレクトされます bool
customDomains Container Apps のホスト名のカスタム ドメイン バインド。 CustomDomain[]
アプリが外部 http エンドポイントを公開するかどうかを示すブール値 bool
targetPort イングレスからのトラフィックのコンテナー内のターゲット ポート int
交通 アプリのリビジョンのトラフィックの重み付け TrafficWeight[]
輸送 イングレス トランスポート プロトコル 'auto'
'http'
'http2'

CustomDomain

名前 形容 価値
bindingType カスタム ドメイン バインドの種類。 'Disabled'
'SniEnabled'
certificateId このホスト名にバインドする証明書のリソース ID。
名前 ホスト名。 string (必須)

TrafficWeight

名前 形容 価値
ラベル トラフィック ラベルをリビジョンに関連付けます
latestRevision トラフィックの重みが最新の安定したリビジョンに属していることを示します bool
revisionName リビジョンの名前
重量 リビジョンに割り当てられたトラフィックの重み int

RegistryCredentials

名前 形容 価値
同一性 Azure Container Registry での認証に使用するマネージド ID。 ユーザー割り当て ID の場合は、完全なユーザー割り当て ID リソース ID を使用します。 システム割り当て ID の場合は、'system' を使用します
passwordSecretRef レジストリ ログイン パスワードを含むシークレットの名前
サーバー Container Registry Server
username Container Registry Username

秘密

名前 形容 価値
名前 シークレット名。
価値 シークレット値。

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。

テンプレート

名前 形容 価値
コンテナー コンテナー アプリのコンテナー定義の一覧。 コンテナー[]
revisionSuffix リビジョン名に追加されるわかりやすいサフィックス
規模 コンテナー アプリのプロパティのスケーリング。 スケール
ボリューム コンテナー アプリのボリューム定義の一覧。 ボリューム[]

コンテナ

名前 形容 価値
args コンテナーの開始コマンド引数。 string[]
命令 コンテナーの開始コマンド。 string[]
env コンテナー環境変数。 EnvironmentVar[]
画像 コンテナー イメージ タグ。
名前 カスタム コンテナー名。
プローブ コンテナーのプローブの一覧。 ContainerAppProbe[]
リソース コンテナー リソースの要件。 ContainerResources の
volumeMounts コンテナー ボリュームのマウント。 VolumeMount[]

EnvironmentVar

名前 形容 価値
名前 環境変数の名前。
secretRef 環境変数の値をプルするコンテナー アプリ シークレットの名前。
価値 シークレット以外の環境変数の値。

ContainerAppProbe

名前 形容 価値
failureThreshold 成功した後に失敗したと見なされるプローブの連続する最小障害。 既定値は 3 です。 最小値は 1 です。 最大値は 10 です。 int
httpGet HTTPGet は、実行する http 要求を指定します。 ContainerAppProbeHttpGet の
initialDelaySeconds コンテナーが起動してから、liveness プローブが開始されるまでの秒数。 最小値は 1 です。 最大値は 60 です。 int
periodSeconds プローブを実行する頻度 (秒単位)。 既定値は 10 秒です。 最小値は 1 です。 最大値は 240 です。 int
successThreshold 失敗した後にプローブが成功したと見なされる最小連続成功数。 既定値は 1 です。 ライブ性と起動には 1 にする必要があります。 最小値は 1 です。 最大値は 10 です。 int
tcpSocket TCPSocket は、TCP ポートに関連するアクションを指定します。 TCP フックはまだサポートされていません。 ContainerAppProbeTcpSocket の
terminationGracePeriodSeconds プローブの障害時にポッドを正常に終了する必要がある時間 (秒単位)。 猶予期間は、ポッドで実行されているプロセスが終了シグナルを送信してから数秒で、プロセスが強制終了シグナルで強制的に停止される時間です。 この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。 この値が nil の場合、ポッドの terminationGracePeriodSeconds が使用されます。 それ以外の場合、この値はポッド スペックによって提供される値をオーバーライドします。値は負以外の整数である必要があります。 値 0 は、強制終了信号を介して直ちに停止することを示します (シャットダウンする機会はありません)。 これはアルファ フィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。 最大値は 3600 秒 (1 時間) です。 int
timeoutSeconds プローブがタイムアウトする秒数。既定値は 1 秒です。 最小値は 1 です。 最大値は 240 です。 int
種類 プローブの種類。 'Liveness'
'Readiness'
'Startup'

ContainerAppProbeHttpGet

名前 形容 価値
ホスト 接続先のホスト名。既定ではポッド IP が使用されます。 代わりに httpHeaders で "Host" を設定することをお考えでしょう。
httpHeaders 要求で設定するカスタム ヘッダー。 HTTP では、ヘッダーを繰り返し使用できます。 ContainerAppProbeHttpGetHttpHeadersItem[]
パス HTTP サーバー上のアクセスのパス。
コンテナーでアクセスするポートの名前または番号。 数値は 1 ~ 65535 の範囲である必要があります。 名前はIANA_SVC_NAMEである必要があります。 int (必須)
計画 ホストへの接続に使用するスキーム。 既定値は HTTP です。 'HTTP'
'HTTPS'

ContainerAppProbeHttpGetHttpHeadersItem

名前 形容 価値
名前 ヘッダー フィールド名 string (必須)
価値 ヘッダー フィールドの値 string (必須)

ContainerAppProbeTcpSocket

名前 形容 価値
ホスト 省略可能: 接続先のホスト名。既定ではポッド IP が使用されます。
コンテナーでアクセスするポートの番号または名前。 数値は 1 ~ 65535 の範囲である必要があります。 名前はIANA_SVC_NAMEである必要があります。 int (必須)

ContainerResources

名前 形容 価値
cpu コアに必要な CPU (例: 0.5) 10 進値を指定するには、json() 関数を使用します。 int または json decimal
記憶 必要なメモリ (例: "250Mb" )

VolumeMount

名前 形容 価値
mountPath ボリュームをマウントするコンテナー内のパス。':' を含めてはなりません。
volumeName これはボリュームの名前と一致する必要があります。

規模

名前 形容 価値
maxReplicas 随意。 コンテナー レプリカの最大数。 既定値は 10 (設定されていない場合) です。 int
minReplicas 随意。 コンテナー レプリカの最小数。 int
準則 スケーリング ルール。 ScaleRule[]

ScaleRule

名前 形容 価値
azureQueue Azure Queue ベースのスケーリング。 QueueScaleRule の
習慣 カスタム スケール ルール。 CustomScaleRule の
http HTTP 要求ベースのスケーリング。 HttpScaleRule を する
名前 スケール ルール名

QueueScaleRule

名前 形容 価値
認証 キュー スケール ルールの認証シークレット。 ScaleRuleAuth[]
queueLength キューの長さ。 int
queueName キュー名。

ScaleRuleAuth

名前 形容 価値
secretRef 認証パラメーターのプル元となるコンテナー アプリ シークレットの名前。
triggerParameter シークレットを使用するトリガー パラメーター

CustomScaleRule

名前 形容 価値
認証 カスタム スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata カスタム スケール ルールを記述するメタデータ プロパティ。 CustomScaleRuleMetadata を する
種類 カスタム スケール ルールの種類
例: azure-servicebus、redis など。

CustomScaleRuleMetadata

名前 形容 価値
{カスタマイズされたプロパティ}

HttpScaleRule

名前 形容 価値
認証 カスタム スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata http スケール ルールを記述するメタデータ プロパティ。 HttpScaleRuleMetadata を する

HttpScaleRuleMetadata

名前 形容 価値
{カスタマイズされたプロパティ}

容積

名前 形容 価値
名前 ボリューム名。
storageName ストレージ リソースの名前。 EmptyDir を指定する必要はありません。
storageType ボリュームのストレージの種類。 指定しない場合は、EmptyDir を使用します。 'AzureFile'
'EmptyDir'

クイック スタート テンプレート

次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。

テンプレート 形容
レジストリ を使用してコンテナー アプリと環境を作成する

Azure にデプロイする
Azure Container Registry から基本的なコンテナー アプリを使用してコンテナー アプリ環境を作成します。 また、Log Analytics ワークスペースをデプロイしてログを格納します。
Container App Environment を使用して 2 つのコンテナー アプリを作成します

Azure にデプロイする
基本的なコンテナー アプリを使用して 2 つのコンテナー アプリ環境を作成します。 また、Log Analytics ワークスペースをデプロイしてログを格納します。
Container App Environment 内にコンテナー アプリを作成します

Azure にデプロイする
基本的なコンテナー アプリを使用してコンテナー アプリ環境を作成します。 また、Log Analytics ワークスペースをデプロイしてログを格納します。
定義された HTTP スケーリング ルールを使用してコンテナー アプリを作成

Azure にデプロイする
HTTP トラフィックに基づいてスケーリングする基本的なコンテナー アプリを使用して、コンテナー アプリ環境を作成します。
VNET を使用して外部コンテナー アプリ環境を作成する

Azure にデプロイする
VNET を使用して外部コンテナー アプリ環境を作成します。
VNET を使用して内部コンテナー アプリ環境を作成します

Azure にデプロイする
VNET を使用して内部コンテナー アプリ環境を作成します。

ARM テンプレート リソース定義

containerApps リソースの種類は、次を対象とする操作と共にデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.App/containerApps リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.App/containerApps",
  "apiVersion": "2022-03-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "configuration": {
      "activeRevisionsMode": "string",
      "dapr": {
        "appId": "string",
        "appPort": "int",
        "appProtocol": "string",
        "enabled": "bool"
      },
      "ingress": {
        "allowInsecure": "bool",
        "customDomains": [
          {
            "bindingType": "string",
            "certificateId": "string",
            "name": "string"
          }
        ],
        "external": "bool",
        "targetPort": "int",
        "traffic": [
          {
            "label": "string",
            "latestRevision": "bool",
            "revisionName": "string",
            "weight": "int"
          }
        ],
        "transport": "string"
      },
      "registries": [
        {
          "identity": "string",
          "passwordSecretRef": "string",
          "server": "string",
          "username": "string"
        }
      ],
      "secrets": [
        {
          "name": "string",
          "value": "string"
        }
      ]
    },
    "managedEnvironmentId": "string",
    "template": {
      "containers": [
        {
          "args": [ "string" ],
          "command": [ "string" ],
          "env": [
            {
              "name": "string",
              "secretRef": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "name": "string",
          "probes": [
            {
              "failureThreshold": "int",
              "httpGet": {
                "host": "string",
                "httpHeaders": [
                  {
                    "name": "string",
                    "value": "string"
                  }
                ],
                "path": "string",
                "port": "int",
                "scheme": "string"
              },
              "initialDelaySeconds": "int",
              "periodSeconds": "int",
              "successThreshold": "int",
              "tcpSocket": {
                "host": "string",
                "port": "int"
              },
              "terminationGracePeriodSeconds": "int",
              "timeoutSeconds": "int",
              "type": "string"
            }
          ],
          "resources": {
            "cpu": "[json('decimal-as-string')]",
            "memory": "string"
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "volumeName": "string"
            }
          ]
        }
      ],
      "revisionSuffix": "string",
      "scale": {
        "maxReplicas": "int",
        "minReplicas": "int",
        "rules": [
          {
            "azureQueue": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "queueLength": "int",
              "queueName": "string"
            },
            "custom": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "metadata": {
                "{customized property}": "string"
              },
              "type": "string"
            },
            "http": {
              "auth": [
                {
                  "secretRef": "string",
                  "triggerParameter": "string"
                }
              ],
              "metadata": {
                "{customized property}": "string"
              }
            },
            "name": "string"
          }
        ]
      },
      "volumes": [
        {
          "name": "string",
          "storageName": "string",
          "storageType": "string"
        }
      ]
    }
  }
}

プロパティ値

containerApps

名前 形容 価値
種類 リソースの種類 'Microsoft.App/containerApps'
apiVersion リソース API のバージョン '2022-03-01'
名前 リソース名 string (必須)

文字数制限: 2 から 32

有効な文字:
小文字、数字、ハイフン。.

文字で始まり、英数字で終わる。
場所 リソースが存在する地理的な場所 string (必須)
タグ リソース タグ。 タグ名と値のディクショナリ。 テンプレート の タグを参照してください
同一性 コード内のシークレットや資格情報を維持することなく、他の Azure サービスと対話するための Container App のマネージド ID。 ManagedServiceIdentity の
プロパティ ContainerApp リソース固有のプロパティ ContainerAppProperties

ManagedServiceIdentity

名前 形容 価値
種類 マネージド サービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (必須)
userAssignedIdentities リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリ キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。 ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。 UserAssignedIdentities の

UserAssignedIdentities

名前 形容 価値
{カスタマイズされたプロパティ} UserAssignedIdentity の

UserAssignedIdentity

このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

ContainerAppProperties

名前 形容 価値
構成 バージョン管理されていない Container App 構成プロパティ。 構成
managedEnvironmentId コンテナー アプリの環境のリソース ID。
テンプレート コンテナー アプリのバージョン管理されたアプリケーション定義。 テンプレートの

構成

名前 形容 価値
activeRevisionsMode ActiveRevisionsMode は、コンテナー アプリのアクティブなリビジョンの処理方法を制御します。
{list}{item}複数: 複数のリビジョンをアクティブにすることができます。{/item}{item}単一: 一度にアクティブにできるリビジョンは 1 つだけです。 リビジョンの重みは、このモードでは使用できません。 値が指定されていない場合は、これが既定値です。{/item}{/list}
'Multiple'
'Single'
dapr コンテナー アプリの Dapr 構成。 Dapr
イングレス イングレス構成。 イングレス
レジストリ コンテナー アプリによって使用されるコンテナーのプライベート コンテナー レジストリ資格情報のコレクション RegistryCredentials[]
秘密 コンテナー アプリによって使用されるシークレットのコレクション シークレット[]

Dapr

名前 形容 価値
appId Dapr アプリケーション識別子
appPort アプリケーションがリッスンしているポートを Dapr に通知します int
appProtocol アプリケーションが使用しているプロトコルを Dapr に通知します。 有効なオプションは http と grpc です。 既定値は http です 'grpc'
'http'
有効 Dapr 側の車が有効かどうかを示すブール値 bool

イングレス

名前 形容 価値
allowInsecure HTTP 接続が許可されているかどうかを示すブール値。 false に設定されている場合、HTTPS 接続に自動的にリダイレクトされます bool
customDomains Container Apps のホスト名のカスタム ドメイン バインド。 CustomDomain[]
アプリが外部 http エンドポイントを公開するかどうかを示すブール値 bool
targetPort イングレスからのトラフィックのコンテナー内のターゲット ポート int
交通 アプリのリビジョンのトラフィックの重み付け TrafficWeight[]
輸送 イングレス トランスポート プロトコル 'auto'
'http'
'http2'

CustomDomain

名前 形容 価値
bindingType カスタム ドメイン バインドの種類。 'Disabled'
'SniEnabled'
certificateId このホスト名にバインドする証明書のリソース ID。
名前 ホスト名。 string (必須)

TrafficWeight

名前 形容 価値
ラベル トラフィック ラベルをリビジョンに関連付けます
latestRevision トラフィックの重みが最新の安定したリビジョンに属していることを示します bool
revisionName リビジョンの名前
重量 リビジョンに割り当てられたトラフィックの重み int

RegistryCredentials

名前 形容 価値
同一性 Azure Container Registry での認証に使用するマネージド ID。 ユーザー割り当て ID の場合は、完全なユーザー割り当て ID リソース ID を使用します。 システム割り当て ID の場合は、'system' を使用します
passwordSecretRef レジストリ ログイン パスワードを含むシークレットの名前
サーバー Container Registry Server
username Container Registry Username

秘密

名前 形容 価値
名前 シークレット名。
価値 シークレット値。

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。

テンプレート

名前 形容 価値
コンテナー コンテナー アプリのコンテナー定義の一覧。 コンテナー[]
revisionSuffix リビジョン名に追加されるわかりやすいサフィックス
規模 コンテナー アプリのプロパティのスケーリング。 スケール
ボリューム コンテナー アプリのボリューム定義の一覧。 ボリューム[]

コンテナ

名前 形容 価値
args コンテナーの開始コマンド引数。 string[]
命令 コンテナーの開始コマンド。 string[]
env コンテナー環境変数。 EnvironmentVar[]
画像 コンテナー イメージ タグ。
名前 カスタム コンテナー名。
プローブ コンテナーのプローブの一覧。 ContainerAppProbe[]
リソース コンテナー リソースの要件。 ContainerResources の
volumeMounts コンテナー ボリュームのマウント。 VolumeMount[]

EnvironmentVar

名前 形容 価値
名前 環境変数の名前。
secretRef 環境変数の値をプルするコンテナー アプリ シークレットの名前。
価値 シークレット以外の環境変数の値。

ContainerAppProbe

名前 形容 価値
failureThreshold 成功した後に失敗したと見なされるプローブの連続する最小障害。 既定値は 3 です。 最小値は 1 です。 最大値は 10 です。 int
httpGet HTTPGet は、実行する http 要求を指定します。 ContainerAppProbeHttpGet の
initialDelaySeconds コンテナーが起動してから、liveness プローブが開始されるまでの秒数。 最小値は 1 です。 最大値は 60 です。 int
periodSeconds プローブを実行する頻度 (秒単位)。 既定値は 10 秒です。 最小値は 1 です。 最大値は 240 です。 int
successThreshold 失敗した後にプローブが成功したと見なされる最小連続成功数。 既定値は 1 です。 ライブ性と起動には 1 にする必要があります。 最小値は 1 です。 最大値は 10 です。 int
tcpSocket TCPSocket は、TCP ポートに関連するアクションを指定します。 TCP フックはまだサポートされていません。 ContainerAppProbeTcpSocket の
terminationGracePeriodSeconds プローブの障害時にポッドを正常に終了する必要がある時間 (秒単位)。 猶予期間は、ポッドで実行されているプロセスが終了シグナルを送信してから数秒で、プロセスが強制終了シグナルで強制的に停止される時間です。 この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。 この値が nil の場合、ポッドの terminationGracePeriodSeconds が使用されます。 それ以外の場合、この値はポッド スペックによって提供される値をオーバーライドします。値は負以外の整数である必要があります。 値 0 は、強制終了信号を介して直ちに停止することを示します (シャットダウンする機会はありません)。 これはアルファ フィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。 最大値は 3600 秒 (1 時間) です。 int
timeoutSeconds プローブがタイムアウトする秒数。既定値は 1 秒です。 最小値は 1 です。 最大値は 240 です。 int
種類 プローブの種類。 'Liveness'
'Readiness'
'Startup'

ContainerAppProbeHttpGet

名前 形容 価値
ホスト 接続先のホスト名。既定ではポッド IP が使用されます。 代わりに httpHeaders で "Host" を設定することをお考えでしょう。
httpHeaders 要求で設定するカスタム ヘッダー。 HTTP では、ヘッダーを繰り返し使用できます。 ContainerAppProbeHttpGetHttpHeadersItem[]
パス HTTP サーバー上のアクセスのパス。
コンテナーでアクセスするポートの名前または番号。 数値は 1 ~ 65535 の範囲である必要があります。 名前はIANA_SVC_NAMEである必要があります。 int (必須)
計画 ホストへの接続に使用するスキーム。 既定値は HTTP です。 'HTTP'
'HTTPS'

ContainerAppProbeHttpGetHttpHeadersItem

名前 形容 価値
名前 ヘッダー フィールド名 string (必須)
価値 ヘッダー フィールドの値 string (必須)

ContainerAppProbeTcpSocket

名前 形容 価値
ホスト 省略可能: 接続先のホスト名。既定ではポッド IP が使用されます。
コンテナーでアクセスするポートの番号または名前。 数値は 1 ~ 65535 の範囲である必要があります。 名前はIANA_SVC_NAMEである必要があります。 int (必須)

ContainerResources

名前 形容 価値
cpu コアに必要な CPU (例: 0.5) 10 進値を指定するには、json() 関数を使用します。 int または json decimal
記憶 必要なメモリ (例: "250Mb" )

VolumeMount

名前 形容 価値
mountPath ボリュームをマウントするコンテナー内のパス。':' を含めてはなりません。
volumeName これはボリュームの名前と一致する必要があります。

規模

名前 形容 価値
maxReplicas 随意。 コンテナー レプリカの最大数。 既定値は 10 (設定されていない場合) です。 int
minReplicas 随意。 コンテナー レプリカの最小数。 int
準則 スケーリング ルール。 ScaleRule[]

ScaleRule

名前 形容 価値
azureQueue Azure Queue ベースのスケーリング。 QueueScaleRule の
習慣 カスタム スケール ルール。 CustomScaleRule の
http HTTP 要求ベースのスケーリング。 HttpScaleRule を する
名前 スケール ルール名

QueueScaleRule

名前 形容 価値
認証 キュー スケール ルールの認証シークレット。 ScaleRuleAuth[]
queueLength キューの長さ。 int
queueName キュー名。

ScaleRuleAuth

名前 形容 価値
secretRef 認証パラメーターのプル元となるコンテナー アプリ シークレットの名前。
triggerParameter シークレットを使用するトリガー パラメーター

CustomScaleRule

名前 形容 価値
認証 カスタム スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata カスタム スケール ルールを記述するメタデータ プロパティ。 CustomScaleRuleMetadata を する
種類 カスタム スケール ルールの種類
例: azure-servicebus、redis など。

CustomScaleRuleMetadata

名前 形容 価値
{カスタマイズされたプロパティ}

HttpScaleRule

名前 形容 価値
認証 カスタム スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata http スケール ルールを記述するメタデータ プロパティ。 HttpScaleRuleMetadata を する

HttpScaleRuleMetadata

名前 形容 価値
{カスタマイズされたプロパティ}

容積

名前 形容 価値
名前 ボリューム名。
storageName ストレージ リソースの名前。 EmptyDir を指定する必要はありません。
storageType ボリュームのストレージの種類。 指定しない場合は、EmptyDir を使用します。 'AzureFile'
'EmptyDir'

クイック スタート テンプレート

次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。

テンプレート 形容
レジストリ を使用してコンテナー アプリと環境を作成する

Azure にデプロイする
Azure Container Registry から基本的なコンテナー アプリを使用してコンテナー アプリ環境を作成します。 また、Log Analytics ワークスペースをデプロイしてログを格納します。
Container App Environment を使用して 2 つのコンテナー アプリを作成します

Azure にデプロイする
基本的なコンテナー アプリを使用して 2 つのコンテナー アプリ環境を作成します。 また、Log Analytics ワークスペースをデプロイしてログを格納します。
Container App Environment 内にコンテナー アプリを作成します

Azure にデプロイする
基本的なコンテナー アプリを使用してコンテナー アプリ環境を作成します。 また、Log Analytics ワークスペースをデプロイしてログを格納します。
定義された HTTP スケーリング ルールを使用してコンテナー アプリを作成

Azure にデプロイする
HTTP トラフィックに基づいてスケーリングする基本的なコンテナー アプリを使用して、コンテナー アプリ環境を作成します。
VNET を使用して外部コンテナー アプリ環境を作成する

Azure にデプロイする
VNET を使用して外部コンテナー アプリ環境を作成します。
VNET を使用して内部コンテナー アプリ環境を作成します

Azure にデプロイする
VNET を使用して内部コンテナー アプリ環境を作成します。

Terraform (AzAPI プロバイダー) リソース定義

containerApps リソースの種類は、次を対象とする操作と共にデプロイできます。

  • リソース グループの

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.App/containerApps リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/containerApps@2022-03-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      configuration = {
        activeRevisionsMode = "string"
        dapr = {
          appId = "string"
          appPort = int
          appProtocol = "string"
          enabled = bool
        }
        ingress = {
          allowInsecure = bool
          customDomains = [
            {
              bindingType = "string"
              certificateId = "string"
              name = "string"
            }
          ]
          external = bool
          targetPort = int
          traffic = [
            {
              label = "string"
              latestRevision = bool
              revisionName = "string"
              weight = int
            }
          ]
          transport = "string"
        }
        registries = [
          {
            identity = "string"
            passwordSecretRef = "string"
            server = "string"
            username = "string"
          }
        ]
        secrets = [
          {
            name = "string"
            value = "string"
          }
        ]
      }
      managedEnvironmentId = "string"
      template = {
        containers = [
          {
            args = [
              "string"
            ]
            command = [
              "string"
            ]
            env = [
              {
                name = "string"
                secretRef = "string"
                value = "string"
              }
            ]
            image = "string"
            name = "string"
            probes = [
              {
                failureThreshold = int
                httpGet = {
                  host = "string"
                  httpHeaders = [
                    {
                      name = "string"
                      value = "string"
                    }
                  ]
                  path = "string"
                  port = int
                  scheme = "string"
                }
                initialDelaySeconds = int
                periodSeconds = int
                successThreshold = int
                tcpSocket = {
                  host = "string"
                  port = int
                }
                terminationGracePeriodSeconds = int
                timeoutSeconds = int
                type = "string"
              }
            ]
            resources = {
              cpu = "decimal-as-string"
              memory = "string"
            }
            volumeMounts = [
              {
                mountPath = "string"
                volumeName = "string"
              }
            ]
          }
        ]
        revisionSuffix = "string"
        scale = {
          maxReplicas = int
          minReplicas = int
          rules = [
            {
              azureQueue = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                queueLength = int
                queueName = "string"
              }
              custom = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                metadata = {
                  {customized property} = "string"
                }
                type = "string"
              }
              http = {
                auth = [
                  {
                    secretRef = "string"
                    triggerParameter = "string"
                  }
                ]
                metadata = {
                  {customized property} = "string"
                }
              }
              name = "string"
            }
          ]
        }
        volumes = [
          {
            name = "string"
            storageName = "string"
            storageType = "string"
          }
        ]
      }
    }
  })
}

プロパティ値

containerApps

名前 形容 価値
種類 リソースの種類 "Microsoft.App/containerApps@2022-03-01"
名前 リソース名 string (必須)

文字数制限: 2 から 32

有効な文字:
小文字、数字、ハイフン。.

文字で始まり、英数字で終わる。
場所 リソースが存在する地理的な場所 string (必須)
parent_id リソース グループにデプロイするには、そのリソース グループの ID を使用します。 string (必須)
タグ リソース タグ。 タグ名と値のディクショナリ。
同一性 コード内のシークレットや資格情報を維持することなく、他の Azure サービスと対話するための Container App のマネージド ID。 ManagedServiceIdentity の
プロパティ ContainerApp リソース固有のプロパティ ContainerAppProperties

ManagedServiceIdentity

名前 形容 価値
種類 マネージド サービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。 "SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (必須)
identity_ids リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリ キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。 ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。 ユーザー ID ID の配列。

UserAssignedIdentities

名前 形容 価値
{カスタマイズされたプロパティ} UserAssignedIdentity の

UserAssignedIdentity

このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

ContainerAppProperties

名前 形容 価値
構成 バージョン管理されていない Container App 構成プロパティ。 構成
managedEnvironmentId コンテナー アプリの環境のリソース ID。
テンプレート コンテナー アプリのバージョン管理されたアプリケーション定義。 テンプレートの

構成

名前 形容 価値
activeRevisionsMode ActiveRevisionsMode は、コンテナー アプリのアクティブなリビジョンの処理方法を制御します。
{list}{item}複数: 複数のリビジョンをアクティブにすることができます。{/item}{item}単一: 一度にアクティブにできるリビジョンは 1 つだけです。 リビジョンの重みは、このモードでは使用できません。 値が指定されていない場合は、これが既定値です。{/item}{/list}
"Multiple"
"Single"
dapr コンテナー アプリの Dapr 構成。 Dapr
イングレス イングレス構成。 イングレス
レジストリ コンテナー アプリによって使用されるコンテナーのプライベート コンテナー レジストリ資格情報のコレクション RegistryCredentials[]
秘密 コンテナー アプリによって使用されるシークレットのコレクション シークレット[]

Dapr

名前 形容 価値
appId Dapr アプリケーション識別子
appPort アプリケーションがリッスンしているポートを Dapr に通知します int
appProtocol アプリケーションが使用しているプロトコルを Dapr に通知します。 有効なオプションは http と grpc です。 既定値は http です "grpc"
"http"
有効 Dapr 側の車が有効かどうかを示すブール値 bool

イングレス

名前 形容 価値
allowInsecure HTTP 接続が許可されているかどうかを示すブール値。 false に設定されている場合、HTTPS 接続に自動的にリダイレクトされます bool
customDomains Container Apps のホスト名のカスタム ドメイン バインド。 CustomDomain[]
アプリが外部 http エンドポイントを公開するかどうかを示すブール値 bool
targetPort イングレスからのトラフィックのコンテナー内のターゲット ポート int
交通 アプリのリビジョンのトラフィックの重み付け TrafficWeight[]
輸送 イングレス トランスポート プロトコル "auto"
"http"
"http2"

CustomDomain

名前 形容 価値
bindingType カスタム ドメイン バインドの種類。 "無効"
"SniEnabled"
certificateId このホスト名にバインドする証明書のリソース ID。
名前 ホスト名。 string (必須)

TrafficWeight

名前 形容 価値
ラベル トラフィック ラベルをリビジョンに関連付けます
latestRevision トラフィックの重みが最新の安定したリビジョンに属していることを示します bool
revisionName リビジョンの名前
重量 リビジョンに割り当てられたトラフィックの重み int

RegistryCredentials

名前 形容 価値
同一性 Azure Container Registry での認証に使用するマネージド ID。 ユーザー割り当て ID の場合は、完全なユーザー割り当て ID リソース ID を使用します。 システム割り当て ID の場合は、'system' を使用します
passwordSecretRef レジストリ ログイン パスワードを含むシークレットの名前
サーバー Container Registry Server
username Container Registry Username

秘密

名前 形容 価値
名前 シークレット名。
価値 シークレット値。

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。

テンプレート

名前 形容 価値
コンテナー コンテナー アプリのコンテナー定義の一覧。 コンテナー[]
revisionSuffix リビジョン名に追加されるわかりやすいサフィックス
規模 コンテナー アプリのプロパティのスケーリング。 スケール
ボリューム コンテナー アプリのボリューム定義の一覧。 ボリューム[]

コンテナ

名前 形容 価値
args コンテナーの開始コマンド引数。 string[]
命令 コンテナーの開始コマンド。 string[]
env コンテナー環境変数。 EnvironmentVar[]
画像 コンテナー イメージ タグ。
名前 カスタム コンテナー名。
プローブ コンテナーのプローブの一覧。 ContainerAppProbe[]
リソース コンテナー リソースの要件。 ContainerResources の
volumeMounts コンテナー ボリュームのマウント。 VolumeMount[]

EnvironmentVar

名前 形容 価値
名前 環境変数の名前。
secretRef 環境変数の値をプルするコンテナー アプリ シークレットの名前。
価値 シークレット以外の環境変数の値。

ContainerAppProbe

名前 形容 価値
failureThreshold 成功した後に失敗したと見なされるプローブの連続する最小障害。 既定値は 3 です。 最小値は 1 です。 最大値は 10 です。 int
httpGet HTTPGet は、実行する http 要求を指定します。 ContainerAppProbeHttpGet の
initialDelaySeconds コンテナーが起動してから、liveness プローブが開始されるまでの秒数。 最小値は 1 です。 最大値は 60 です。 int
periodSeconds プローブを実行する頻度 (秒単位)。 既定値は 10 秒です。 最小値は 1 です。 最大値は 240 です。 int
successThreshold 失敗した後にプローブが成功したと見なされる最小連続成功数。 既定値は 1 です。 ライブ性と起動には 1 にする必要があります。 最小値は 1 です。 最大値は 10 です。 int
tcpSocket TCPSocket は、TCP ポートに関連するアクションを指定します。 TCP フックはまだサポートされていません。 ContainerAppProbeTcpSocket の
terminationGracePeriodSeconds プローブの障害時にポッドを正常に終了する必要がある時間 (秒単位)。 猶予期間は、ポッドで実行されているプロセスが終了シグナルを送信してから数秒で、プロセスが強制終了シグナルで強制的に停止される時間です。 この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。 この値が nil の場合、ポッドの terminationGracePeriodSeconds が使用されます。 それ以外の場合、この値はポッド スペックによって提供される値をオーバーライドします。値は負以外の整数である必要があります。 値 0 は、強制終了信号を介して直ちに停止することを示します (シャットダウンする機会はありません)。 これはアルファ フィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。 最大値は 3600 秒 (1 時間) です。 int
timeoutSeconds プローブがタイムアウトする秒数。既定値は 1 秒です。 最小値は 1 です。 最大値は 240 です。 int
種類 プローブの種類。 "Liveness"
"準備"
"スタートアップ"

ContainerAppProbeHttpGet

名前 形容 価値
ホスト 接続先のホスト名。既定ではポッド IP が使用されます。 代わりに httpHeaders で "Host" を設定することをお考えでしょう。
httpHeaders 要求で設定するカスタム ヘッダー。 HTTP では、ヘッダーを繰り返し使用できます。 ContainerAppProbeHttpGetHttpHeadersItem[]
パス HTTP サーバー上のアクセスのパス。
コンテナーでアクセスするポートの名前または番号。 数値は 1 ~ 65535 の範囲である必要があります。 名前はIANA_SVC_NAMEである必要があります。 int (必須)
計画 ホストへの接続に使用するスキーム。 既定値は HTTP です。 "HTTP"
"HTTPS"

ContainerAppProbeHttpGetHttpHeadersItem

名前 形容 価値
名前 ヘッダー フィールド名 string (必須)
価値 ヘッダー フィールドの値 string (必須)

ContainerAppProbeTcpSocket

名前 形容 価値
ホスト 省略可能: 接続先のホスト名。既定ではポッド IP が使用されます。
コンテナーでアクセスするポートの番号または名前。 数値は 1 ~ 65535 の範囲である必要があります。 名前はIANA_SVC_NAMEである必要があります。 int (必須)

ContainerResources

名前 形容 価値
cpu コアで必要な CPU (例: 0.5) 10 進値を文字列として指定します。 int または json decimal
記憶 必要なメモリ (例: "250Mb" )

VolumeMount

名前 形容 価値
mountPath ボリュームをマウントするコンテナー内のパス。':' を含めてはなりません。
volumeName これはボリュームの名前と一致する必要があります。

規模

名前 形容 価値
maxReplicas 随意。 コンテナー レプリカの最大数。 既定値は 10 (設定されていない場合) です。 int
minReplicas 随意。 コンテナー レプリカの最小数。 int
準則 スケーリング ルール。 ScaleRule[]

ScaleRule

名前 形容 価値
azureQueue Azure Queue ベースのスケーリング。 QueueScaleRule の
習慣 カスタム スケール ルール。 CustomScaleRule の
http HTTP 要求ベースのスケーリング。 HttpScaleRule を する
名前 スケール ルール名

QueueScaleRule

名前 形容 価値
認証 キュー スケール ルールの認証シークレット。 ScaleRuleAuth[]
queueLength キューの長さ。 int
queueName キュー名。

ScaleRuleAuth

名前 形容 価値
secretRef 認証パラメーターのプル元となるコンテナー アプリ シークレットの名前。
triggerParameter シークレットを使用するトリガー パラメーター

CustomScaleRule

名前 形容 価値
認証 カスタム スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata カスタム スケール ルールを記述するメタデータ プロパティ。 CustomScaleRuleMetadata を する
種類 カスタム スケール ルールの種類
例: azure-servicebus、redis など。

CustomScaleRuleMetadata

名前 形容 価値
{カスタマイズされたプロパティ}

HttpScaleRule

名前 形容 価値
認証 カスタム スケール ルールの認証シークレット。 ScaleRuleAuth[]
metadata http スケール ルールを記述するメタデータ プロパティ。 HttpScaleRuleMetadata を する

HttpScaleRuleMetadata

名前 形容 価値
{カスタマイズされたプロパティ}

容積

名前 形容 価値
名前 ボリューム名。
storageName ストレージ リソースの名前。 EmptyDir を指定する必要はありません。
storageType ボリュームのストレージの種類。 指定しない場合は、EmptyDir を使用します。 "AzureFile"
"EmptyDir"