Definição de recurso do Bicep
O tipo de recurso containerGroups pode ser implantado com operações de destino:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Exemplos de uso
Exemplos do Bicep
Um exemplo básico de implantação da instância do Grupo de Contêineres do Azure.
param location string = 'westeurope'
param resourceName string = 'acctest0001'
resource containerGroup 'Microsoft.ContainerInstance/containerGroups@2023-05-01' = {
name: resourceName
location: location
properties: {
containers: [
{
name: 'hw'
properties: {
command: []
environmentVariables: []
image: 'ubuntu:20.04'
ports: [
{
port: 80
protocol: 'TCP'
}
]
resources: {
requests: {
cpu: any('0.5')
memoryInGB: any('0.5')
}
}
}
}
]
initContainers: []
ipAddress: {
autoGeneratedDomainNameLabelScope: 'Unsecure'
ports: [
{
port: 80
protocol: 'TCP'
}
]
type: 'Public'
}
osType: 'Linux'
restartPolicy: 'Always'
volumes: []
}
tags: {
environment: 'Testing'
}
}
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.
Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o Bicep a seguir ao modelo.
resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2017-10-01-preview' = {
location: 'string'
name: 'string'
properties: {
containers: [
{
name: 'string'
properties: {
command: [
'string'
]
environmentVariables: [
{
name: 'string'
value: 'string'
}
]
image: 'string'
ports: [
{
port: int
protocol: 'string'
}
]
resources: {
limits: {
cpu: int
memoryInGB: int
}
requests: {
cpu: int
memoryInGB: int
}
}
volumeMounts: [
{
mountPath: 'string'
name: 'string'
readOnly: bool
}
]
}
}
]
imageRegistryCredentials: [
{
password: 'string'
server: 'string'
username: 'string'
}
]
ipAddress: {
ip: 'string'
ports: [
{
port: int
protocol: 'string'
}
]
type: 'string'
}
osType: 'string'
restartPolicy: 'string'
volumes: [
{
azureFile: {
readOnly: bool
shareName: 'string'
storageAccountKey: 'string'
storageAccountName: 'string'
}
emptyDir: any(...)
name: 'string'
}
]
}
tags: {
{customized property}: 'string'
}
}
Valores de propriedade
Microsoft.ContainerInstance/containerGroups
| Nome |
Descrição |
Valor |
| local |
O local do recurso. |
cadeia de caracteres (obrigatório) |
| 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 |
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. |
cadeia |
| storageAccountName |
O nome da conta de armazenamento que contém o compartilhamento de arquivos do Azure. |
cadeia de caracteres (obrigatório) |
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) |
ContainerGroupProperties
| Nome |
Descrição |
Valor |
| Recipientes |
Os contêineres dentro do grupo de contêineres. |
de contêiner [] (obrigatório) |
| 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 |
| 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 [] |
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' |
PropriedadesDoContêiner
| Nome |
Descrição |
Valor |
| comando |
Os comandos a serem executados na instância de contêiner no formulário executivo. |
cadeia de caracteres[] |
| 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) |
| Portas |
As portas expostas na instância de contêiner. |
ContainerPort [] |
| 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 [] |
EnvironmentVariable
| Nome |
Descrição |
Valor |
| nome |
O nome da variável de ambiente. |
cadeia de caracteres (obrigatório) |
| valor |
O valor da variável de ambiente. |
cadeia de caracteres (obrigatório) |
ImageRegistryCredential
| Nome |
Descrição |
Valor |
| senha |
A senha do registro privado. |
cadeia |
| 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) |
Endereço IP
| Nome |
Descrição |
Valor |
| IP |
O IP exposto à Internet pública. |
cadeia |
| Portas |
A lista de portas expostas no grupo de contêineres. |
da Porta [] (obrigatório) |
| tipo |
Especifica se o IP é exposto à Internet pública. |
'Public' (obrigatório) |
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 |
| 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) |
| 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) |
Volume
| Nome |
Descrição |
Valor |
| azureFile |
O nome do volume de Arquivo do Azure. |
AzureFileVolume |
| emptyDir |
O volume de diretório vazio. |
qualquer |
| nome |
O nome do volume. |
cadeia de caracteres (obrigatório) |
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 |
Definição de recurso de modelo do ARM
O tipo de recurso containerGroups pode ser implantado com operações de destino:
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.
Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o JSON a seguir ao modelo.
{
"type": "Microsoft.ContainerInstance/containerGroups",
"apiVersion": "2017-10-01-preview",
"name": "string",
"location": "string",
"properties": {
"containers": [
{
"name": "string",
"properties": {
"command": [ "string" ],
"environmentVariables": [
{
"name": "string",
"value": "string"
}
],
"image": "string",
"ports": [
{
"port": "int",
"protocol": "string"
}
],
"resources": {
"limits": {
"cpu": "int",
"memoryInGB": "int"
},
"requests": {
"cpu": "int",
"memoryInGB": "int"
}
},
"volumeMounts": [
{
"mountPath": "string",
"name": "string",
"readOnly": "bool"
}
]
}
}
],
"imageRegistryCredentials": [
{
"password": "string",
"server": "string",
"username": "string"
}
],
"ipAddress": {
"ip": "string",
"ports": [
{
"port": "int",
"protocol": "string"
}
],
"type": "string"
},
"osType": "string",
"restartPolicy": "string",
"volumes": [
{
"azureFile": {
"readOnly": "bool",
"shareName": "string",
"storageAccountKey": "string",
"storageAccountName": "string"
},
"emptyDir": {},
"name": "string"
}
]
},
"tags": {
"{customized property}": "string"
}
}
Valores de propriedade
Microsoft.ContainerInstance/containerGroups
| Nome |
Descrição |
Valor |
| apiVersion |
A versão da API |
'2017-10-01-preview' |
| local |
O local do recurso. |
cadeia de caracteres (obrigatório) |
| 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' |
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. |
cadeia |
| storageAccountName |
O nome da conta de armazenamento que contém o compartilhamento de arquivos do Azure. |
cadeia de caracteres (obrigatório) |
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) |
ContainerGroupProperties
| Nome |
Descrição |
Valor |
| Recipientes |
Os contêineres dentro do grupo de contêineres. |
de contêiner [] (obrigatório) |
| 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 |
| 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 [] |
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' |
PropriedadesDoContêiner
| Nome |
Descrição |
Valor |
| comando |
Os comandos a serem executados na instância de contêiner no formulário executivo. |
cadeia de caracteres[] |
| 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) |
| Portas |
As portas expostas na instância de contêiner. |
ContainerPort [] |
| 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 [] |
EnvironmentVariable
| Nome |
Descrição |
Valor |
| nome |
O nome da variável de ambiente. |
cadeia de caracteres (obrigatório) |
| valor |
O valor da variável de ambiente. |
cadeia de caracteres (obrigatório) |
ImageRegistryCredential
| Nome |
Descrição |
Valor |
| senha |
A senha do registro privado. |
cadeia |
| 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) |
Endereço IP
| Nome |
Descrição |
Valor |
| IP |
O IP exposto à Internet pública. |
cadeia |
| Portas |
A lista de portas expostas no grupo de contêineres. |
da Porta [] (obrigatório) |
| tipo |
Especifica se o IP é exposto à Internet pública. |
'Public' (obrigatório) |
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 |
| 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) |
| 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) |
Volume
| Nome |
Descrição |
Valor |
| azureFile |
O nome do volume de Arquivo do Azure. |
AzureFileVolume |
| emptyDir |
O volume de diretório vazio. |
qualquer |
| nome |
O nome do volume. |
cadeia de caracteres (obrigatório) |
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 |
O tipo de recurso containerGroups pode ser implantado com operações de destino:
Exemplos de uso
Um exemplo básico de implantação da instância do Grupo de Contêineres do 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 = ["*"]
}
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 |
Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o Terraform a seguir ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ContainerInstance/containerGroups@2017-10-01-preview"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
containers = [
{
name = "string"
properties = {
command = [
"string"
]
environmentVariables = [
{
name = "string"
value = "string"
}
]
image = "string"
ports = [
{
port = int
protocol = "string"
}
]
resources = {
limits = {
cpu = int
memoryInGB = int
}
requests = {
cpu = int
memoryInGB = int
}
}
volumeMounts = [
{
mountPath = "string"
name = "string"
readOnly = bool
}
]
}
}
]
imageRegistryCredentials = [
{
password = "string"
server = "string"
username = "string"
}
]
ipAddress = {
ip = "string"
ports = [
{
port = int
protocol = "string"
}
]
type = "string"
}
osType = "string"
restartPolicy = "string"
volumes = [
{
azureFile = {
readOnly = bool
shareName = "string"
storageAccountKey = "string"
storageAccountName = "string"
}
emptyDir = ?
name = "string"
}
]
}
}
}
Valores de propriedade
Microsoft.ContainerInstance/containerGroups
| Nome |
Descrição |
Valor |
| local |
O local do recurso. |
cadeia de caracteres (obrigatório) |
| 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@2017-10-01-preview" |
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. |
cadeia |
| storageAccountName |
O nome da conta de armazenamento que contém o compartilhamento de arquivos do Azure. |
cadeia de caracteres (obrigatório) |
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) |
ContainerGroupProperties
| Nome |
Descrição |
Valor |
| Recipientes |
Os contêineres dentro do grupo de contêineres. |
de contêiner [] (obrigatório) |
| 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 |
| 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 [] |
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' |
PropriedadesDoContêiner
| Nome |
Descrição |
Valor |
| comando |
Os comandos a serem executados na instância de contêiner no formulário executivo. |
cadeia de caracteres[] |
| 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) |
| Portas |
As portas expostas na instância de contêiner. |
ContainerPort [] |
| 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 [] |
EnvironmentVariable
| Nome |
Descrição |
Valor |
| nome |
O nome da variável de ambiente. |
cadeia de caracteres (obrigatório) |
| valor |
O valor da variável de ambiente. |
cadeia de caracteres (obrigatório) |
ImageRegistryCredential
| Nome |
Descrição |
Valor |
| senha |
A senha do registro privado. |
cadeia |
| 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) |
Endereço IP
| Nome |
Descrição |
Valor |
| IP |
O IP exposto à Internet pública. |
cadeia |
| Portas |
A lista de portas expostas no grupo de contêineres. |
da Porta [] (obrigatório) |
| tipo |
Especifica se o IP é exposto à Internet pública. |
'Public' (obrigatório) |
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 |
| 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) |
| 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) |
Volume
| Nome |
Descrição |
Valor |
| azureFile |
O nome do volume de Arquivo do Azure. |
AzureFileVolume |
| emptyDir |
O volume de diretório vazio. |
qualquer |
| nome |
O nome do volume. |
cadeia de caracteres (obrigatório) |
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 |