共用方式為


Microsoft.ContainerInstance containerGroups 2017-10-01-preview

Bicep 資源定義

containerGroups 資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.ContainerInstance/containerGroups 資源,請將下列 Bicep 新增至您的範本。

resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2017-10-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    containers: [
      {
        name: 'string'
        properties: {
          command: [
            'string'
          ]
          environmentVariables: [
            {
              name: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          ports: [
            {
              port: int
              protocol: 'string'
            }
          ]
          resources: {
            limits: {
              cpu: int
              memoryInGB: json('decimal-as-string')
            }
            requests: {
              cpu: int
              memoryInGB: json('decimal-as-string')
            }
          }
          volumeMounts: [
            {
              mountPath: 'string'
              name: 'string'
              readOnly: bool
            }
          ]
        }
      }
    ]
    imageRegistryCredentials: [
      {
        password: 'string'
        server: 'string'
        username: 'string'
      }
    ]
    ipAddress: {
      ip: 'string'
      ports: [
        {
          port: int
          protocol: 'string'
        }
      ]
      type: 'Public'
    }
    osType: 'string'
    restartPolicy: 'string'
    volumes: [
      {
        azureFile: {
          readOnly: bool
          shareName: 'string'
          storageAccountKey: 'string'
          storageAccountName: 'string'
        }
        emptyDir: any()
        name: 'string'
      }
    ]
  }
}

屬性值

containerGroups

名稱 描述
NAME 資源名稱 需要字串 ()

字元限制:1-63

合法字元:
小寫字母、數字和連字號。

不能以連字號開頭或結尾。 不允許連續的連字號。
location 資源位置。 需要字串 ()
tags 資源標籤。 標記名稱和值的字典。 請參閱 範本中的標籤
properties ContainerGroupProperties (必要)

ContainerGroupProperties

名稱 描述
containers 容器群組中的容器。 Container[] 必要) (
imageRegistryCredentials 建立容器群組的來源映像登錄認證。 ImageRegistryCredential[]
ipAddress 容器群組的 IP 位址類型。 IpAddress
osType 容器群組中容器所需的作業系統類型。 'Linux'
需要 『Windows』 ()
restartPolicy 容器群組中所有容器的重新啟動原則。
- Always 一律重新啟動
- OnFailure 失敗時重新啟動
- Never 永不重新啟動
'Always'
'Never'
'OnFailure'
磁碟區 此容器群組中容器可裝載的磁碟區清單。 Volume[]

容器

名稱 描述
NAME 容器執行個體的使用者提供名稱。 需要字串 ()
properties 容器執行個體的屬性。 ContainerProperties (必要)

ContainerProperties

名稱 描述
命令 容器執行個體中以 exec 格式執行的命令。 string[]
environmentVariables 容器執行個體中設定的環境變數。 EnvironmentVariable[]
image 建立容器執行個體使用的映像名稱。 字串 (必要)
連接埠 容器執行個體上公開的連接埠。 ContainerPort[]
resources 容器執行個體的資源需求。 ResourceRequirements (必要)
volumeMounts 容器執行個體可用的磁碟區裝載。 VolumeMount[]

EnvironmentVariable

名稱 描述
NAME 環境變數的名稱。 字串 (必要)
環境變數的值。 字串 (必要)

ContainerPort

名稱 描述
連接埠 容器群組中公開的連接埠號碼。 int (必要)
protocol 連接埠相關的通訊協定。 'TCP'
'UDP'

ResourceRequirements

名稱 描述
限制 此容器執行個體的資源限制。 ResourceLimits
requests 此容器執行個體的資源要求。 ResourceRequests (必要)

ResourceLimits

名稱 描述
cpu 此容器執行個體的 CPU 限制。 int
memoryInGB 此容器執行個體的記憶體限制 GB。 若要指定十進位值,請使用 json () 函式。 int 或 json decimal

ResourceRequests

名稱 描述
cpu 此容器執行個體的 CPU 要求。 int (必要)
memoryInGB 此容器執行個體的記憶體要求 GB。 若要指定十進位值,請使用 json () 函式。 int 或 json 十進位 (必要)

VolumeMount

名稱 描述
mountPath 容器中磁碟區的裝載路徑。 不得包含冒號 (:)。 字串 (必要)
NAME 磁碟區裝載的名稱。 字串 (必要)
readOnly 此旗標指出磁碟區裝載是否為唯讀。 bool

ImageRegistryCredential

名稱 描述
password 私人登錄的密碼。 字串
伺服器 Docker 映像登錄伺服器不具通訊協定 (例如「http」和「https」)。 字串 (必要)
使用者名稱 私人登錄的使用者名稱。 字串 (必要)

IpAddress

名稱 描述
ip 公開至公用網際網路的 IP。 字串
連接埠 容器群組上公開的連接埠清單。 Port[] (必要)
類型 指定IP是否公開至公用因特網。 必要) 'Public' (

連接埠

名稱 描述
連接埠 連接埠號碼。 需要 int ()
protocol 連接埠相關的通訊協定。 'TCP'
'UDP'

磁碟區

名稱 描述
azureFile Azure 檔案磁碟區的名稱。 AzureFileVolume
emptyDir 空白的目錄磁碟區。 針對 Bicep,您可以使用 any () 函式。
NAME 磁碟區的名稱。 需要字串 ()

AzureFileVolume

名稱 描述
readOnly 此旗標指出作為磁碟區裝載的 Azure 檔案共用是否為唯讀。 bool
shareName 作為磁碟區裝載的 Azure 檔案共用名稱。 需要字串 ()
storageAccountKey 存取 Azure 檔案共用使用的儲存體帳戶存取金鑰。 字串
storageAccountName 包含 Azure 檔案共用的儲存體帳戶名稱。 需要字串 ()

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
在 AKS 上 SQL Server 可用性群組

部署至 Azure
這會建立新的 AKS 叢集,然後使用使用 Duffle 和 ACI 部署的 CNAB 套件,將 SQL Server 可用性群組部署到其中
建立 WordPress 網站

部署至 Azure
此範本會在容器實例上建立 WordPress 網站
在虛擬網路中建立 WordPress 網站

部署至 Azure
此範本會在虛擬網路中的容器實例上建立 WordPress 網站。 並輸出可存取 WordPress 網站的公用網站 FQDN。
Azure 容器執行個體 - BC 搭配 SQL Server 和 IIS

部署至 Azure
在 Azure 容器執行個體 上部署具有完整功能獨立 Microsoft Dynamics 365 Business Central 環境的單一 Windows 容器。
具有 容器執行個體 和 應用程式閘道 的 Front Door

部署至 Azure
此範本會建立具有容器群組和 應用程式閘道 的 Front Door Standard/Premium。
具有 Azure 容器執行個體 的 Front Door Standard/Premium

部署至 Azure
此範本會建立具有容器群組的 Front Door Standard/Premium。
Azure 容器執行個體 - 具有健康情況探查的容器

部署至 Azure
使用 Azure 容器執行個體 部署具有健康情況探查的Linux容器。
Azure 容器執行個體 - 具有公用IP的Linux容器

部署至 Azure
使用 Azure 容器執行個體,部署可透過公用IP存取的單一Linux容器。
Azure 容器執行個體 - 具有安全 envVar 的容器

部署至 Azure
使用 Azure 容器執行個體 部署具有安全環境變數的Linux容器。
Azure 容器執行個體 - 具有 emptyDir 的 Linux 容器

部署至 Azure
部署兩個使用 Azure 容器執行個體 共用 emptyDir 磁碟區的 Linux 容器。
Azure 容器執行個體 - Linux 容器與 gitRepo

部署至 Azure
使用 Azure 容器執行個體 部署使用 gitRepo 磁碟區的 Linux 容器。
Azure 容器執行個體 - 具有秘密的容器

部署至 Azure
使用 Azure 容器執行個體 部署具有秘密磁碟區的Linux容器。
建立具有永續性記憶體的隨選 SFTP 伺服器

部署至 Azure
此範本示範使用 Azure 容器實例的隨選 SFTP 伺服器, (ACI) 。
使用現有記憶體帳戶的隨選 SFTP 伺服器

部署至 Azure
此範本示範使用 Azure 容器實例的隨選 SFTP 伺服器, (ACI) 。
透過容器建立記憶體帳戶檔案共用

部署至 Azure
此範本會透過容器實例中的 azure-cli 建立記憶體帳戶和檔案共用
ACI 中的 UDP 容器

部署至 Azure
此範本會建立 ACI 資源,並透過 UDP 公開容器
Azure 容器執行個體 - VNet

部署至 Azure
將容器實例部署至 Azure 虛擬網路。
使用憑證建立 應用程式閘道

部署至 Azure
此範本示範如何產生 金鑰保存庫 自我簽署憑證,然後從 應用程式閘道 參考。

ARM 範本資源定義

containerGroups 資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.ContainerInstance/containerGroups 資源,請將下列 JSON 新增至您的範本。

{
  "type": "Microsoft.ContainerInstance/containerGroups",
  "apiVersion": "2017-10-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "containers": [
      {
        "name": "string",
        "properties": {
          "command": [ "string" ],
          "environmentVariables": [
            {
              "name": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "ports": [
            {
              "port": "int",
              "protocol": "string"
            }
          ],
          "resources": {
            "limits": {
              "cpu": "int",
              "memoryInGB": "[json('decimal-as-string')]"
            },
            "requests": {
              "cpu": "int",
              "memoryInGB": "[json('decimal-as-string')]"
            }
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "name": "string",
              "readOnly": "bool"
            }
          ]
        }
      }
    ],
    "imageRegistryCredentials": [
      {
        "password": "string",
        "server": "string",
        "username": "string"
      }
    ],
    "ipAddress": {
      "ip": "string",
      "ports": [
        {
          "port": "int",
          "protocol": "string"
        }
      ],
      "type": "Public"
    },
    "osType": "string",
    "restartPolicy": "string",
    "volumes": [
      {
        "azureFile": {
          "readOnly": "bool",
          "shareName": "string",
          "storageAccountKey": "string",
          "storageAccountName": "string"
        },
        "emptyDir": {},
        "name": "string"
      }
    ]
  }
}

屬性值

containerGroups

名稱 描述
類型 資源類型 'Microsoft.ContainerInstance/containerGroups'
apiVersion 資源 API 版本 '2017-10-01-preview'
NAME 資源名稱 需要字串 ()

字元限制:1-63

合法字元:
小寫字母、數字和連字號。

不能以連字號開頭或結尾。 不允許連續的連字號。
location 資源位置。 需要字串 ()
tags 資源標籤。 標記名稱和值的字典。 請參閱 範本中的標籤
properties ContainerGroupProperties (必要)

ContainerGroupProperties

名稱 描述
containers 容器群組中的容器。 Container[] 必要) (
imageRegistryCredentials 建立容器群組的來源映像登錄認證。 ImageRegistryCredential[]
ipAddress 容器群組的 IP 位址類型。 IpAddress
osType 容器群組中容器所需的作業系統類型。 'Linux'
需要 『Windows』 ()
restartPolicy 容器群組中所有容器的重新啟動原則。
- Always 一律重新啟動
- OnFailure 失敗時重新啟動
- Never 永不重新啟動
'Always'
'Never'
'OnFailure'
磁碟區 此容器群組中容器可裝載的磁碟區清單。 Volume[]

容器

名稱 描述
NAME 容器執行個體的使用者提供名稱。 需要字串 ()
properties 容器執行個體的屬性。 ContainerProperties (必要)

ContainerProperties

名稱 描述
命令 容器執行個體中以 exec 格式執行的命令。 string[]
environmentVariables 容器執行個體中設定的環境變數。 EnvironmentVariable[]
image 建立容器執行個體使用的映像名稱。 需要字串 ()
連接埠 容器執行個體上公開的連接埠。 ContainerPort[]
resources 容器執行個體的資源需求。 ResourceRequirements (必要)
volumeMounts 容器執行個體可用的磁碟區裝載。 VolumeMount[]

EnvironmentVariable

名稱 描述
NAME 環境變數的名稱。 字串 (必要)
環境變數的值。 字串 (必要)

ContainerPort

名稱 描述
連接埠 容器群組中公開的連接埠號碼。 int (必要)
protocol 連接埠相關的通訊協定。 'TCP'
'UDP'

ResourceRequirements

名稱 描述
限制 此容器執行個體的資源限制。 ResourceLimits
requests 此容器執行個體的資源要求。 ResourceRequests (必要)

ResourceLimits

名稱 描述
cpu 此容器執行個體的 CPU 限制。 int
memoryInGB 此容器執行個體的記憶體限制 GB。 若要指定十進位值,請使用 json () 函式。 int 或 json decimal

ResourceRequests

名稱 描述
cpu 此容器執行個體的 CPU 要求。 int (必要)
memoryInGB 此容器執行個體的記憶體要求 GB。 若要指定十進位值,請使用 json () 函式。 int 或 json 十進位 (必要)

VolumeMount

名稱 描述
mountPath 容器中磁碟區的裝載路徑。 不得包含冒號 (:)。 字串 (必要)
NAME 磁碟區裝載的名稱。 字串 (必要)
readOnly 此旗標指出磁碟區裝載是否為唯讀。 bool

ImageRegistryCredential

名稱 描述
password 私人登錄的密碼。 字串
伺服器 Docker 映像登錄伺服器不具通訊協定 (例如「http」和「https」)。 字串 (必要)
使用者名稱 私人登錄的使用者名稱。 字串 (必要)

IpAddress

名稱 描述
ip 公開至公用網際網路的 IP。 字串
連接埠 容器群組上公開的連接埠清單。 [] (必要)
類型 指定IP是否公開給公用因特網。 必要) 'Public' (

連接埠

名稱 描述
連接埠 連接埠號碼。 int (必要)
protocol 連接埠相關的通訊協定。 'TCP'
'UDP'

磁碟區

名稱 描述
azureFile Azure 檔案磁碟區的名稱。 AzureFileVolume
emptyDir 空白的目錄磁碟區。
NAME 磁碟區的名稱。 需要字串 ()

AzureFileVolume

名稱 描述
readOnly 此旗標指出作為磁碟區裝載的 Azure 檔案共用是否為唯讀。 bool
shareName 作為磁碟區裝載的 Azure 檔案共用名稱。 需要字串 ()
storageAccountKey 存取 Azure 檔案共用使用的儲存體帳戶存取金鑰。 字串
storageAccountName 包含 Azure 檔案共用的儲存體帳戶名稱。 需要字串 ()

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
在 AKS 上 SQL Server 可用性群組

部署至 Azure
這會建立新的 AKS 叢集,然後使用使用 Duffle 和 ACI 部署的 CNAB 套件,將 SQL Server 可用性群組部署到其中
建立 WordPress 網站

部署至 Azure
此範本會在容器實例上建立 WordPress 網站
在虛擬網路中建立 WordPress 網站

部署至 Azure
此範本會在虛擬網路中的容器實例上建立 WordPress 網站。 並輸出可存取 WordPress 網站的公用網站 FQDN。
Azure 容器執行個體 - BC 搭配 SQL Server 和 IIS

部署至 Azure
在 Azure 容器執行個體 上部署具有完整功能獨立 Microsoft Dynamics 365 Business Central 環境的單一 Windows 容器。
具有 容器執行個體 和 應用程式閘道 的 Front Door

部署至 Azure
此範本會建立具有容器群組和 應用程式閘道 的 Front Door Standard/Premium。
Front Door Standard/Premium with Azure 容器執行個體

部署至 Azure
此範本會建立具有容器群組的 Front Door Standard/Premium。
Azure 容器執行個體 - 具有健康情況探查的容器

部署至 Azure
使用 Azure 容器執行個體 部署具有健康情況探查的Linux容器。
Azure 容器執行個體 - 具有公用IP的Linux容器

部署至 Azure
使用 Azure 容器執行個體,部署可透過公用IP存取的單一Linux容器。
Azure 容器執行個體 - 具有安全 envVar 的容器

部署至 Azure
使用 Azure 容器執行個體 部署具有安全環境變數的Linux容器。
Azure 容器執行個體 - 具有 emptyDir 的 Linux 容器

部署至 Azure
部署兩個使用 Azure 容器執行個體 共用 emptyDir 磁碟區的 Linux 容器。
Azure 容器執行個體 - Linux 容器與 gitRepo

部署至 Azure
使用 Azure 容器執行個體 部署使用 gitRepo 磁碟區的 Linux 容器。
Azure 容器執行個體 - 具有秘密的容器

部署至 Azure
使用 Azure 容器執行個體 部署具有秘密磁碟區的Linux容器。
建立具有永續性記憶體的隨選 SFTP 伺服器

部署至 Azure
此範本示範使用 Azure 容器實例的隨選 SFTP 伺服器, (ACI) 。
使用現有記憶體帳戶的隨選 SFTP 伺服器

部署至 Azure
此範本示範使用 Azure 容器實例的隨選 SFTP 伺服器, (ACI) 。
透過容器建立記憶體帳戶檔案共用

部署至 Azure
此範本會透過容器實例中的 azure-cli 建立記憶體帳戶和檔案共用
ACI 中的 UDP 容器

部署至 Azure
此範本會建立 ACI 資源,並透過 UDP 公開容器
Azure 容器執行個體 - VNet

部署至 Azure
將容器實例部署至 Azure 虛擬網路。
使用憑證建立 應用程式閘道

部署至 Azure
此範本示範如何產生 金鑰保存庫 自我簽署憑證,然後從 應用程式閘道 參考。

Terraform (AzAPI 提供者) 資源定義

containerGroups 資源類型可以使用目標作業來部署:

  • 資源群組

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.ContainerInstance/containerGroups 資源,請將下列 Terraform 新增至範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerInstance/containerGroups@2017-10-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      containers = [
        {
          name = "string"
          properties = {
            command = [
              "string"
            ]
            environmentVariables = [
              {
                name = "string"
                value = "string"
              }
            ]
            image = "string"
            ports = [
              {
                port = int
                protocol = "string"
              }
            ]
            resources = {
              limits = {
                cpu = int
                memoryInGB = "decimal-as-string"
              }
              requests = {
                cpu = int
                memoryInGB = "decimal-as-string"
              }
            }
            volumeMounts = [
              {
                mountPath = "string"
                name = "string"
                readOnly = bool
              }
            ]
          }
        }
      ]
      imageRegistryCredentials = [
        {
          password = "string"
          server = "string"
          username = "string"
        }
      ]
      ipAddress = {
        ip = "string"
        ports = [
          {
            port = int
            protocol = "string"
          }
        ]
        type = "Public"
      }
      osType = "string"
      restartPolicy = "string"
      volumes = [
        {
          azureFile = {
            readOnly = bool
            shareName = "string"
            storageAccountKey = "string"
            storageAccountName = "string"
          }
          name = "string"
        }
      ]
    }
  })
}

屬性值

containerGroups

名稱 描述
類型 資源類型 “Microsoft.ContainerInstance/containerGroups@2017-10-01-preview”
NAME 資源名稱 字串 (必要)

字元限制:1-63

合法字元:
小寫字母、數字和連字號。

不能以連字號開頭或結尾。 不允許連續的連字號。
location 資源位置。 字串 (必要)
parent_id 若要部署至資源群組,請使用該資源群組的標識碼。 字串 (必要)
tags 資源標籤。 標記名稱和值的字典。
properties ContainerGroupProperties (必要)

ContainerGroupProperties

名稱 描述
containers 容器群組中的容器。 Container[] (必要)
imageRegistryCredentials 建立容器群組的來源映像登錄認證。 ImageRegistryCredential[]
ipAddress 容器群組的 IP 位址類型。 IpAddress
osType 容器群組中容器所需的作業系統類型。 "Linux"
“Windows” (必要)
restartPolicy 容器群組中所有容器的重新啟動原則。
- Always 一律重新啟動
- OnFailure 失敗時重新啟動
- Never 永不重新啟動
“Always”
“Never”
“OnFailure”
磁碟區 此容器群組中容器可裝載的磁碟區清單。 Volume[]

容器

名稱 描述
NAME 容器執行個體的使用者提供名稱。 字串 (必要)
properties 容器執行個體的屬性。 ContainerProperties (必要)

ContainerProperties

名稱 描述
命令 容器執行個體中以 exec 格式執行的命令。 string[]
environmentVariables 容器執行個體中設定的環境變數。 EnvironmentVariable[]
image 建立容器執行個體使用的映像名稱。 字串 (必要)
連接埠 容器執行個體上公開的連接埠。 ContainerPort[]
resources 容器執行個體的資源需求。 ResourceRequirements (必要)
volumeMounts 容器執行個體可用的磁碟區裝載。 VolumeMount[]

EnvironmentVariable

名稱 描述
NAME 環境變數的名稱。 字串 (必要)
環境變數的值。 字串 (必要)

ContainerPort

名稱 描述
連接埠 容器群組中公開的連接埠號碼。 int (必要)
protocol 連接埠相關的通訊協定。 “TCP”
“UDP”

ResourceRequirements

名稱 描述
限制 此容器執行個體的資源限制。 ResourceLimits
requests 此容器執行個體的資源要求。 ResourceRequests (必要)

ResourceLimits

名稱 描述
cpu 此容器執行個體的 CPU 限制。 int
memoryInGB 此容器執行個體的記憶體限制 GB。 將十進位值指定為字串。 int 或 json decimal

ResourceRequests

名稱 描述
cpu 此容器執行個體的 CPU 要求。 int (必要)
memoryInGB 此容器執行個體的記憶體要求 GB。 將十進位值指定為字串。 int 或 json 十進位 (必要)

VolumeMount

名稱 描述
mountPath 容器中磁碟區的裝載路徑。 不得包含冒號 (:)。 字串 (必要)
NAME 磁碟區裝載的名稱。 字串 (必要)
readOnly 此旗標指出磁碟區裝載是否為唯讀。 bool

ImageRegistryCredential

名稱 描述
password 私人登錄的密碼。 字串
伺服器 Docker 映像登錄伺服器不具通訊協定 (例如「http」和「https」)。 字串 (必要)
使用者名稱 私人登錄的使用者名稱。 字串 (必要)

IpAddress

名稱 描述
ip 公開至公用網際網路的 IP。 字串
連接埠 容器群組上公開的連接埠清單。 [] (必要)
類型 指定IP是否公開給公用因特網。 「公用」 (必要)

連接埠

名稱 描述
連接埠 連接埠號碼。 int (必要)
protocol 連接埠相關的通訊協定。 “TCP”
“UDP”

磁碟區

名稱 描述
azureFile Azure 檔案磁碟區的名稱。 AzureFileVolume
emptyDir 空白的目錄磁碟區。
NAME 磁碟區的名稱。 字串 (必要)

AzureFileVolume

名稱 描述
readOnly 此旗標指出作為磁碟區裝載的 Azure 檔案共用是否為唯讀。 bool
shareName 作為磁碟區裝載的 Azure 檔案共用名稱。 需要字串 ()
storageAccountKey 存取 Azure 檔案共用使用的儲存體帳戶存取金鑰。 字串
storageAccountName 包含 Azure 檔案共用的儲存體帳戶名稱。 需要字串 ()