Contentor Microsoft.ContainerInstanceGrupos 2017-08-01-preview
Artigo 05/11/2023
1 contribuidor
Comentários
Neste artigo
Definição de recurso do Bicep
O tipo de recurso containerGroups pode ser implementado com operações que visam:
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações .
Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o seguinte Bicep ao seu 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 (obrigatório) Limite de carateres: 1-63 Carateres válidos: Letras minúsculas, números e hífenes. Não é possível iniciar ou terminar com hífen. Os hífenes consecutivos não são permitidos.
localização
A localização do recurso.
cadeia (obrigatório)
etiquetas
As etiquetas de recursos.
Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
propriedades
ContainerGroupProperties (obrigatório)
ContainerGroupProperties
Nome
Descrição
Valor
containers
Os contentores no grupo de contentores.
Contentor [] (obrigatório)
imageRegistryCredentials
As credenciais do registo de imagens a partir das quais o grupo de contentores é criado.
ImageRegistryCredential []
endereço ip
O tipo de endereço IP do grupo de contentores.
Endereço Ip
osType
O tipo de sistema operativo exigido pelos contentores no grupo de contentores.
'Linux' "Windows" (obrigatório)
restartPolicy
Reinicie a política para todos os contentores no grupo de contentores. Atualmente, a única opção disponível é always
.
"sempre"
volumes
A lista de volumes que podem ser montados por contentores neste grupo de contentores.
Volume []
Contentor
Nome
Descrição
Valor
name
O nome fornecido pelo utilizador da instância de contentor.
cadeia (obrigatório)
propriedades
As propriedades da instância de contentor.
ContainerProperties (obrigatório)
ContainerProperties
Nome
Descrição
Valor
command
Os comandos a executar na instância de contentor no formulário exec.
string[]
environmentVariables
As variáveis de ambiente a definir na instância de contentor.
EnvironmentVariable []
image
O nome da imagem utilizada para criar a instância de contentor.
cadeia (obrigatório)
ports
As portas expostas na instância de contentor.
ContainerPort []
resources
Os requisitos de recursos da instância de contentor.
ResourceRequirements (obrigatório)
volumeMounts
O volume é montado disponível para a instância de contentor.
VolumeMount []
EnvironmentVariable
Nome
Descrição
Valor
name
O nome da variável de ambiente.
cadeia (obrigatório)
valor
O valor da variável de ambiente.
cadeia (obrigatório)
ContainerPort
Nome
Descrição
Valor
porta
O número de porta exposto no grupo de contentores.
int (obrigatório)
ResourceRequirements
Nome
Descrição
Valor
limites
Os limites de recursos desta instância de contentor.
ResourceLimits
pedidos
Os pedidos de recursos desta instância de contentor.
ResourceRequests (obrigatório)
ResourceLimits
Nome
Descrição
Valor
cpu
O limite de CPU desta instância de contentor.
int
memoryInGB
O limite de memória em GB desta instância de contentor. Para especificar um valor decimal, utilize a função json( ).
int ou json decimal
ResourceRequests
Nome
Descrição
Valor
cpu
O pedido de CPU desta instância de contentor.
int (obrigatório)
memoryInGB
O pedido de memória em GB desta instância de contentor. Para especificar um valor decimal, utilize a função json( ).
int ou json decimal (obrigatório)
VolumeMount
Nome
Descrição
Valor
mountPath
O caminho no contentor onde o volume deve ser montado. Não pode conter dois pontos (:).
cadeia (obrigatório)
name
O nome da montagem do volume.
cadeia (obrigatório)
readOnly
O sinalizador que indica se a montagem do volume é só de leitura.
bool
ImageRegistryCredential
Nome
Descrição
Valor
palavra-passe
A palavra-passe do registo privado.
string
servidor
O servidor de registo de imagens do Docker sem um protocolo, como "http" e "https".
cadeia (obrigatório)
nome de utilizador
O nome de utilizador do registo privado.
cadeia (obrigatório)
Endereço Ip
Nome
Descrição
Valor
ip
O IP exposto à Internet pública.
string
ports
A lista de portas expostas no grupo de contentores.
Porta [] (obrigatório)
tipo
Especifica se o IP está 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 de Ficheiros do Azure.
AzureFileVolume (obrigatório)
name
O nome do volume.
cadeia (obrigatório)
AzureFileVolume
Nome
Descrição
Valor
readOnly
O sinalizador que indica se o Ficheiro do Azure partilhado montado como um volume é só de leitura.
bool
shareName
O nome da partilha de Ficheiros do Azure a ser montada como um volume.
cadeia (obrigatório)
storageAccountKey
A chave de acesso da conta de armazenamento utilizada para aceder à partilha de Ficheiros do Azure.
string
storageAccountName
O nome da conta de armazenamento que contém a partilha de Ficheiros do Azure.
cadeia (obrigatório)
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
Definição de recurso de modelo do ARM
O tipo de recurso containerGroups pode ser implementado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações .
Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o seguinte JSON ao seu 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 (obrigatório) Limite de carateres: 1-63 Carateres válidos: Letras minúsculas, números e hífenes. Não é possível iniciar ou terminar com hífen. Os hífenes consecutivos não são permitidos.
localização
A localização do recurso.
cadeia (obrigatório)
etiquetas
As etiquetas de recursos.
Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
propriedades
ContainerGroupProperties (obrigatório)
ContainerGroupProperties
Nome
Descrição
Valor
containers
Os contentores no grupo de contentores.
Contentor [] (obrigatório)
imageRegistryCredentials
As credenciais do registo de imagens a partir das quais o grupo de contentores é criado.
ImageRegistryCredential []
ipAddress
O tipo de endereço IP do grupo de contentores.
IpAddress
osType
O tipo de sistema operativo exigido pelos contentores no grupo de contentores.
'Linux' "Windows" (obrigatório)
restartPolicy
Reinicie a política para todos os contentores no grupo de contentores. Atualmente, a única opção disponível é always
.
"sempre"
volumes
A lista de volumes que podem ser montados por contentores neste grupo de contentores.
Volume []
Contentor
Nome
Descrição
Valor
name
O nome fornecido pelo utilizador da instância de contentor.
cadeia (obrigatório)
propriedades
As propriedades da instância de contentor.
ContainerProperties (obrigatório)
ContainerProperties
Nome
Descrição
Valor
command
Os comandos a executar na instância de contentor no formulário exec.
cadeia[]
environmentVariables
As variáveis de ambiente a definir na instância de contentor.
EnvironmentVariable []
image
O nome da imagem utilizada para criar a instância de contentor.
cadeia (obrigatório)
ports
As portas expostas na instância do contentor.
ContainerPort []
resources
Os requisitos de recursos da instância de contentor.
ResourceRequirements (obrigatório)
volumeMounts
O volume é montado disponível para a instância de contentor.
VolumeMount []
EnvironmentVariable
Nome
Descrição
Valor
name
O nome da variável de ambiente.
cadeia (obrigatório)
valor
O valor da variável de ambiente.
cadeia (obrigatório)
ContainerPort
Nome
Descrição
Valor
porta
O número de porta exposto no grupo de contentores.
int (obrigatório)
ResourceRequirements
Nome
Descrição
Valor
limites
Os limites de recursos desta instância de contentor.
ResourceLimits
pedidos
Os pedidos de recursos desta instância de contentor.
ResourceRequests (obrigatório)
ResourceLimits
Nome
Descrição
Valor
cpu
O limite de CPU desta instância de contentor.
int
memoryInGB
O limite de memória em GB desta instância de contentor. Para especificar um valor decimal, utilize a função json( ).
int ou json decimal
ResourceRequests
Nome
Descrição
Valor
cpu
O pedido de CPU desta instância de contentor.
int (obrigatório)
memoryInGB
O pedido de memória em GB desta instância de contentor. Para especificar um valor decimal, utilize a função json( ).
int ou json decimal (obrigatório)
VolumeMount
Nome
Descrição
Valor
mountPath
O caminho no contentor onde o volume deve ser montado. Não pode conter dois pontos (:).
cadeia (obrigatório)
name
O nome da montagem do volume.
cadeia (obrigatório)
readOnly
O sinalizador que indica se a montagem do volume é só de leitura.
bool
ImageRegistryCredential
Nome
Descrição
Valor
palavra-passe
A palavra-passe do registo privado.
string
servidor
O servidor de registo de imagens do Docker sem um protocolo, como "http" e "https".
cadeia (obrigatório)
nome de utilizador
O nome de utilizador do registo privado.
cadeia (obrigatório)
Endereço Ip
Nome
Descrição
Valor
ip
O IP exposto à Internet pública.
string
ports
A lista de portas expostas no grupo de contentores.
Porta [] (obrigatório)
tipo
Especifica se o IP está 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 de Ficheiro do Azure.
AzureFileVolume (obrigatório)
name
O nome do volume.
cadeia (obrigatório)
AzureFileVolume
Nome
Descrição
Valor
readOnly
O sinalizador que indica se o Ficheiro do Azure partilhado montado como um volume é só de leitura.
bool
shareName
O nome da partilha de Ficheiros do Azure a montar como um volume.
cadeia (obrigatório)
storageAccountKey
A chave de acesso da conta de armazenamento utilizada para aceder à partilha de Ficheiros do Azure.
string
storageAccountName
O nome da conta de armazenamento que contém a partilha de Ficheiros do Azure.
cadeia (obrigatório)
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
O tipo de recurso containerGroups pode ser implementado com operações que visam:
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações .
Para criar um recurso Microsoft.ContainerInstance/containerGroups, adicione o seguinte Terraform ao seu 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 (obrigatório) Limite de carateres: 1-63 Carateres válidos: Letras minúsculas, números e hífenes. Não é possível iniciar ou terminar com hífen. Os hífenes consecutivos não são permitidos.
localização
A localização do recurso.
cadeia (obrigatório)
parent_id
Para implementar num grupo de recursos, utilize o ID desse grupo de recursos.
cadeia (obrigatório)
etiquetas
As etiquetas de recursos.
Dicionário de nomes e valores de etiquetas.
propriedades
ContainerGroupProperties (obrigatório)
ContainerGroupProperties
Nome
Descrição
Valor
containers
Os contentores no grupo de contentores.
Contentor [] (obrigatório)
imageRegistryCredentials
As credenciais do registo de imagens a partir das quais o grupo de contentores é criado.
ImageRegistryCredential []
ipAddress
O tipo de endereço IP do grupo de contentores.
IpAddress
osType
O tipo de sistema operativo exigido pelos contentores no grupo de contentores.
"Linux" "Windows" (obrigatório)
restartPolicy
Reinicie a política para todos os contentores no grupo de contentores. Atualmente, a única opção disponível é always
.
"sempre"
volumes
A lista de volumes que podem ser montados por contentores neste grupo de contentores.
Volume []
Contentor
Nome
Descrição
Valor
name
O nome fornecido pelo utilizador da instância de contentor.
cadeia (obrigatório)
propriedades
As propriedades da instância de contentor.
ContainerProperties (obrigatório)
ContainerProperties
Nome
Descrição
Valor
command
Os comandos a executar na instância de contentor no formulário exec.
cadeia[]
environmentVariables
As variáveis de ambiente a definir na instância de contentor.
EnvironmentVariable []
image
O nome da imagem utilizada para criar a instância de contentor.
cadeia (obrigatório)
ports
As portas expostas na instância do contentor.
ContainerPort []
resources
Os requisitos de recursos da instância de contentor.
ResourceRequirements (obrigatório)
volumeMounts
O volume é montado disponível para a instância de contentor.
VolumeMount []
EnvironmentVariable
Nome
Descrição
Valor
name
O nome da variável de ambiente.
cadeia (obrigatório)
valor
O valor da variável de ambiente.
cadeia (obrigatório)
ContainerPort
Nome
Descrição
Valor
porta
O número de porta exposto no grupo de contentores.
int (obrigatório)
ResourceRequirements
Nome
Descrição
Valor
limites
Os limites de recursos desta instância de contentor.
ResourceLimits
pedidos
Os pedidos de recursos desta instância de contentor.
ResourceRequests (necessário)
ResourceLimits
Nome
Descrição
Valor
cpu
O limite de CPU desta instância de contentor.
int
memoryInGB
O limite de memória em GB desta instância de contentor. Especifique um valor decimal como uma cadeia.
int ou json decimal
ResourceRequests
Nome
Descrição
Valor
cpu
O pedido da CPU desta instância de contentor.
int (obrigatório)
memoryInGB
O pedido de memória em GB desta instância de contentor. Especifique um valor decimal como uma cadeia.
int ou json decimal (obrigatório)
VolumeMount
Nome
Descrição
Valor
mountPath
O caminho no contentor onde o volume deve ser montado. Não pode conter dois pontos (:).
cadeia (obrigatório)
name
O nome da montagem do volume.
cadeia (obrigatório)
readOnly
O sinalizador que indica se a montagem do volume é só de leitura.
bool
ImageRegistryCredential
Nome
Descrição
Valor
palavra-passe
A palavra-passe do registo privado.
string
servidor
O servidor de registo de imagens do Docker sem um protocolo, como "http" e "https".
cadeia (obrigatório)
nome de utilizador
O nome de utilizador do registo privado.
cadeia (obrigatório)
IpAddress
Nome
Descrição
Valor
ip
O IP exposto à Internet pública.
string
ports
A lista de portas expostas no grupo de contentores.
Porta [] (obrigatório)
tipo
Especifica se o IP está 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 de Ficheiros do Azure.
AzureFileVolume (obrigatório)
name
O nome do volume.
cadeia (obrigatório)
AzureFileVolume
Nome
Descrição
Valor
readOnly
O sinalizador que indica se o Ficheiro do Azure partilhado montado como um volume é só de leitura.
bool
shareName
O nome da partilha de Ficheiros do Azure a ser montada como um volume.
cadeia (obrigatório)
storageAccountKey
A chave de acesso da conta de armazenamento utilizada para aceder à partilha de Ficheiros do Azure.
string
storageAccountName
O nome da conta de armazenamento que contém a partilha de Ficheiros do Azure.
cadeia (obrigatório)