Contêiner Microsoft.ContainerInstanceGroups 2017-08-01-preview
Artigo 05/11/2023
1 colaborador
Comentários
Neste artigo
Definição de recurso do Bicep
O tipo de recurso containerGroups pode ser implantado com operações direcionadas:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações .
Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o seguinte Bicep ao modelo.
resource symbolicname 'Microsoft.ContainerInstance/containerGroups@2017-08-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
}
]
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: 'always'
volumes: [
{
azureFile: {
readOnly: bool
shareName: 'string'
storageAccountKey: 'string'
storageAccountName: 'string'
}
name: 'string'
}
]
}
}
Valores de propriedade
containerGroups
Nome
Descrição
Valor
name
O nome do recurso
cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 63 Caracteres válidos: Letras minúsculas, números e hifens. Não pode iniciar ou terminar com hífen. Hifens consecutivos não são permitidos.
local
O local do recurso.
cadeia de caracteres (obrigatório)
marcas
As marcas do recurso.
Dicionário de nomes e valores de marcas. Consulte Marcas em modelos
properties
ContainerGroupProperties (obrigatório)
ContainerGroupProperties
Nome
Descrição
Valor
containers
Os contêineres dentro do grupo de contêineres.
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 do grupo.
'Linux' 'Windows' (obrigatório)
restartPolicy
A política de reinicialização para todos os contêineres no grupo. Atualmente, a única opção disponível é always
.
'always'
volumes
A lista de volumes que podem ser montados pelos contêineres do grupo.
Volume []
Contêiner
Nome
Descrição
Valor
name
O nome da instância de contêiner fornecido pelo usuário.
cadeia de caracteres (obrigatório)
properties
As propriedades da instância de contêiner.
ContainerProperties (obrigatório)
ContainerProperties
Nome
Descrição
Valor
.
Os comandos a serem executados na instância de contêiner no formato de execução.
string[]
environmentVariables
As variáveis de ambiente a serem definidas na instância de contêiner.
EnvironmentVariable []
image
O nome da imagem usada para criar a instância de contêiner.
cadeia de caracteres (obrigatório)
ports
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
name
O nome da variável de ambiente.
cadeia de caracteres (obrigatório)
value
O valor da variável de ambiente.
cadeia de caracteres (obrigatório)
ContainerPort
Nome
Descrição
Valor
porta
O número da porta exposta no grupo de contêineres.
int (obrigatório)
ResourceRequirements
Nome
Descrição
Valor
limites
Os limites de recurso desta instância de contêiner.
ResourceLimits
solicitações
As solicitações de recurso desta instância de contêiner.
ResourceRequests (obrigatório)
ResourceLimits
Nome
Descrição
Valor
cpu
O limite de CPU da instância de contêiner.
INT
memoryInGB
O limite de memória da instância de contêiner em GB. Para especificar um valor decimal, use a função json().
int ou json decimal
ResourceRequests
Nome
Descrição
Valor
cpu
A solicitação de CPU da instância de contêiner.
int (obrigatório)
memoryInGB
A solicitação de memória da instância de contêiner em GB. Para especificar um valor decimal, use a função json().
int ou json decimal (obrigatório)
VolumeMount
Nome
Descrição
Valor
mountPath
O caminho no contêiner em que o volume deve ser montado. Não pode conter dois-pontos (:).
cadeia de caracteres (obrigatório)
name
O nome da montagem de volume.
cadeia de caracteres (obrigatório)
readOnly
O sinalizador que indica se a montagem de volume é somente leitura.
bool
ImageRegistryCredential
Nome
Descrição
Valor
password
A senha do registro privado.
string
Servidor
O servidor do registro de imagem do Docker sem um protocolo como "http" ou "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
ip
O IP exposto à Internet pública.
string
ports
A lista de portas expostas no grupo de contêineres.
Port [] (obrigatório)
tipo
Especifica se o IP está 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'
Volume
Nome
Descrição
Valor
azureFile
O nome do volume do Arquivo do Azure.
AzureFileVolume (obrigatório)
name
O nome do volume.
cadeia de caracteres (obrigatório)
AzureFileVolume
Nome
Descrição
Valor
readOnly
O sinalizador que indica se o arquivo do Azure que foi compartilhado montado como volume é somente leitura.
bool
shareName
O nome do compartilhamento de arquivo do Azure a ser montado como volume.
cadeia de caracteres (obrigatório)
storageAccountKey
A chave de acesso da conta de armazenamento usada para acessar o compartilhamento de arquivo do Azure.
string
storageAccountName
O nome da conta de armazenamento que contém o compartilhamento de arquivo do Azure.
cadeia de caracteres (obrigatório)
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
Definição de recurso de modelo do ARM
O tipo de recurso containerGroups pode ser implantado com operações direcionadas:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações .
Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o JSON a seguir ao modelo.
{
"type": "Microsoft.ContainerInstance/containerGroups",
"apiVersion": "2017-08-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"
}
],
"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": "always",
"volumes": [
{
"azureFile": {
"readOnly": "bool",
"shareName": "string",
"storageAccountKey": "string",
"storageAccountName": "string"
},
"name": "string"
}
]
}
}
Valores de propriedade
containerGroups
Nome
Descrição
Valor
tipo
O tipo de recurso
'Microsoft.ContainerInstance/containerGroups'
apiVersion
A versão da API de recursos
'2017-08-01-preview'
name
O nome do recurso
cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 63 Caracteres válidos: Letras minúsculas, números e hifens. Não pode iniciar ou terminar com hífen. Hifens consecutivos não são permitidos.
local
O local do recurso.
cadeia de caracteres (obrigatório)
marcas
As marcas do recurso.
Dicionário de nomes e valores de marcas. Consulte Marcas em modelos
properties
ContainerGroupProperties (obrigatório)
ContainerGroupProperties
Nome
Descrição
Valor
containers
Os contêineres dentro do grupo de contêineres.
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 do grupo.
'Linux' 'Windows' (obrigatório)
restartPolicy
A política de reinicialização para todos os contêineres no grupo. Atualmente, a única opção disponível é always
.
'always'
volumes
A lista de volumes que podem ser montados pelos contêineres do grupo.
Volume []
Contêiner
Nome
Descrição
Valor
name
O nome da instância de contêiner fornecido pelo usuário.
cadeia de caracteres (obrigatório)
properties
As propriedades da instância de contêiner.
ContainerProperties (obrigatório)
ContainerProperties
Nome
Descrição
Valor
.
Os comandos a serem executados na instância de contêiner no formato de execução.
string[]
environmentVariables
As variáveis de ambiente a serem definidas na instância de contêiner.
EnvironmentVariable []
image
O nome da imagem usada para criar a instância de contêiner.
cadeia de caracteres (obrigatório)
ports
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
name
O nome da variável de ambiente.
cadeia de caracteres (obrigatório)
value
O valor da variável de ambiente.
cadeia de caracteres (obrigatório)
ContainerPort
Nome
Descrição
Valor
porta
O número da porta exposta no grupo de contêineres.
int (obrigatório)
ResourceRequirements
Nome
Descrição
Valor
limites
Os limites de recurso desta instância de contêiner.
ResourceLimits
solicitações
As solicitações de recurso desta instância de contêiner.
ResourceRequests (obrigatório)
ResourceLimits
Nome
Descrição
Valor
cpu
O limite de CPU da instância de contêiner.
INT
memoryInGB
O limite de memória da instância de contêiner em GB. Para especificar um valor decimal, use a função json().
int ou json decimal
ResourceRequests
Nome
Descrição
Valor
cpu
A solicitação de CPU da instância de contêiner.
int (obrigatório)
memoryInGB
A solicitação de memória da instância de contêiner em GB. Para especificar um valor decimal, use a função json().
int ou json decimal (obrigatório)
VolumeMount
Nome
Descrição
Valor
mountPath
O caminho no contêiner em que o volume deve ser montado. Não pode conter dois-pontos (:).
cadeia de caracteres (obrigatório)
name
O nome da montagem de volume.
cadeia de caracteres (obrigatório)
readOnly
O sinalizador que indica se a montagem de volume é somente leitura.
bool
ImageRegistryCredential
Nome
Descrição
Valor
password
A senha do registro privado.
string
Servidor
O servidor do registro de imagem do Docker sem um protocolo como "http" ou "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
ip
O IP exposto à Internet pública.
string
ports
A lista de portas expostas no grupo de contêineres.
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'
Volume
Nome
Descrição
Valor
azureFile
O nome do volume do Arquivo do Azure.
AzureFileVolume (obrigatório)
name
O nome do volume.
cadeia de caracteres (obrigatório)
AzureFileVolume
Nome
Descrição
Valor
readOnly
O sinalizador que indica se o arquivo do Azure que foi compartilhado montado como volume é somente leitura.
bool
shareName
O nome do compartilhamento de arquivo do Azure a ser montado como volume.
cadeia de caracteres (obrigatório)
storageAccountKey
A chave de acesso da conta de armazenamento usada para acessar o compartilhamento de arquivo do Azure.
string
storageAccountName
O nome da conta de armazenamento que contém o compartilhamento de arquivo do Azure.
cadeia de caracteres (obrigatório)
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
O tipo de recurso containerGroups pode ser implantado com operações direcionadas:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações .
Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o Terraform a seguir ao modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ContainerInstance/containerGroups@2017-08-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
}
]
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 = "always"
volumes = [
{
azureFile = {
readOnly = bool
shareName = "string"
storageAccountKey = "string"
storageAccountName = "string"
}
name = "string"
}
]
}
})
}
Valores de propriedade
containerGroups
Nome
Descrição
Valor
tipo
O tipo de recurso
"Microsoft.ContainerInstance/containerGroups@2017-08-01-preview"
name
O nome do recurso
cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 63 Caracteres válidos: Letras minúsculas, números e hifens. Não pode iniciar ou terminar com hífen. Hifens consecutivos não são permitidos.
local
O local do recurso.
cadeia de caracteres (obrigatório)
parent_id
Para implantar em um grupo de recursos, use a ID desse grupo de recursos.
cadeia de caracteres (obrigatório)
marcas
As marcas do recurso.
Dicionário de nomes e valores de marcas.
properties
ContainerGroupProperties (obrigatório)
ContainerGroupProperties
Nome
Descrição
Valor
containers
Os contêineres dentro do grupo de contêineres.
Container [] (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 do grupo.
“Linux” "Windows" (obrigatório)
restartPolicy
A política de reinicialização para todos os contêineres no grupo. Atualmente, a única opção disponível é always
.
"always"
volumes
A lista de volumes que podem ser montados pelos contêineres do grupo.
Volume []
Contêiner
Nome
Descrição
Valor
name
O nome da instância de contêiner fornecido pelo usuário.
cadeia de caracteres (obrigatório)
properties
As propriedades da instância de contêiner.
ContainerProperties (obrigatório)
ContainerProperties
Nome
Descrição
Valor
.
Os comandos a serem executados na instância de contêiner no formato de execução.
string[]
environmentVariables
As variáveis de ambiente a serem definidas na instância de contêiner.
EnvironmentVariable []
image
O nome da imagem usada para criar a instância de contêiner.
cadeia de caracteres (obrigatório)
ports
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
name
O nome da variável de ambiente.
cadeia de caracteres (obrigatório)
value
O valor da variável de ambiente.
cadeia de caracteres (obrigatório)
ContainerPort
Nome
Descrição
Valor
porta
O número da porta exposta no grupo de contêineres.
int (obrigatório)
ResourceRequirements
Nome
Descrição
Valor
limites
Os limites de recurso desta instância de contêiner.
ResourceLimits
solicitações
As solicitações de recurso desta instância de contêiner.
ResourceRequests (obrigatório)
ResourceLimits
Nome
Descrição
Valor
cpu
O limite de CPU da instância de contêiner.
INT
memoryInGB
O limite de memória da instância de contêiner em GB. Especifique um valor decimal como uma cadeia de caracteres.
int ou json decimal
ResourceRequests
Nome
Descrição
Valor
cpu
A solicitação de CPU da instância de contêiner.
int (obrigatório)
memoryInGB
A solicitação de memória da instância de contêiner em GB. Especifique um valor decimal como uma cadeia de caracteres.
int ou json decimal (obrigatório)
VolumeMount
Nome
Descrição
Valor
mountPath
O caminho no contêiner em que o volume deve ser montado. Não pode conter dois-pontos (:).
cadeia de caracteres (obrigatório)
name
O nome da montagem de volume.
cadeia de caracteres (obrigatório)
readOnly
O sinalizador que indica se a montagem de volume é somente leitura.
bool
ImageRegistryCredential
Nome
Descrição
Valor
password
A senha do registro privado.
string
Servidor
O servidor do registro de imagem do Docker sem um protocolo como "http" ou "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
ip
O IP exposto à Internet pública.
string
ports
A lista de portas expostas no grupo de contêineres.
Porta [] (obrigatório)
tipo
Especifica se o IP é exposto à Internet pública.
"Público" (obrigatório)
Porta
Nome
Descrição
Valor
porta
O número da porta.
int (obrigatório)
protocolo
O protocolo associado à porta.
"TCP" "UDP"
Volume
Nome
Descrição
Valor
azureFile
O nome do volume do Arquivo do Azure.
AzureFileVolume (obrigatório)
name
O nome do volume.
cadeia de caracteres (obrigatório)
AzureFileVolume
Nome
Descrição
Valor
readOnly
O sinalizador que indica se o arquivo do Azure que foi compartilhado montado como volume é somente leitura.
bool
shareName
O nome do compartilhamento de arquivo do Azure a ser montado como volume.
cadeia de caracteres (obrigatório)
storageAccountKey
A chave de acesso da conta de armazenamento usada para acessar o compartilhamento de arquivo do Azure.
string
storageAccountName
O nome da conta de armazenamento que contém o compartilhamento de arquivo do Azure.
cadeia de caracteres (obrigatório)