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.
Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o Bicep a seguir ao modelo.
resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2017-10-01-preview' = {
scope: resourceSymbolicName or scope
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) |
| escopo |
Use ao criar um recurso em um escopo diferente do escopo de implantação. |
Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão . |
| 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 |
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.
Definição de recurso de modelo do ARM
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.
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 |
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.
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.
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) |
| parent_id |
A ID do recurso ao qual aplicar esse recurso de extensão. |
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 |
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 |