Microsoft.ContainerInstance コンテナーグループ 2019-12-01

• 最新の を する
• 2025-09-01
• 2024-11-01-preview
• 2024-10-01-preview
• 2024-09-01-preview
• 2024-05-01-preview
• 2023-05-01
• 2023-02-01-preview
• 2022-10-01-preview
• 2022-09-01
• 2021-10-01
• 2021-09-01
• 2021-07-01
• 2021-03-01
• 2020-11-01
• 2019-12-01
• 2018-10-01
• 2018-09-01
• 2018-06-01
• 2018-04-01
• 2018-02-01-preview
• 2017-12-01-preview
• 2017-10-01-preview
• 2017-08-01-preview

Bicep リソース定義

containerGroups リソースの種類は、次をターゲットとする操作でデプロイできます。

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

リソースの形式

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

resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2019-12-01' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    containers: [
      {
        name: 'string'
        properties: {
          command: [
            'string'
          ]
          environmentVariables: [
            {
              name: 'string'
              secureValue: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          livenessProbe: {
            exec: {
              command: [
                'string'
              ]
            }
            failureThreshold: int
            httpGet: {
              path: 'string'
              port: int
              scheme: 'string'
            }
            initialDelaySeconds: int
            periodSeconds: int
            successThreshold: int
            timeoutSeconds: int
          }
          ports: [
            {
              port: int
              protocol: 'string'
            }
          ]
          readinessProbe: {
            exec: {
              command: [
                'string'
              ]
            }
            failureThreshold: int
            httpGet: {
              path: 'string'
              port: int
              scheme: 'string'
            }
            initialDelaySeconds: int
            periodSeconds: int
            successThreshold: int
            timeoutSeconds: int
          }
          resources: {
            limits: {
              cpu: int
              gpu: {
                count: int
                sku: 'string'
              }
              memoryInGB: int
            }
            requests: {
              cpu: int
              gpu: {
                count: int
                sku: 'string'
              }
              memoryInGB: int
            }
          }
          volumeMounts: [
            {
              mountPath: 'string'
              name: 'string'
              readOnly: bool
            }
          ]
        }
      }
    ]
    diagnostics: {
      logAnalytics: {
        logType: 'string'
        metadata: {
          {customized property}: 'string'
        }
        workspaceId: 'string'
        workspaceKey: 'string'
      }
    }
    dnsConfig: {
      nameServers: [
        'string'
      ]
      options: 'string'
      searchDomains: 'string'
    }
    encryptionProperties: {
      keyName: 'string'
      keyVersion: 'string'
      vaultBaseUrl: 'string'
    }
    imageRegistryCredentials: [
      {
        password: 'string'
        server: 'string'
        username: 'string'
      }
    ]
    initContainers: [
      {
        name: 'string'
        properties: {
          command: [
            'string'
          ]
          environmentVariables: [
            {
              name: 'string'
              secureValue: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          volumeMounts: [
            {
              mountPath: 'string'
              name: 'string'
              readOnly: bool
            }
          ]
        }
      }
    ]
    ipAddress: {
      dnsNameLabel: 'string'
      ip: 'string'
      ports: [
        {
          port: int
          protocol: 'string'
        }
      ]
      type: 'string'
    }
    networkProfile: {
      id: 'string'
    }
    osType: 'string'
    restartPolicy: 'string'
    sku: 'string'
    volumes: [
      {
        azureFile: {
          readOnly: bool
          shareName: 'string'
          storageAccountKey: 'string'
          storageAccountName: 'string'
        }
        emptyDir: any(...)
        gitRepo: {
          directory: 'string'
          repository: 'string'
          revision: 'string'
        }
        name: 'string'
        secret: {
          {customized property}: 'string'
        }
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.ContainerInstance/containerGroups

名前	形容	価値
ID	構成されている場合は、コンテナー グループの ID。	ContainerGroupIdentity
位置	リソースの場所。	文字列
名前	リソース名	string (必須)
プロパティ	コンテナー グループのプロパティ	ContainerGroupProperties (必須)
スコープ	デプロイ スコープとは異なるスコープでリソースを作成するときに使用します。	このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。
タグ	リソース タグ	タグ名と値のディクショナリ。 テンプレート の タグを参照してください

AzureFileVolume

名前	形容	価値
readOnly	ボリュームとしてマウントされた Azure File 共有が読み取り専用かどうかを示すフラグ。	ブール (bool)
shareName	ボリュームとしてマウントする Azure ファイル共有の名前。	string (必須)
storageAccountKey	Azure ファイル共有へのアクセスに使用されるストレージ アカウント アクセス キー。	文字列
ストレージアカウント名	Azure ファイル共有を含むストレージ アカウントの名前。	string (必須)

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

名前	形容	価値

コンテナ

名前	形容	価値
名前	コンテナー インスタンスのユーザー指定の名前。	string (必須)
プロパティ	コンテナー インスタンスのプロパティ。	ContainerProperties (必須)

ContainerExec

名前	形容	価値
命令	コンテナー内で実行するコマンド。	string[]

ContainerGroupDiagnostics

名前	形容	価値
ログアナリティクス	コンテナー グループのログ分析情報。	LogAnalytics

ContainerGroupIdentity

名前	形容	価値
型	コンテナー グループに使用される ID の種類。 型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' は、コンテナー グループからすべての ID を削除します。	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	コンテナー グループに関連付けられているユーザー ID の一覧。 ユーザー ID ディクショナリ のキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。	ContainerGroupIdentityUserAssignedIdentities

ContainerGroupIdentityUserAssignedIdentities

名前	形容	価値

ContainerGroupNetworkProfile

名前	形容	価値
身分証明書	ネットワーク プロファイルの識別子。	string (必須)

ContainerGroupProperties

名前	形容	価値
コンテナー	コンテナー グループ内のコンテナー。	コンテナー[] (必須)
診断	コンテナー グループの診断情報。	ContainerGroupDiagnostics
dnsConfig	コンテナー グループの DNS 構成情報。	DnsConfiguration
encryptionProperties	コンテナー グループの暗号化プロパティ。	EncryptionProperties
imageRegistryCredentials	コンテナー グループの作成元のイメージ レジストリ資格情報。	ImageRegistryCredential[]
initContainers	コンテナー グループの init コンテナー。	InitContainerDefinition[]
ipAddress	コンテナー グループの IP アドレスの種類。	IpAddress の
networkProfile	コンテナー グループのネットワーク プロファイル情報。	ContainerGroupNetworkProfile
osType	コンテナー グループ内のコンテナーに必要なオペレーティング システムの種類。	'Linux' 'Windows' (必須)
restartPolicy	コンテナー グループ内のすべてのコンテナーのポリシーを再起動します。 - Always 常に再起動する - OnFailure 失敗した場合の再起動 - Never 再起動しない	'Always' 'Never' 'OnFailure'
エスケーユー	コンテナー グループの SKU。	'Dedicated' 'Standard'
ボリューム	このコンテナー グループ内のコンテナーによってマウントできるボリュームの一覧。	ボリューム[]

ContainerHttpGet

名前	形容	価値
パス	プローブするパス。	文字列
ポート	プローブするポート番号。	int (必須)
計画	スキーム。	'http' 'https'

ContainerPort

名前	形容	価値
ポート	コンテナー グループ内で公開されるポート番号。	int (必須)
プロトコル	ポートに関連付けられているプロトコル。	'TCP' 'UDP'

ContainerProbe

名前	形容	価値
exec	プローブする実行コマンド	ContainerExec
failureThreshold	エラーのしきい値。	整数 (int)
httpGet	プローブする Http Get 設定	ContainerHttpGet
initialDelaySeconds	最初の遅延秒数。	整数 (int)
periodSeconds	期間 (秒)。	整数 (int)
successThreshold	成功のしきい値。	整数 (int)
timeoutSeconds	タイムアウト秒数。	整数 (int)

ContainerProperties

名前	形容	価値
命令	コンテナー インスタンス内で exec 形式で実行するコマンド。	string[]
環境変数	コンテナー インスタンスで設定する環境変数。	EnvironmentVariable[]
イメージ	コンテナー インスタンスの作成に使用されるイメージの名前。	string (必須)
livenessProbe	ライブネス プローブ。	ContainerProbe
ポート	コンテナー インスタンスで公開されているポート。	ContainerPort[]
readinessProbe	準備プローブ。	ContainerProbe
リソース	コンテナー インスタンスのリソース要件。	ResourceRequirements (必須)
volumeMounts	コンテナー インスタンスで使用できるボリューム マウント。	VolumeMount[]

DnsConfiguration

名前	形容	価値
nameServers	コンテナー グループの DNS サーバー。	string[] (必須)
オプション	コンテナー グループの DNS オプション。	文字列
searchDomains	コンテナー グループ内のホスト名検索の DNS 検索ドメイン。	文字列

EncryptionProperties

名前	形容	価値
keyName	暗号化キーの名前。	string (必須)
keyVersion	暗号化キーのバージョン。	string (必須)
vaultBaseUrl	keyvault のベース URL。	string (必須)

EnvironmentVariable

名前	形容	価値
名前	環境変数の名前。	string (必須)
secureValue	セキュリティで保護された環境変数の値。	文字列
価値	環境変数の値。	文字列

GitRepoVolume

名前	形容	価値
ディレクトリ	ターゲット ディレクトリ名。 '..' を含めたり、先頭に含めたりすることはできません。 '.' が指定されている場合、ボリューム ディレクトリは Git リポジトリになります。 指定しない場合、ボリュームには、指定された名前の git リポジトリがサブディレクトリに含まれます。	文字列
リポジトリ	リポジトリ URL	string (必須)
改定	指定したリビジョンのコミット ハッシュ。	文字列

GpuResource

名前	形容	価値
数える	GPU リソースの数。	int (必須)
エスケーユー	GPU リソースの SKU。	'K80' 'P100' 'V100' (必須)

ImageRegistryCredential

名前	形容	価値
パスワード	プライベート レジストリのパスワード。	文字列
サーバー	"http" や "https" などのプロトコルのない Docker イメージ レジストリ サーバー。	string (必須)
ユーザー名	プライベート レジストリのユーザー名。	string (必須)

InitContainerDefinition

名前	形容	価値
名前	init コンテナーの名前。	string (必須)
プロパティ	init コンテナーのプロパティ。	InitContainerPropertiesDefinition (必須)

InitContainerPropertiesDefinition

名前	形容	価値
命令	init コンテナー内で exec 形式で実行するコマンド。	string[]
環境変数	init コンテナーで設定する環境変数。	EnvironmentVariable[]
イメージ	init コンテナーのイメージ。	文字列
volumeMounts	init コンテナーで使用できるボリューム マウント。	VolumeMount[]

IPアドレス

名前	形容	価値
dnsNameLabel	IP の Dns 名ラベル。	文字列
ip	パブリック インターネットに公開されている IP。	文字列
ポート	コンテナー グループで公開されているポートの一覧。	ポート[] (必須)
型	IP がパブリック インターネットまたはプライベート VNET に公開されるかどうかを指定します。	'Private' 'Public' (必須)

LogAnalytics

名前	形容	価値
logType	使用するログの種類。	'ContainerInsights' 'ContainerInstanceLogs'
メタデータ	ログ分析のメタデータ。	LogAnalyticsMetadata の
ワークスペースID	ログ分析のワークスペース ID	string (必須)
workspaceKey	ログ分析のワークスペース キー	string (必須)

LogAnalyticsMetadata

名前	形容	価値

港

名前	形容	価値
ポート	ポート番号。	int (必須)
プロトコル	ポートに関連付けられているプロトコル。	'TCP' 'UDP'

ResourceLimits

名前	形容	価値
cpu	このコンテナー インスタンスの CPU 制限。	整数 (int)
GPU	このコンテナー インスタンスの GPU 制限。	GpuResource の
memoryInGB	このコンテナー インスタンスのメモリ制限 (GB 単位)。	整数 (int)

ResourceRequests

名前	形容	価値
cpu	このコンテナー インスタンスの CPU 要求。	int (必須)
GPU	このコンテナー インスタンスの GPU 要求。	GpuResource の
memoryInGB	このコンテナー インスタンスのメモリ要求 (GB 単位)。	int (必須)

ResourceRequirements

名前	形容	価値
制限	このコンテナー インスタンスのリソース制限。	ResourceLimits
要求	このコンテナー インスタンスのリソース要求。	ResourceRequests (必須)

ResourceTags

名前	形容	価値

SecretVolume

名前	形容	価値

容積

名前	形容	価値
azureFile	Azure File ボリューム。	AzureFileVolume
emptyDir	空のディレクトリ ボリューム。	任意
gitRepo	Git リポジトリ ボリューム。	GitRepoVolume を する
名前	ボリュームの名前。	string (必須)
シークレット	シークレット ボリューム。	SecretVolume

VolumeMount

名前	形容	価値
mountPath	ボリュームをマウントするコンテナー内のパス。 コロン (:)を含めてはなりません。	string (必須)
名前	ボリューム マウントの名前。	string (必須)
readOnly	ボリューム マウントが読み取り専用かどうかを示すフラグ。	ブール (bool)

使用例

Azure 検証済みモジュール

次の Azure 検証済みモジュール を使用して、このリソースの種類をデプロイできます。

モジュール	形容
コンテナインスタンス	コンテナー インスタンスの AVM リソース モジュール

Azure クイック スタートのサンプル

次 Azure クイック スタート テンプレート、このリソースの種類をデプロイするための Bicep サンプルが含まれています。

Bicep ファイル	形容
azure Container Instances の - SQL Server と IIS を使用した BC	Azure Container Instances に、完全に機能する自己完結型 Microsoft Dynamics 365 Business Central 環境を備えた単一の Windows コンテナーをデプロイします。
Azure Container Instances の - シークレットが されたコンテナー	Azure Container Instances を使用して、シークレット ボリュームを持つ Linux コンテナーをデプロイします。
Azure Container Instances の - パブリック IP を使用した Linux コンテナー	Azure Container Instances を使用して、パブリック IP 経由でアクセスできる 1 つの Linux コンテナーをデプロイします。
Azure Container Instances の - VNet	コンテナー インスタンスを Azure 仮想ネットワークにデプロイします。
WordPress サイト を作成する	このテンプレートは、コンテナー インスタンスに WordPress サイトを作成します
永続ストレージ を使用してオンデマンド SFTP サーバーを作成する	このテンプレートは、Azure Container Instance (ACI) を使用するオンデマンド SFTP サーバーを示しています。
証明書 を使用して Application Gateway を作成する	このテンプレートでは、Key Vault の自己署名証明書を生成し、Application Gateway から参照する方法を示します。
Azure Container Instances を使用した Front Door Standard/Premium の	このテンプレートは、コンテナー グループを使用して Front Door Standard/Premium を作成します。
コンテナー インスタンスと Application Gateway を使用した Front Door の	このテンプレートは、コンテナー グループと Application Gateway を使用して Front Door Standard/Premium を作成します。
AKS での SQL Server 可用性グループの	これにより、新しい AKS クラスターが作成され、Duffle と ACI を使用してデプロイされた CNAB パッケージを使用して SQL Server 可用性グループがデプロイされます

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

containerGroups リソースの種類は、次をターゲットとする操作でデプロイできます。

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

リソースの形式

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

{
  "type": "Microsoft.ContainerInstance/containerGroups",
  "apiVersion": "2019-12-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "containers": [
      {
        "name": "string",
        "properties": {
          "command": [ "string" ],
          "environmentVariables": [
            {
              "name": "string",
              "secureValue": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "livenessProbe": {
            "exec": {
              "command": [ "string" ]
            },
            "failureThreshold": "int",
            "httpGet": {
              "path": "string",
              "port": "int",
              "scheme": "string"
            },
            "initialDelaySeconds": "int",
            "periodSeconds": "int",
            "successThreshold": "int",
            "timeoutSeconds": "int"
          },
          "ports": [
            {
              "port": "int",
              "protocol": "string"
            }
          ],
          "readinessProbe": {
            "exec": {
              "command": [ "string" ]
            },
            "failureThreshold": "int",
            "httpGet": {
              "path": "string",
              "port": "int",
              "scheme": "string"
            },
            "initialDelaySeconds": "int",
            "periodSeconds": "int",
            "successThreshold": "int",
            "timeoutSeconds": "int"
          },
          "resources": {
            "limits": {
              "cpu": "int",
              "gpu": {
                "count": "int",
                "sku": "string"
              },
              "memoryInGB": "int"
            },
            "requests": {
              "cpu": "int",
              "gpu": {
                "count": "int",
                "sku": "string"
              },
              "memoryInGB": "int"
            }
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "name": "string",
              "readOnly": "bool"
            }
          ]
        }
      }
    ],
    "diagnostics": {
      "logAnalytics": {
        "logType": "string",
        "metadata": {
          "{customized property}": "string"
        },
        "workspaceId": "string",
        "workspaceKey": "string"
      }
    },
    "dnsConfig": {
      "nameServers": [ "string" ],
      "options": "string",
      "searchDomains": "string"
    },
    "encryptionProperties": {
      "keyName": "string",
      "keyVersion": "string",
      "vaultBaseUrl": "string"
    },
    "imageRegistryCredentials": [
      {
        "password": "string",
        "server": "string",
        "username": "string"
      }
    ],
    "initContainers": [
      {
        "name": "string",
        "properties": {
          "command": [ "string" ],
          "environmentVariables": [
            {
              "name": "string",
              "secureValue": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "volumeMounts": [
            {
              "mountPath": "string",
              "name": "string",
              "readOnly": "bool"
            }
          ]
        }
      }
    ],
    "ipAddress": {
      "dnsNameLabel": "string",
      "ip": "string",
      "ports": [
        {
          "port": "int",
          "protocol": "string"
        }
      ],
      "type": "string"
    },
    "networkProfile": {
      "id": "string"
    },
    "osType": "string",
    "restartPolicy": "string",
    "sku": "string",
    "volumes": [
      {
        "azureFile": {
          "readOnly": "bool",
          "shareName": "string",
          "storageAccountKey": "string",
          "storageAccountName": "string"
        },
        "emptyDir": {},
        "gitRepo": {
          "directory": "string",
          "repository": "string",
          "revision": "string"
        },
        "name": "string",
        "secret": {
          "{customized property}": "string"
        }
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.ContainerInstance/containerGroups

名前	形容	価値
apiVersion	API のバージョン	'2019-12-01'
ID	構成されている場合は、コンテナー グループの ID。	ContainerGroupIdentity
位置	リソースの場所。	文字列
名前	リソース名	string (必須)
プロパティ	コンテナー グループのプロパティ	ContainerGroupProperties (必須)
タグ	リソース タグ	タグ名と値のディクショナリ。 テンプレート の タグを参照してください
型	リソースの種類	'Microsoft.ContainerInstance/containerGroups'

AzureFileVolume

名前	形容	価値
readOnly	ボリュームとしてマウントされた Azure File 共有が読み取り専用かどうかを示すフラグ。	ブール (bool)
shareName	ボリュームとしてマウントする Azure ファイル共有の名前。	string (必須)
storageAccountKey	Azure ファイル共有へのアクセスに使用されるストレージ アカウント アクセス キー。	文字列
ストレージアカウント名	Azure ファイル共有を含むストレージ アカウントの名前。	string (必須)

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

名前	形容	価値

コンテナ

名前	形容	価値
名前	コンテナー インスタンスのユーザー指定の名前。	string (必須)
プロパティ	コンテナー インスタンスのプロパティ。	ContainerProperties (必須)

ContainerExec

名前	形容	価値
命令	コンテナー内で実行するコマンド。	string[]

ContainerGroupDiagnostics

名前	形容	価値
ログアナリティクス	コンテナー グループのログ分析情報。	LogAnalytics

ContainerGroupIdentity

名前	形容	価値
型	コンテナー グループに使用される ID の種類。 型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' は、コンテナー グループからすべての ID を削除します。	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	コンテナー グループに関連付けられているユーザー ID の一覧。 ユーザー ID ディクショナリ のキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。	ContainerGroupIdentityUserAssignedIdentities

ContainerGroupIdentityUserAssignedIdentities

名前	形容	価値

ContainerGroupNetworkProfile

名前	形容	価値
身分証明書	ネットワーク プロファイルの識別子。	string (必須)

ContainerGroupProperties

名前	形容	価値
コンテナー	コンテナー グループ内のコンテナー。	コンテナー[] (必須)
診断	コンテナー グループの診断情報。	ContainerGroupDiagnostics
dnsConfig	コンテナー グループの DNS 構成情報。	DnsConfiguration
encryptionProperties	コンテナー グループの暗号化プロパティ。	EncryptionProperties
imageRegistryCredentials	コンテナー グループの作成元のイメージ レジストリ資格情報。	ImageRegistryCredential[]
initContainers	コンテナー グループの init コンテナー。	InitContainerDefinition[]
ipAddress	コンテナー グループの IP アドレスの種類。	IpAddress の
networkProfile	コンテナー グループのネットワーク プロファイル情報。	ContainerGroupNetworkProfile
osType	コンテナー グループ内のコンテナーに必要なオペレーティング システムの種類。	'Linux' 'Windows' (必須)
restartPolicy	コンテナー グループ内のすべてのコンテナーのポリシーを再起動します。 - Always 常に再起動する - OnFailure 失敗した場合の再起動 - Never 再起動しない	'Always' 'Never' 'OnFailure'
エスケーユー	コンテナー グループの SKU。	'Dedicated' 'Standard'
ボリューム	このコンテナー グループ内のコンテナーによってマウントできるボリュームの一覧。	ボリューム[]

ContainerHttpGet

名前	形容	価値
パス	プローブするパス。	文字列
ポート	プローブするポート番号。	int (必須)
計画	スキーム。	'http' 'https'

ContainerPort

名前	形容	価値
ポート	コンテナー グループ内で公開されるポート番号。	int (必須)
プロトコル	ポートに関連付けられているプロトコル。	'TCP' 'UDP'

ContainerProbe

名前	形容	価値
exec	プローブする実行コマンド	ContainerExec
failureThreshold	エラーのしきい値。	整数 (int)
httpGet	プローブする Http Get 設定	ContainerHttpGet
initialDelaySeconds	最初の遅延秒数。	整数 (int)
periodSeconds	期間 (秒)。	整数 (int)
successThreshold	成功のしきい値。	整数 (int)
timeoutSeconds	タイムアウト秒数。	整数 (int)

ContainerProperties

名前	形容	価値
命令	コンテナー インスタンス内で exec 形式で実行するコマンド。	string[]
環境変数	コンテナー インスタンスで設定する環境変数。	EnvironmentVariable[]
イメージ	コンテナー インスタンスの作成に使用されるイメージの名前。	string (必須)
livenessProbe	ライブネス プローブ。	ContainerProbe
ポート	コンテナー インスタンスで公開されているポート。	ContainerPort[]
readinessProbe	準備プローブ。	ContainerProbe
リソース	コンテナー インスタンスのリソース要件。	ResourceRequirements (必須)
volumeMounts	コンテナー インスタンスで使用できるボリューム マウント。	VolumeMount[]

DnsConfiguration

名前	形容	価値
nameServers	コンテナー グループの DNS サーバー。	string[] (必須)
オプション	コンテナー グループの DNS オプション。	文字列
searchDomains	コンテナー グループ内のホスト名検索の DNS 検索ドメイン。	文字列

EncryptionProperties

名前	形容	価値
keyName	暗号化キーの名前。	string (必須)
keyVersion	暗号化キーのバージョン。	string (必須)
vaultBaseUrl	keyvault のベース URL。	string (必須)

EnvironmentVariable

名前	形容	価値
名前	環境変数の名前。	string (必須)
secureValue	セキュリティで保護された環境変数の値。	文字列
価値	環境変数の値。	文字列

GitRepoVolume

名前	形容	価値
ディレクトリ	ターゲット ディレクトリ名。 '..' を含めたり、先頭に含めたりすることはできません。 '.' が指定されている場合、ボリューム ディレクトリは Git リポジトリになります。 指定しない場合、ボリュームには、指定された名前の git リポジトリがサブディレクトリに含まれます。	文字列
リポジトリ	リポジトリ URL	string (必須)
改定	指定したリビジョンのコミット ハッシュ。	文字列

GpuResource

名前	形容	価値
数える	GPU リソースの数。	int (必須)
エスケーユー	GPU リソースの SKU。	'K80' 'P100' 'V100' (必須)

ImageRegistryCredential

名前	形容	価値
パスワード	プライベート レジストリのパスワード。	文字列
サーバー	"http" や "https" などのプロトコルのない Docker イメージ レジストリ サーバー。	string (必須)
ユーザー名	プライベート レジストリのユーザー名。	string (必須)

InitContainerDefinition

名前	形容	価値
名前	init コンテナーの名前。	string (必須)
プロパティ	init コンテナーのプロパティ。	InitContainerPropertiesDefinition (必須)

InitContainerPropertiesDefinition

名前	形容	価値
命令	init コンテナー内で exec 形式で実行するコマンド。	string[]
環境変数	init コンテナーで設定する環境変数。	EnvironmentVariable[]
イメージ	init コンテナーのイメージ。	文字列
volumeMounts	init コンテナーで使用できるボリューム マウント。	VolumeMount[]

IPアドレス

名前	形容	価値
dnsNameLabel	IP の Dns 名ラベル。	文字列
ip	パブリック インターネットに公開されている IP。	文字列
ポート	コンテナー グループで公開されているポートの一覧。	ポート[] (必須)
型	IP がパブリック インターネットまたはプライベート VNET に公開されるかどうかを指定します。	'Private' 'Public' (必須)

LogAnalytics

名前	形容	価値
logType	使用するログの種類。	'ContainerInsights' 'ContainerInstanceLogs'
メタデータ	ログ分析のメタデータ。	LogAnalyticsMetadata の
ワークスペースID	ログ分析のワークスペース ID	string (必須)
workspaceKey	ログ分析のワークスペース キー	string (必須)

LogAnalyticsMetadata

名前	形容	価値

港

名前	形容	価値
ポート	ポート番号。	int (必須)
プロトコル	ポートに関連付けられているプロトコル。	'TCP' 'UDP'

ResourceLimits

名前	形容	価値
cpu	このコンテナー インスタンスの CPU 制限。	整数 (int)
GPU	このコンテナー インスタンスの GPU 制限。	GpuResource の
memoryInGB	このコンテナー インスタンスのメモリ制限 (GB 単位)。	整数 (int)

ResourceRequests

名前	形容	価値
cpu	このコンテナー インスタンスの CPU 要求。	int (必須)
GPU	このコンテナー インスタンスの GPU 要求。	GpuResource の
memoryInGB	このコンテナー インスタンスのメモリ要求 (GB 単位)。	int (必須)

ResourceRequirements

名前	形容	価値
制限	このコンテナー インスタンスのリソース制限。	ResourceLimits
要求	このコンテナー インスタンスのリソース要求。	ResourceRequests (必須)

ResourceTags

名前	形容	価値

SecretVolume

名前	形容	価値

容積

名前	形容	価値
azureFile	Azure File ボリューム。	AzureFileVolume
emptyDir	空のディレクトリ ボリューム。	任意
gitRepo	Git リポジトリ ボリューム。	GitRepoVolume を する
名前	ボリュームの名前。	string (必須)
シークレット	シークレット ボリューム。	SecretVolume

VolumeMount

名前	形容	価値
mountPath	ボリュームをマウントするコンテナー内のパス。 コロン (:)を含めてはなりません。	string (必須)
名前	ボリューム マウントの名前。	string (必須)
readOnly	ボリューム マウントが読み取り専用かどうかを示すフラグ。	ブール (bool)

使用例

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

このリソースの種類 デプロイする Azure クイック スタート テンプレート 次に示します。

テンプレート	形容
azure Container Instances の - SQL Server と IIS を使用した BC Azure にデプロイする	Azure Container Instances に、完全に機能する自己完結型 Microsoft Dynamics 365 Business Central 環境を備えた単一の Windows コンテナーをデプロイします。
Azure Container Instances の - 正常性プローブが されたコンテナー Azure にデプロイする	Azure Container Instances を使用して、正常性プローブを持つ Linux コンテナーをデプロイします。
Azure Container Instances の - シークレットが されたコンテナー Azure にデプロイする	Azure Container Instances を使用して、シークレット ボリュームを持つ Linux コンテナーをデプロイします。
azure Container Instances の - セキュリティで保護された envVar を持つコンテナー Azure にデプロイする	Azure Container Instances を使用して、セキュリティで保護された環境変数を持つ Linux コンテナーをデプロイします。
azure Container Instances の - emptyDir を持つ Linux コンテナー Azure にデプロイする	Azure Container Instances を使用して、emptyDir ボリュームを共有する 2 つの Linux コンテナーをデプロイします。
azure Container Instances の - gitRepo を使用した Linux コンテナー Azure にデプロイする	Azure Container Instances を使用して gitRepo ボリュームを使用する Linux コンテナーをデプロイします。
Azure Container Instances の - パブリック IP を使用した Linux コンテナー Azure にデプロイする	Azure Container Instances を使用して、パブリック IP 経由でアクセスできる 1 つの Linux コンテナーをデプロイします。
Azure Container Instances の - VNet Azure にデプロイする	コンテナー インスタンスを Azure 仮想ネットワークにデプロイします。
コンテナー を使用してストレージ アカウント ファイル共有を作成する Azure にデプロイする	このテンプレートは、コンテナー インスタンスで azure-cli を使用してストレージ アカウントとファイル共有を作成します
WordPress サイト を作成する Azure にデプロイする	このテンプレートは、コンテナー インスタンスに WordPress サイトを作成します
仮想ネットワーク で WordPress サイトを作成する Azure にデプロイする	このテンプレートは、仮想ネットワーク内のコンテナー インスタンスに WordPress サイトを作成します。 WordPress サイトにアクセスできるパブリック サイトの FQDN を出力します。
永続ストレージ を使用してオンデマンド SFTP サーバーを作成する Azure にデプロイする	このテンプレートは、Azure Container Instance (ACI) を使用するオンデマンド SFTP サーバーを示しています。
証明書 を使用して Application Gateway を作成する Azure にデプロイする	このテンプレートでは、Key Vault の自己署名証明書を生成し、Application Gateway から参照する方法を示します。
Azure Container Instances を使用した Front Door Standard/Premium の Azure にデプロイする	このテンプレートは、コンテナー グループを使用して Front Door Standard/Premium を作成します。
コンテナー インスタンスと Application Gateway を使用した Front Door の Azure にデプロイする	このテンプレートは、コンテナー グループと Application Gateway を使用して Front Door Standard/Premium を作成します。
既存のストレージ アカウント を使用してオンデマンド SFTP サーバーを する Azure にデプロイする	このテンプレートは、Azure Container Instance (ACI) を使用するオンデマンド SFTP サーバーを示しています。
AKS での SQL Server 可用性グループの Azure にデプロイする	これにより、新しい AKS クラスターが作成され、Duffle と ACI を使用してデプロイされた CNAB パッケージを使用して SQL Server 可用性グループがデプロイされます
ACI での UDP コンテナーの Azure にデプロイする	このテンプレートは、ACI リソースを作成し、UDP を介してコンテナーを公開します

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

containerGroups リソースの種類は、次をターゲットとする操作でデプロイできます。

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

リソースの形式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerInstance/containerGroups@2019-12-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      containers = [
        {
          name = "string"
          properties = {
            command = [
              "string"
            ]
            environmentVariables = [
              {
                name = "string"
                secureValue = "string"
                value = "string"
              }
            ]
            image = "string"
            livenessProbe = {
              exec = {
                command = [
                  "string"
                ]
              }
              failureThreshold = int
              httpGet = {
                path = "string"
                port = int
                scheme = "string"
              }
              initialDelaySeconds = int
              periodSeconds = int
              successThreshold = int
              timeoutSeconds = int
            }
            ports = [
              {
                port = int
                protocol = "string"
              }
            ]
            readinessProbe = {
              exec = {
                command = [
                  "string"
                ]
              }
              failureThreshold = int
              httpGet = {
                path = "string"
                port = int
                scheme = "string"
              }
              initialDelaySeconds = int
              periodSeconds = int
              successThreshold = int
              timeoutSeconds = int
            }
            resources = {
              limits = {
                cpu = int
                gpu = {
                  count = int
                  sku = "string"
                }
                memoryInGB = int
              }
              requests = {
                cpu = int
                gpu = {
                  count = int
                  sku = "string"
                }
                memoryInGB = int
              }
            }
            volumeMounts = [
              {
                mountPath = "string"
                name = "string"
                readOnly = bool
              }
            ]
          }
        }
      ]
      diagnostics = {
        logAnalytics = {
          logType = "string"
          metadata = {
            {customized property} = "string"
          }
          workspaceId = "string"
          workspaceKey = "string"
        }
      }
      dnsConfig = {
        nameServers = [
          "string"
        ]
        options = "string"
        searchDomains = "string"
      }
      encryptionProperties = {
        keyName = "string"
        keyVersion = "string"
        vaultBaseUrl = "string"
      }
      imageRegistryCredentials = [
        {
          password = "string"
          server = "string"
          username = "string"
        }
      ]
      initContainers = [
        {
          name = "string"
          properties = {
            command = [
              "string"
            ]
            environmentVariables = [
              {
                name = "string"
                secureValue = "string"
                value = "string"
              }
            ]
            image = "string"
            volumeMounts = [
              {
                mountPath = "string"
                name = "string"
                readOnly = bool
              }
            ]
          }
        }
      ]
      ipAddress = {
        dnsNameLabel = "string"
        ip = "string"
        ports = [
          {
            port = int
            protocol = "string"
          }
        ]
        type = "string"
      }
      networkProfile = {
        id = "string"
      }
      osType = "string"
      restartPolicy = "string"
      sku = "string"
      volumes = [
        {
          azureFile = {
            readOnly = bool
            shareName = "string"
            storageAccountKey = "string"
            storageAccountName = "string"
          }
          emptyDir = ?
          gitRepo = {
            directory = "string"
            repository = "string"
            revision = "string"
          }
          name = "string"
          secret = {
            {customized property} = "string"
          }
        }
      ]
    }
  }
}

プロパティ値

Microsoft.ContainerInstance/containerGroups

名前	形容	価値
ID	構成されている場合は、コンテナー グループの ID。	ContainerGroupIdentity
位置	リソースの場所。	文字列
名前	リソース名	string (必須)
parent_id	この拡張リソースを適用するリソースの ID。	string (必須)
プロパティ	コンテナー グループのプロパティ	ContainerGroupProperties (必須)
タグ	リソース タグ	タグ名と値のディクショナリ。
型	リソースの種類	"Microsoft.ContainerInstance/containerGroups@2019-12-01"

AzureFileVolume

名前	形容	価値
readOnly	ボリュームとしてマウントされた Azure File 共有が読み取り専用かどうかを示すフラグ。	ブール (bool)
shareName	ボリュームとしてマウントする Azure ファイル共有の名前。	string (必須)
storageAccountKey	Azure ファイル共有へのアクセスに使用されるストレージ アカウント アクセス キー。	文字列
ストレージアカウント名	Azure ファイル共有を含むストレージ アカウントの名前。	string (必須)

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

名前	形容	価値

コンテナ

名前	形容	価値
名前	コンテナー インスタンスのユーザー指定の名前。	string (必須)
プロパティ	コンテナー インスタンスのプロパティ。	ContainerProperties (必須)

ContainerExec

名前	形容	価値
命令	コンテナー内で実行するコマンド。	string[]

ContainerGroupDiagnostics

名前	形容	価値
ログアナリティクス	コンテナー グループのログ分析情報。	LogAnalytics

ContainerGroupIdentity

名前	形容	価値
型	コンテナー グループに使用される ID の種類。 型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' は、コンテナー グループからすべての ID を削除します。	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	コンテナー グループに関連付けられているユーザー ID の一覧。 ユーザー ID ディクショナリ のキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。	ContainerGroupIdentityUserAssignedIdentities

ContainerGroupIdentityUserAssignedIdentities

名前	形容	価値

ContainerGroupNetworkProfile

名前	形容	価値
身分証明書	ネットワーク プロファイルの識別子。	string (必須)

ContainerGroupProperties

名前	形容	価値
コンテナー	コンテナー グループ内のコンテナー。	コンテナー[] (必須)
診断	コンテナー グループの診断情報。	ContainerGroupDiagnostics
dnsConfig	コンテナー グループの DNS 構成情報。	DnsConfiguration
encryptionProperties	コンテナー グループの暗号化プロパティ。	EncryptionProperties
imageRegistryCredentials	コンテナー グループの作成元のイメージ レジストリ資格情報。	ImageRegistryCredential[]
initContainers	コンテナー グループの init コンテナー。	InitContainerDefinition[]
ipAddress	コンテナー グループの IP アドレスの種類。	IpAddress の
networkProfile	コンテナー グループのネットワーク プロファイル情報。	ContainerGroupNetworkProfile
osType	コンテナー グループ内のコンテナーに必要なオペレーティング システムの種類。	'Linux' 'Windows' (必須)
restartPolicy	コンテナー グループ内のすべてのコンテナーのポリシーを再起動します。 - Always 常に再起動する - OnFailure 失敗した場合の再起動 - Never 再起動しない	'Always' 'Never' 'OnFailure'
エスケーユー	コンテナー グループの SKU。	'Dedicated' 'Standard'
ボリューム	このコンテナー グループ内のコンテナーによってマウントできるボリュームの一覧。	ボリューム[]

ContainerHttpGet

名前	形容	価値
パス	プローブするパス。	文字列
ポート	プローブするポート番号。	int (必須)
計画	スキーム。	'http' 'https'

ContainerPort

名前	形容	価値
ポート	コンテナー グループ内で公開されるポート番号。	int (必須)
プロトコル	ポートに関連付けられているプロトコル。	'TCP' 'UDP'

ContainerProbe

名前	形容	価値
exec	プローブする実行コマンド	ContainerExec
failureThreshold	エラーのしきい値。	整数 (int)
httpGet	プローブする Http Get 設定	ContainerHttpGet
initialDelaySeconds	最初の遅延秒数。	整数 (int)
periodSeconds	期間 (秒)。	整数 (int)
successThreshold	成功のしきい値。	整数 (int)
timeoutSeconds	タイムアウト秒数。	整数 (int)

ContainerProperties

名前	形容	価値
命令	コンテナー インスタンス内で exec 形式で実行するコマンド。	string[]
環境変数	コンテナー インスタンスで設定する環境変数。	EnvironmentVariable[]
イメージ	コンテナー インスタンスの作成に使用されるイメージの名前。	string (必須)
livenessProbe	ライブネス プローブ。	ContainerProbe
ポート	コンテナー インスタンスで公開されているポート。	ContainerPort[]
readinessProbe	準備プローブ。	ContainerProbe
リソース	コンテナー インスタンスのリソース要件。	ResourceRequirements (必須)
volumeMounts	コンテナー インスタンスで使用できるボリューム マウント。	VolumeMount[]

DnsConfiguration

名前	形容	価値
nameServers	コンテナー グループの DNS サーバー。	string[] (必須)
オプション	コンテナー グループの DNS オプション。	文字列
searchDomains	コンテナー グループ内のホスト名検索の DNS 検索ドメイン。	文字列

EncryptionProperties

名前	形容	価値
keyName	暗号化キーの名前。	string (必須)
keyVersion	暗号化キーのバージョン。	string (必須)
vaultBaseUrl	keyvault のベース URL。	string (必須)

EnvironmentVariable

名前	形容	価値
名前	環境変数の名前。	string (必須)
secureValue	セキュリティで保護された環境変数の値。	文字列
価値	環境変数の値。	文字列

GitRepoVolume

名前	形容	価値
ディレクトリ	ターゲット ディレクトリ名。 '..' を含めたり、先頭に含めたりすることはできません。 '.' が指定されている場合、ボリューム ディレクトリは Git リポジトリになります。 指定しない場合、ボリュームには、指定された名前の git リポジトリがサブディレクトリに含まれます。	文字列
リポジトリ	リポジトリ URL	string (必須)
改定	指定したリビジョンのコミット ハッシュ。	文字列

GpuResource

名前	形容	価値
数える	GPU リソースの数。	int (必須)
エスケーユー	GPU リソースの SKU。	'K80' 'P100' 'V100' (必須)

ImageRegistryCredential

名前	形容	価値
パスワード	プライベート レジストリのパスワード。	文字列
サーバー	"http" や "https" などのプロトコルのない Docker イメージ レジストリ サーバー。	string (必須)
ユーザー名	プライベート レジストリのユーザー名。	string (必須)

InitContainerDefinition

名前	形容	価値
名前	init コンテナーの名前。	string (必須)
プロパティ	init コンテナーのプロパティ。	InitContainerPropertiesDefinition (必須)

InitContainerPropertiesDefinition

名前	形容	価値
命令	init コンテナー内で exec 形式で実行するコマンド。	string[]
環境変数	init コンテナーで設定する環境変数。	EnvironmentVariable[]
イメージ	init コンテナーのイメージ。	文字列
volumeMounts	init コンテナーで使用できるボリューム マウント。	VolumeMount[]

IPアドレス

名前	形容	価値
dnsNameLabel	IP の Dns 名ラベル。	文字列
ip	パブリック インターネットに公開されている IP。	文字列
ポート	コンテナー グループで公開されているポートの一覧。	ポート[] (必須)
型	IP がパブリック インターネットまたはプライベート VNET に公開されるかどうかを指定します。	'Private' 'Public' (必須)

LogAnalytics

名前	形容	価値
logType	使用するログの種類。	'ContainerInsights' 'ContainerInstanceLogs'
メタデータ	ログ分析のメタデータ。	LogAnalyticsMetadata の
ワークスペースID	ログ分析のワークスペース ID	string (必須)
workspaceKey	ログ分析のワークスペース キー	string (必須)

LogAnalyticsMetadata

名前	形容	価値

港

名前	形容	価値
ポート	ポート番号。	int (必須)
プロトコル	ポートに関連付けられているプロトコル。	'TCP' 'UDP'

ResourceLimits

名前	形容	価値
cpu	このコンテナー インスタンスの CPU 制限。	整数 (int)
GPU	このコンテナー インスタンスの GPU 制限。	GpuResource の
memoryInGB	このコンテナー インスタンスのメモリ制限 (GB 単位)。	整数 (int)

ResourceRequests

名前	形容	価値
cpu	このコンテナー インスタンスの CPU 要求。	int (必須)
GPU	このコンテナー インスタンスの GPU 要求。	GpuResource の
memoryInGB	このコンテナー インスタンスのメモリ要求 (GB 単位)。	int (必須)

ResourceRequirements

名前	形容	価値
制限	このコンテナー インスタンスのリソース制限。	ResourceLimits
要求	このコンテナー インスタンスのリソース要求。	ResourceRequests (必須)

ResourceTags

名前	形容	価値

SecretVolume

名前	形容	価値

容積

名前	形容	価値
azureFile	Azure File ボリューム。	AzureFileVolume
emptyDir	空のディレクトリ ボリューム。	任意
gitRepo	Git リポジトリ ボリューム。	GitRepoVolume を する
名前	ボリュームの名前。	string (必須)
シークレット	シークレット ボリューム。	SecretVolume

VolumeMount

名前	形容	価値
mountPath	ボリュームをマウントするコンテナー内のパス。 コロン (:)を含めてはなりません。	string (必須)
名前	ボリューム マウントの名前。	string (必須)
readOnly	ボリューム マウントが読み取り専用かどうかを示すフラグ。	ブール (bool)

使用例

Terraformサンプル

Azure コンテナー グループ インスタンスのデプロイの基本的な例。

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "containerGroup" {
  type      = "Microsoft.ContainerInstance/containerGroups@2023-05-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      containers = [
        {
          name = "hw"
          properties = {
            command = [
            ]
            environmentVariables = [
            ]
            image = "ubuntu:20.04"
            ports = [
              {
                port     = 80
                protocol = "TCP"
              },
            ]
            resources = {
              requests = {
                cpu        = 0.5
                memoryInGB = 0.5
              }
            }
          }
        },
      ]
      initContainers = [
      ]
      ipAddress = {
        autoGeneratedDomainNameLabelScope = "Unsecure"
        ports = [
          {
            port     = 80
            protocol = "TCP"
          },
        ]
        type = "Public"
      }
      osType        = "Linux"
      restartPolicy = "Always"
      volumes = [
      ]
    }
    tags = {
      environment = "Testing"
    }
    zones = [
    ]
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Azure 検証済みモジュール

次の Azure 検証済みモジュール を使用して、このリソースの種類をデプロイできます。

モジュール	形容
コンテナインスタンス	コンテナー インスタンスの AVM リソース モジュール