Microsoft.ContainerInstance/containerGroups 2018-10-01 - Bicep, ARM template & Terraform AzAPI reference

Definição de recurso do Bicep

O tipo de recurso containerGroups pode ser implantado com operações de destino:

Grupos de recursos - Consulte comandos de implantação do grupo de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o Bicep a seguir ao modelo.

resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2018-10-01' = {
  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'
    }
    imageRegistryCredentials: [
      {
        password: 'string'
        server: 'string'
        username: 'string'
      }
    ]
    ipAddress: {
      dnsNameLabel: 'string'
      ip: 'string'
      ports: [
        {
          port: int
          protocol: 'string'
        }
      ]
      type: 'string'
    }
    networkProfile: {
      id: 'string'
    }
    osType: 'string'
    restartPolicy: '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'
  }
}

Valores da propriedade

AzureFileVolume

Nome	Descrição	Valor
readOnly	O sinalizador que indica se o Arquivo do Azure compartilhado montado como um volume é somente leitura.	Bool
shareName	O nome do compartilhamento de Arquivos do Azure a ser montado como um volume.	cadeia de caracteres (obrigatório)
storageAccountKey	A chave de acesso da conta de armazenamento usada para acessar o compartilhamento de Arquivos do Azure.	corda
storageAccountName	O nome da conta de armazenamento que contém o compartilhamento de arquivos do Azure.	cadeia de caracteres (obrigatório)

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome	Descrição	Valor

Recipiente

Nome	Descrição	Valor
nome	O nome fornecido pelo usuário da instância de contêiner.	cadeia de caracteres (obrigatório)
Propriedades	As propriedades da instância de contêiner.	containerProperties (obrigatório)

ContainerExec

Nome	Descrição	Valor
comando	Os comandos a serem executados dentro do contêiner.	string[]

ContainerGroupDiagnostics

Nome	Descrição	Valor
logAnalytics	Informações do log analytics do grupo de contêineres.	do LogAnalytics

ContainerGroupIdentity

Nome	Descrição	Valor
tipo	O tipo de identidade usado para o grupo de contêineres. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá as identidades do grupo de contêineres.	'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	A lista de identidades de usuário associadas ao grupo de contêineres. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	ContainerGroupIdentityUserAssignedIdentities

ContainerGroupIdentityUserAssignedIdentities

Nome	Descrição	Valor

ContainerGroupNetworkProfile

Nome	Descrição	Valor
id	O identificador de um perfil de rede.	cadeia de caracteres (obrigatório)

ContainerGroupProperties

Nome	Descrição	Valor
Recipientes	Os contêineres dentro do grupo de contêineres.	de contêiner [] (obrigatório)
Diagnostics	As informações de diagnóstico de um grupo de contêineres.	ContainerGroupDiagnostics
dnsConfig	As informações de configuração de DNS para um grupo de contêineres.	DnsConfiguration
imageRegistryCredentials	As credenciais do registro de imagem pelas quais o grupo de contêineres é criado.	ImageRegistryCredential []
ipAddress	O tipo de endereço IP do grupo de contêineres.	ipAddress
networkProfile	As informações de perfil de rede de um grupo de contêineres.	ContainerGroupNetworkProfile
osType	O tipo de sistema operacional exigido pelos contêineres no grupo de contêineres.	'Linux' 'Windows' (obrigatório)
restartPolicy	Reinicie a política para todos os contêineres dentro do grupo de contêineres. - `Always` Sempre reiniciar - `OnFailure` Reiniciar com falha - `Never` Nunca reiniciar	'Always' 'Nunca' 'OnFailure'
Volumes	A lista de volumes que podem ser montados por contêineres neste grupo de contêineres.	de volume []

ContainerHttpGet

Nome	Descrição	Valor
caminho	O caminho para a investigação.	corda
porta	O número da porta a ser sondado.	int (obrigatório)
esquema	O esquema.	'http' 'https'

ContainerPort

Nome	Descrição	Valor
porta	O número da porta exposto no grupo de contêineres.	int (obrigatório)
protocolo	O protocolo associado à porta.	'TCP' 'UDP'

ContainerProbe

Nome	Descrição	Valor
Exec	O comando de execução a ser sondado	ContainerExec
failureThreshold	O limite de falha.	int
httpGet	As configurações de Http Get para investigação	ContainerHttpGet
initialDelaySeconds	Os segundos de atraso iniciais.	int
periodSeconds	Os segundos do período.	int
successThreshold	O limite de sucesso.	int
timeoutSeconds	Os segundos de tempo limite.	int

ContainerProperties

Nome	Descrição	Valor
comando	Os comandos a serem executados na instância de contêiner no formulário executivo.	string[]
environmentVariables	As variáveis de ambiente a serem definidas na instância do contêiner.	EnvironmentVariable []
imagem	O nome da imagem usada para criar a instância de contêiner.	cadeia de caracteres (obrigatório)
livenessProbe	A investigação de vida.	containerProbe
Portas	As portas expostas na instância de contêiner.	ContainerPort []
readinessProbe	A investigação de preparação.	containerProbe
Recursos	Os requisitos de recurso da instância de contêiner.	ResourceRequirements (obrigatório)
volumeMounts	As montagens de volume disponíveis para a instância de contêiner.	VolumeMount []

DnsConfiguration

Nome	Descrição	Valor
nameServers	Os servidores DNS para o grupo de contêineres.	string[] (obrigatório)
Opções	As opções de DNS para o grupo de contêineres.	corda
searchDomains	Os domínios de pesquisa DNS para pesquisa de nome de host no grupo de contêineres.	corda

EnvironmentVariable

Nome	Descrição	Valor
nome	O nome da variável de ambiente.	cadeia de caracteres (obrigatório)
secureValue	O valor da variável de ambiente seguro.	corda
valor	O valor da variável de ambiente.	corda

GitRepoVolume

Nome	Descrição	Valor
diretório	Nome do diretório de destino. Não deve conter ou começar com '..'. Se '.' for fornecido, o diretório de volume será o repositório git. Caso contrário, se especificado, o volume conterá o repositório git no subdiretório com o nome fornecido.	corda
repositório	URL do repositório	cadeia de caracteres (obrigatório)
revisão	Confirme o hash para a revisão especificada.	corda

GpuResource

Nome	Descrição	Valor
contar	A contagem do recurso de GPU.	int (obrigatório)
Sku	A SKU do recurso de GPU.	'K80' 'P100' 'V100' (obrigatório)

ImageRegistryCredential

Nome	Descrição	Valor
senha	A senha do registro privado.	corda
servidor	O servidor de registro de imagem do Docker sem um protocolo como "http" e "https".	cadeia de caracteres (obrigatório)
nome de usuário	O nome de usuário do registro privado.	cadeia de caracteres (obrigatório)

IpAddress

Nome	Descrição	Valor
dnsNameLabel	O rótulo de nome Dns para o IP.	corda
IP	O IP exposto à Internet pública.	corda
Portas	A lista de portas expostas no grupo de contêineres.	da Porta [] (obrigatório)
tipo	Especifica se o IP é exposto à Internet pública ou à VNET privada.	'Privado' 'Public' (obrigatório)

LogAnalytics

Nome	Descrição	Valor
logType	O tipo de log a ser usado.	'ContainerInsights' 'ContainerInstanceLogs'
metadados	Metadados para análise de logs.	LogAnalyticsMetadata
workspaceId	A ID do workspace para análise de logs	cadeia de caracteres (obrigatório)
workspaceKey	A chave do workspace para análise de logs	cadeia de caracteres (obrigatório)

LogAnalyticsMetadata

Nome	Descrição	Valor

Microsoft.ContainerInstance/containerGroups

Nome	Descrição	Valor
identidade	A identidade do grupo de contêineres, se configurada.	ContainerGroupIdentity
localização	O local do recurso.	corda
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades		ContainerGroupProperties (obrigatório)
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos

Porta

Nome	Descrição	Valor
porta	O número da porta.	int (obrigatório)
protocolo	O protocolo associado à porta.	'TCP' 'UDP'

ResourceLimits

Nome	Descrição	Valor
CPU	O limite da CPU dessa instância de contêiner.	int
Gpu	O limite de GPU dessa instância de contêiner.	GpuResource
memoryInGB	O limite de memória em GB dessa instância de contêiner.	int

ResourceRequests

Nome	Descrição	Valor
CPU	A solicitação de CPU dessa instância de contêiner.	int (obrigatório)
Gpu	A solicitação de GPU dessa instância de contêiner.	GpuResource
memoryInGB	A solicitação de memória em GB dessa instância de contêiner.	int (obrigatório)

ResourceRequirements

Nome	Descrição	Valor
Limites	Os limites de recurso dessa instância de contêiner.	ResourceLimits
Solicitações	As solicitações de recurso dessa instância de contêiner.	ResourceRequests (obrigatório)

ResourceTags

Nome	Descrição	Valor

SecretVolume

Nome	Descrição	Valor

Volume

Nome	Descrição	Valor
azureFile	O volume de Arquivo do Azure.	AzureFileVolume
emptyDir	O volume de diretório vazio.	qualquer
gitRepo	O volume de repositório git.	GitRepoVolume
nome	O nome do volume.	cadeia de caracteres (obrigatório)
segredo	O volume secreto.	SecretVolume

VolumeMount

Nome	Descrição	Valor
mountPath	O caminho dentro do contêiner em que o volume deve ser montado. Não deve conter dois-pontos (:).	cadeia de caracteres (obrigatório)
nome	O nome da montagem do volume.	cadeia de caracteres (obrigatório)
readOnly	O sinalizador que indica se a montagem do volume é somente leitura.	Bool

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo	Descrição
da Instância de Contêiner	Módulo de recurso AVM para instância de contêiner

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep	Descrição
Instâncias de Contêiner do Azure – BC com o SQL Server e o IIS	Implante um único contêiner do Windows com um ambiente do Microsoft Dynamics 365 Business Central totalmente independente em Instâncias de Contêiner do Azure.
Instâncias de Contêiner do Azure – contêiner com segredos	Implante um contêiner do Linux que tenha um volume secreto usando Instâncias de Contêiner do Azure.
Instâncias de Contêiner do Azure – contêiner do Linux com ip público	Implante um único contêiner do Linux acessível por meio de um IP público usando Instâncias de Contêiner do Azure.
Instâncias de Contêiner do Azure – VNet	Implantar uma instância de contêiner em uma rede virtual do Azure.
criar um site do WordPress	Este modelo cria um site do WordPress na Instância de Contêiner
criar um servidor SFTP sob demanda com de armazenamento persistente	Este modelo demonstra um servidor SFTP sob demanda usando uma ACI (Instância de Contêiner do Azure).
Criar Gateway de Aplicativo com certificados	Este modelo mostra como gerar certificados autoassinados do Key Vault e, em seguida, fazer referência do Gateway de Aplicativo.
Front Door Standard/Premium com instâncias de contêiner do Azure	Esse modelo cria um Front Door Standard/Premium com um grupo de contêineres.
Front Door com instâncias de contêiner e gateway de aplicativo	Esse modelo cria um Front Door Standard/Premium com um grupo de contêineres e o Gateway de Aplicativo.
grupo de disponibilidade do SQL Server em do AKS	Isso cria um novo cluster do AKS e implanta grupos de disponibilidade do SQL Server nele usando um pacote CNAB implantado usando o Duffle e a ACI

Definição de recurso de modelo do ARM

O tipo de recurso containerGroups pode ser implantado com operações de destino:

Grupos de recursos - Consulte comandos de implantação do grupo de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.ContainerInstance/containerGroups",
  "apiVersion": "2018-10-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"
    },
    "imageRegistryCredentials": [
      {
        "password": "string",
        "server": "string",
        "username": "string"
      }
    ],
    "ipAddress": {
      "dnsNameLabel": "string",
      "ip": "string",
      "ports": [
        {
          "port": "int",
          "protocol": "string"
        }
      ],
      "type": "string"
    },
    "networkProfile": {
      "id": "string"
    },
    "osType": "string",
    "restartPolicy": "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"
  }
}

Valores da propriedade

AzureFileVolume

Nome	Descrição	Valor
readOnly	O sinalizador que indica se o Arquivo do Azure compartilhado montado como um volume é somente leitura.	Bool
shareName	O nome do compartilhamento de Arquivos do Azure a ser montado como um volume.	cadeia de caracteres (obrigatório)
storageAccountKey	A chave de acesso da conta de armazenamento usada para acessar o compartilhamento de Arquivos do Azure.	corda
storageAccountName	O nome da conta de armazenamento que contém o compartilhamento de arquivos do Azure.	cadeia de caracteres (obrigatório)

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome	Descrição	Valor

Recipiente

Nome	Descrição	Valor
nome	O nome fornecido pelo usuário da instância de contêiner.	cadeia de caracteres (obrigatório)
Propriedades	As propriedades da instância de contêiner.	containerProperties (obrigatório)

ContainerExec

Nome	Descrição	Valor
comando	Os comandos a serem executados dentro do contêiner.	string[]

ContainerGroupDiagnostics

Nome	Descrição	Valor
logAnalytics	Informações do log analytics do grupo de contêineres.	do LogAnalytics

ContainerGroupIdentity

Nome	Descrição	Valor
tipo	O tipo de identidade usado para o grupo de contêineres. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá as identidades do grupo de contêineres.	'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	A lista de identidades de usuário associadas ao grupo de contêineres. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	ContainerGroupIdentityUserAssignedIdentities

ContainerGroupIdentityUserAssignedIdentities

Nome	Descrição	Valor

ContainerGroupNetworkProfile

Nome	Descrição	Valor
id	O identificador de um perfil de rede.	cadeia de caracteres (obrigatório)

ContainerGroupProperties

Nome	Descrição	Valor
Recipientes	Os contêineres dentro do grupo de contêineres.	de contêiner [] (obrigatório)
Diagnostics	As informações de diagnóstico de um grupo de contêineres.	ContainerGroupDiagnostics
dnsConfig	As informações de configuração de DNS para um grupo de contêineres.	DnsConfiguration
imageRegistryCredentials	As credenciais do registro de imagem pelas quais o grupo de contêineres é criado.	ImageRegistryCredential []
ipAddress	O tipo de endereço IP do grupo de contêineres.	ipAddress
networkProfile	As informações de perfil de rede de um grupo de contêineres.	ContainerGroupNetworkProfile
osType	O tipo de sistema operacional exigido pelos contêineres no grupo de contêineres.	'Linux' 'Windows' (obrigatório)
restartPolicy	Reinicie a política para todos os contêineres dentro do grupo de contêineres. - `Always` Sempre reiniciar - `OnFailure` Reiniciar com falha - `Never` Nunca reiniciar	'Always' 'Nunca' 'OnFailure'
Volumes	A lista de volumes que podem ser montados por contêineres neste grupo de contêineres.	de volume []

ContainerHttpGet

Nome	Descrição	Valor
caminho	O caminho para a investigação.	corda
porta	O número da porta a ser sondado.	int (obrigatório)
esquema	O esquema.	'http' 'https'

ContainerPort

Nome	Descrição	Valor
porta	O número da porta exposto no grupo de contêineres.	int (obrigatório)
protocolo	O protocolo associado à porta.	'TCP' 'UDP'

ContainerProbe

Nome	Descrição	Valor
Exec	O comando de execução a ser sondado	ContainerExec
failureThreshold	O limite de falha.	int
httpGet	As configurações de Http Get para investigação	ContainerHttpGet
initialDelaySeconds	Os segundos de atraso iniciais.	int
periodSeconds	Os segundos do período.	int
successThreshold	O limite de sucesso.	int
timeoutSeconds	Os segundos de tempo limite.	int

ContainerProperties

Nome	Descrição	Valor
comando	Os comandos a serem executados na instância de contêiner no formulário executivo.	string[]
environmentVariables	As variáveis de ambiente a serem definidas na instância do contêiner.	EnvironmentVariable []
imagem	O nome da imagem usada para criar a instância de contêiner.	cadeia de caracteres (obrigatório)
livenessProbe	A investigação de vida.	containerProbe
Portas	As portas expostas na instância de contêiner.	ContainerPort []
readinessProbe	A investigação de preparação.	containerProbe
Recursos	Os requisitos de recurso da instância de contêiner.	ResourceRequirements (obrigatório)
volumeMounts	As montagens de volume disponíveis para a instância de contêiner.	VolumeMount []

DnsConfiguration

Nome	Descrição	Valor
nameServers	Os servidores DNS para o grupo de contêineres.	string[] (obrigatório)
Opções	As opções de DNS para o grupo de contêineres.	corda
searchDomains	Os domínios de pesquisa DNS para pesquisa de nome de host no grupo de contêineres.	corda

EnvironmentVariable

Nome	Descrição	Valor
nome	O nome da variável de ambiente.	cadeia de caracteres (obrigatório)
secureValue	O valor da variável de ambiente seguro.	corda
valor	O valor da variável de ambiente.	corda

GitRepoVolume

Nome	Descrição	Valor
diretório	Nome do diretório de destino. Não deve conter ou começar com '..'. Se '.' for fornecido, o diretório de volume será o repositório git. Caso contrário, se especificado, o volume conterá o repositório git no subdiretório com o nome fornecido.	corda
repositório	URL do repositório	cadeia de caracteres (obrigatório)
revisão	Confirme o hash para a revisão especificada.	corda

GpuResource

Nome	Descrição	Valor
contar	A contagem do recurso de GPU.	int (obrigatório)
Sku	A SKU do recurso de GPU.	'K80' 'P100' 'V100' (obrigatório)

ImageRegistryCredential

Nome	Descrição	Valor
senha	A senha do registro privado.	corda
servidor	O servidor de registro de imagem do Docker sem um protocolo como "http" e "https".	cadeia de caracteres (obrigatório)
nome de usuário	O nome de usuário do registro privado.	cadeia de caracteres (obrigatório)

IpAddress

Nome	Descrição	Valor
dnsNameLabel	O rótulo de nome Dns para o IP.	corda
IP	O IP exposto à Internet pública.	corda
Portas	A lista de portas expostas no grupo de contêineres.	da Porta [] (obrigatório)
tipo	Especifica se o IP é exposto à Internet pública ou à VNET privada.	'Privado' 'Public' (obrigatório)

LogAnalytics

Nome	Descrição	Valor
logType	O tipo de log a ser usado.	'ContainerInsights' 'ContainerInstanceLogs'
metadados	Metadados para análise de logs.	LogAnalyticsMetadata
workspaceId	A ID do workspace para análise de logs	cadeia de caracteres (obrigatório)
workspaceKey	A chave do workspace para análise de logs	cadeia de caracteres (obrigatório)

LogAnalyticsMetadata

Nome	Descrição	Valor

Microsoft.ContainerInstance/containerGroups

Nome	Descrição	Valor
apiVersion	A versão da API	'2018-10-01'
identidade	A identidade do grupo de contêineres, se configurada.	ContainerGroupIdentity
localização	O local do recurso.	corda
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades		ContainerGroupProperties (obrigatório)
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo	O tipo de recurso	'Microsoft.ContainerInstance/containerGroups'

Porta

Nome	Descrição	Valor
porta	O número da porta.	int (obrigatório)
protocolo	O protocolo associado à porta.	'TCP' 'UDP'

ResourceLimits

Nome	Descrição	Valor
CPU	O limite da CPU dessa instância de contêiner.	int
Gpu	O limite de GPU dessa instância de contêiner.	GpuResource
memoryInGB	O limite de memória em GB dessa instância de contêiner.	int

ResourceRequests

Nome	Descrição	Valor
CPU	A solicitação de CPU dessa instância de contêiner.	int (obrigatório)
Gpu	A solicitação de GPU dessa instância de contêiner.	GpuResource
memoryInGB	A solicitação de memória em GB dessa instância de contêiner.	int (obrigatório)

ResourceRequirements

Nome	Descrição	Valor
Limites	Os limites de recurso dessa instância de contêiner.	ResourceLimits
Solicitações	As solicitações de recurso dessa instância de contêiner.	ResourceRequests (obrigatório)

ResourceTags

Nome	Descrição	Valor

SecretVolume

Nome	Descrição	Valor

Volume

Nome	Descrição	Valor
azureFile	O volume de Arquivo do Azure.	AzureFileVolume
emptyDir	O volume de diretório vazio.	qualquer
gitRepo	O volume de repositório git.	GitRepoVolume
nome	O nome do volume.	cadeia de caracteres (obrigatório)
segredo	O volume secreto.	SecretVolume

VolumeMount

Nome	Descrição	Valor
mountPath	O caminho dentro do contêiner em que o volume deve ser montado. Não deve conter dois-pontos (:).	cadeia de caracteres (obrigatório)
nome	O nome da montagem do volume.	cadeia de caracteres (obrigatório)
readOnly	O sinalizador que indica se a montagem do volume é somente leitura.	Bool

Exemplos de uso

Modelos de início rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Modelo	Descrição
Instâncias de Contêiner do Azure – BC com o SQL Server e o IIS	Implante um único contêiner do Windows com um ambiente do Microsoft Dynamics 365 Business Central totalmente independente em Instâncias de Contêiner do Azure.
Instâncias de Contêiner do Azure – contêiner com de investigação de integridade	Implante um contêiner do Linux que tenha uma investigação de integridade usando Instâncias de Contêiner do Azure.
Instâncias de Contêiner do Azure – contêiner com segredos	Implante um contêiner do Linux que tenha um volume secreto usando Instâncias de Contêiner do Azure.
Instâncias de Contêiner do Azure – contêiner com envVar seguro	Implante um contêiner do Linux que tenha uma variável de ambiente segura usando Instâncias de Contêiner do Azure.
instâncias de contêiner do Azure – contêiner do Linux com emptyDir	Implante dois contêineres do Linux que compartilham um volume emptyDir usando Instâncias de Contêiner do Azure.
instâncias de contêiner do Azure – contêiner linux com gitRepo	Implante um contêiner do Linux que usa um volume gitRepo usando Instâncias de Contêiner do Azure.
Instâncias de Contêiner do Azure – contêiner do Linux com ip público	Implante um único contêiner do Linux acessível por meio de um IP público usando Instâncias de Contêiner do Azure.
Instâncias de Contêiner do Azure – VNet	Implantar uma instância de contêiner em uma rede virtual do Azure.
criar um compartilhamento de arquivo de conta de armazenamento por meio de contêineres	Esse modelo cria uma conta de armazenamento e um compartilhamento de arquivos por meio do azure-cli em uma Instância de Contêiner
criar um site do WordPress	Este modelo cria um site do WordPress na Instância de Contêiner
criar um site do WordPress em uma rede virtual	Esse modelo cria um site do WordPress na Instância de Contêiner em uma rede virtual. E gerar um FQDN de site público que poderia acessar o site do WordPress.
criar um servidor SFTP sob demanda com de armazenamento persistente	Este modelo demonstra um servidor SFTP sob demanda usando uma ACI (Instância de Contêiner do Azure).
Criar Gateway de Aplicativo com certificados	Este modelo mostra como gerar certificados autoassinados do Key Vault e, em seguida, fazer referência do Gateway de Aplicativo.
Front Door Standard/Premium com instâncias de contêiner do Azure	Esse modelo cria um Front Door Standard/Premium com um grupo de contêineres.
Front Door com instâncias de contêiner e gateway de aplicativo	Esse modelo cria um Front Door Standard/Premium com um grupo de contêineres e o Gateway de Aplicativo.
servidor SFTP sob demanda usando uma conta de armazenamento existente	Este modelo demonstra um servidor SFTP sob demanda usando uma ACI (Instância de Contêiner do Azure).
grupo de disponibilidade do SQL Server em do AKS	Isso cria um novo cluster do AKS e implanta grupos de disponibilidade do SQL Server nele usando um pacote CNAB implantado usando o Duffle e a ACI
contêiner UDP no ACI	Esses modelos criam um recurso de ACI e expõem um contêiner por meio do UDP

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso containerGroups pode ser implantado com operações de destino:

grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerInstance/containerGroups@2018-10-01"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    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"
      }
      imageRegistryCredentials = [
        {
          password = "string"
          server = "string"
          username = "string"
        }
      ]
      ipAddress = {
        dnsNameLabel = "string"
        ip = "string"
        ports = [
          {
            port = int
            protocol = "string"
          }
        ]
        type = "string"
      }
      networkProfile = {
        id = "string"
      }
      osType = "string"
      restartPolicy = "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"
          }
        }
      ]
    }
  })
}

Valores da propriedade

AzureFileVolume

Nome	Descrição	Valor
readOnly	O sinalizador que indica se o Arquivo do Azure compartilhado montado como um volume é somente leitura.	Bool
shareName	O nome do compartilhamento de Arquivos do Azure a ser montado como um volume.	cadeia de caracteres (obrigatório)
storageAccountKey	A chave de acesso da conta de armazenamento usada para acessar o compartilhamento de Arquivos do Azure.	corda
storageAccountName	O nome da conta de armazenamento que contém o compartilhamento de arquivos do Azure.	cadeia de caracteres (obrigatório)

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome	Descrição	Valor

Recipiente

Nome	Descrição	Valor
nome	O nome fornecido pelo usuário da instância de contêiner.	cadeia de caracteres (obrigatório)
Propriedades	As propriedades da instância de contêiner.	containerProperties (obrigatório)

ContainerExec

Nome	Descrição	Valor
comando	Os comandos a serem executados dentro do contêiner.	string[]

ContainerGroupDiagnostics

Nome	Descrição	Valor
logAnalytics	Informações do log analytics do grupo de contêineres.	do LogAnalytics

ContainerGroupIdentity

Nome	Descrição	Valor
tipo	O tipo de identidade usado para o grupo de contêineres. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá as identidades do grupo de contêineres.	'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	A lista de identidades de usuário associadas ao grupo de contêineres. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	ContainerGroupIdentityUserAssignedIdentities

ContainerGroupIdentityUserAssignedIdentities

Nome	Descrição	Valor

ContainerGroupNetworkProfile

Nome	Descrição	Valor
id	O identificador de um perfil de rede.	cadeia de caracteres (obrigatório)

ContainerGroupProperties

Nome	Descrição	Valor
Recipientes	Os contêineres dentro do grupo de contêineres.	de contêiner [] (obrigatório)
Diagnostics	As informações de diagnóstico de um grupo de contêineres.	ContainerGroupDiagnostics
dnsConfig	As informações de configuração de DNS para um grupo de contêineres.	DnsConfiguration
imageRegistryCredentials	As credenciais do registro de imagem pelas quais o grupo de contêineres é criado.	ImageRegistryCredential []
ipAddress	O tipo de endereço IP do grupo de contêineres.	ipAddress
networkProfile	As informações de perfil de rede de um grupo de contêineres.	ContainerGroupNetworkProfile
osType	O tipo de sistema operacional exigido pelos contêineres no grupo de contêineres.	'Linux' 'Windows' (obrigatório)
restartPolicy	Reinicie a política para todos os contêineres dentro do grupo de contêineres. - `Always` Sempre reiniciar - `OnFailure` Reiniciar com falha - `Never` Nunca reiniciar	'Always' 'Nunca' 'OnFailure'
Volumes	A lista de volumes que podem ser montados por contêineres neste grupo de contêineres.	de volume []

ContainerHttpGet

Nome	Descrição	Valor
caminho	O caminho para a investigação.	corda
porta	O número da porta a ser sondado.	int (obrigatório)
esquema	O esquema.	'http' 'https'

ContainerPort

Nome	Descrição	Valor
porta	O número da porta exposto no grupo de contêineres.	int (obrigatório)
protocolo	O protocolo associado à porta.	'TCP' 'UDP'

ContainerProbe

Nome	Descrição	Valor
Exec	O comando de execução a ser sondado	ContainerExec
failureThreshold	O limite de falha.	int
httpGet	As configurações de Http Get para investigação	ContainerHttpGet
initialDelaySeconds	Os segundos de atraso iniciais.	int
periodSeconds	Os segundos do período.	int
successThreshold	O limite de sucesso.	int
timeoutSeconds	Os segundos de tempo limite.	int

ContainerProperties

Nome	Descrição	Valor
comando	Os comandos a serem executados na instância de contêiner no formulário executivo.	string[]
environmentVariables	As variáveis de ambiente a serem definidas na instância do contêiner.	EnvironmentVariable []
imagem	O nome da imagem usada para criar a instância de contêiner.	cadeia de caracteres (obrigatório)
livenessProbe	A investigação de vida.	containerProbe
Portas	As portas expostas na instância de contêiner.	ContainerPort []
readinessProbe	A investigação de preparação.	containerProbe
Recursos	Os requisitos de recurso da instância de contêiner.	ResourceRequirements (obrigatório)
volumeMounts	As montagens de volume disponíveis para a instância de contêiner.	VolumeMount []

DnsConfiguration

Nome	Descrição	Valor
nameServers	Os servidores DNS para o grupo de contêineres.	string[] (obrigatório)
Opções	As opções de DNS para o grupo de contêineres.	corda
searchDomains	Os domínios de pesquisa DNS para pesquisa de nome de host no grupo de contêineres.	corda

EnvironmentVariable

Nome	Descrição	Valor
nome	O nome da variável de ambiente.	cadeia de caracteres (obrigatório)
secureValue	O valor da variável de ambiente seguro.	corda
valor	O valor da variável de ambiente.	corda

GitRepoVolume

Nome	Descrição	Valor
diretório	Nome do diretório de destino. Não deve conter ou começar com '..'. Se '.' for fornecido, o diretório de volume será o repositório git. Caso contrário, se especificado, o volume conterá o repositório git no subdiretório com o nome fornecido.	corda
repositório	URL do repositório	cadeia de caracteres (obrigatório)
revisão	Confirme o hash para a revisão especificada.	corda

GpuResource

Nome	Descrição	Valor
contar	A contagem do recurso de GPU.	int (obrigatório)
Sku	A SKU do recurso de GPU.	'K80' 'P100' 'V100' (obrigatório)

ImageRegistryCredential

Nome	Descrição	Valor
senha	A senha do registro privado.	corda
servidor	O servidor de registro de imagem do Docker sem um protocolo como "http" e "https".	cadeia de caracteres (obrigatório)
nome de usuário	O nome de usuário do registro privado.	cadeia de caracteres (obrigatório)

IpAddress

Nome	Descrição	Valor
dnsNameLabel	O rótulo de nome Dns para o IP.	corda
IP	O IP exposto à Internet pública.	corda
Portas	A lista de portas expostas no grupo de contêineres.	da Porta [] (obrigatório)
tipo	Especifica se o IP é exposto à Internet pública ou à VNET privada.	'Privado' 'Public' (obrigatório)

LogAnalytics

Nome	Descrição	Valor
logType	O tipo de log a ser usado.	'ContainerInsights' 'ContainerInstanceLogs'
metadados	Metadados para análise de logs.	LogAnalyticsMetadata
workspaceId	A ID do workspace para análise de logs	cadeia de caracteres (obrigatório)
workspaceKey	A chave do workspace para análise de logs	cadeia de caracteres (obrigatório)

LogAnalyticsMetadata

Nome	Descrição	Valor

Microsoft.ContainerInstance/containerGroups

Nome	Descrição	Valor
identidade	A identidade do grupo de contêineres, se configurada.	ContainerGroupIdentity
localização	O local do recurso.	corda
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades		ContainerGroupProperties (obrigatório)
Tags	Marcas de recurso	Dicionário de nomes e valores de marca.
tipo	O tipo de recurso	"Microsoft.ContainerInstance/containerGroups@2018-10-01"

Porta

Nome	Descrição	Valor
porta	O número da porta.	int (obrigatório)
protocolo	O protocolo associado à porta.	'TCP' 'UDP'

ResourceLimits

Nome	Descrição	Valor
CPU	O limite da CPU dessa instância de contêiner.	int
Gpu	O limite de GPU dessa instância de contêiner.	GpuResource
memoryInGB	O limite de memória em GB dessa instância de contêiner.	int

ResourceRequests

Nome	Descrição	Valor
CPU	A solicitação de CPU dessa instância de contêiner.	int (obrigatório)
Gpu	A solicitação de GPU dessa instância de contêiner.	GpuResource
memoryInGB	A solicitação de memória em GB dessa instância de contêiner.	int (obrigatório)

ResourceRequirements

Nome	Descrição	Valor
Limites	Os limites de recurso dessa instância de contêiner.	ResourceLimits
Solicitações	As solicitações de recurso dessa instância de contêiner.	ResourceRequests (obrigatório)

ResourceTags

Nome	Descrição	Valor

SecretVolume

Nome	Descrição	Valor

Volume

Nome	Descrição	Valor
azureFile	O volume de Arquivo do Azure.	AzureFileVolume
emptyDir	O volume de diretório vazio.	qualquer
gitRepo	O volume de repositório git.	GitRepoVolume
nome	O nome do volume.	cadeia de caracteres (obrigatório)
segredo	O volume secreto.	SecretVolume

VolumeMount

Nome	Descrição	Valor
mountPath	O caminho dentro do contêiner em que o volume deve ser montado. Não deve conter dois-pontos (:).	cadeia de caracteres (obrigatório)
nome	O nome da montagem do volume.	cadeia de caracteres (obrigatório)
readOnly	O sinalizador que indica se a montagem do volume é somente leitura.	Bool

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo	Descrição
da Instância de Contêiner	Módulo de recurso AVM para instância de contêiner

Compartilhar via

Contêineres Microsoft.ContainerInstanceGroups 2018-10-01

Definição de recurso do Bicep

Formato de recurso

Valores da propriedade

AzureFileVolume

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Recipiente

ContainerExec

ContainerGroupDiagnostics

ContainerGroupIdentity

ContainerGroupIdentityUserAssignedIdentities

ContainerGroupNetworkProfile

ContainerGroupProperties

ContainerHttpGet

ContainerPort

ContainerProbe

ContainerProperties

DnsConfiguration

EnvironmentVariable

GitRepoVolume

GpuResource

ImageRegistryCredential

IpAddress

LogAnalytics

LogAnalyticsMetadata

Microsoft.ContainerInstance/containerGroups

Porta

ResourceLimits

ResourceRequests

ResourceRequirements

ResourceTags

SecretVolume

Volume

VolumeMount

Exemplos de uso

Módulos verificados do Azure

Exemplos de Início Rápido do Azure

Definição de recurso de modelo do ARM

Formato de recurso

Valores da propriedade

AzureFileVolume

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Recipiente

ContainerExec

ContainerGroupDiagnostics

ContainerGroupIdentity

ContainerGroupIdentityUserAssignedIdentities

ContainerGroupNetworkProfile

ContainerGroupProperties

ContainerHttpGet

ContainerPort

ContainerProbe

ContainerProperties

DnsConfiguration

EnvironmentVariable

GitRepoVolume

GpuResource

ImageRegistryCredential

IpAddress

LogAnalytics

LogAnalyticsMetadata

Microsoft.ContainerInstance/containerGroups

Porta

ResourceLimits

ResourceRequests

ResourceRequirements

ResourceTags

SecretVolume

Volume

VolumeMount

Exemplos de uso

Modelos de início rápido do Azure

Definição de recurso do Terraform (provedor de AzAPI)

Formato de recurso

Valores da propriedade

AzureFileVolume

Components10Wh5UdSchemasContainergroupidentityPropertiesUserassignedidentitiesAdditionalproperties

Recipiente

ContainerExec