Este artigo aborda a sintaxe e as propriedades do ficheiro YAML suportado pelo Azure Container Instances para configurar um grupo de contentores. Utilize um ficheiro YAML para introduzir a configuração do grupo no comando az container create na CLI do Azure.
Um ficheiro YAML é uma forma conveniente de configurar um grupo de contentores para implementações reproduzíveis. É uma alternativa concisa à utilização de um modelo de Resource Manager ou do Azure Container Instances SDKs para criar ou atualizar um grupo de contentores.
Nota
Esta referência aplica-se a ficheiros YAML para Azure Container Instances versão 2021-10-01da API REST.
Esquema
Segue-se o esquema do ficheiro YAML, incluindo comentários para realçar as propriedades da chave. Para obter uma descrição das propriedades neste esquema, veja a secção Valores de propriedade .
name: string # Name of the container group
apiVersion: '2021-10-01'
location: string
tags: {}
identity:
type: string
userAssignedIdentities: {}
properties: # Properties of container group
containers: # Array of container instances in the group
- name: string # Name of an instance
properties: # Properties of an instance
image: string # Container image used to create the instance
command:
- string
ports: # External-facing ports exposed on the instance, must also be set in group ipAddress property
- protocol: string
port: integer
environmentVariables:
- name: string
value: string
secureValue: string
resources: # Resource requirements of the instance
requests:
memoryInGB: number
cpu: number
gpu:
count: integer
sku: string
limits:
memoryInGB: number
cpu: number
gpu:
count: integer
sku: string
volumeMounts: # Array of volume mounts for the instance
- name: string
mountPath: string
readOnly: boolean
livenessProbe:
exec:
command:
- string
httpGet:
httpHeaders:
- name: string
value: string
path: string
port: integer
scheme: string
initialDelaySeconds: integer
periodSeconds: integer
failureThreshold: integer
successThreshold: integer
timeoutSeconds: integer
readinessProbe:
exec:
command:
- string
httpGet:
httpHeaders:
- name: string
value: string
path: string
port: integer
scheme: string
initialDelaySeconds: integer
periodSeconds: integer
failureThreshold: integer
successThreshold: integer
timeoutSeconds: integer
imageRegistryCredentials: # Credentials to pull a private image
- server: string
username: string
password: string
identity: string
identityUrl: string
restartPolicy: string
ipAddress: # IP address configuration of container group
ports:
- protocol: string
port: integer
type: string
ip: string
dnsNameLabel: string
dnsNameLabelReusePolicy: string
osType: string
volumes: # Array of volumes available to the instances
- name: string
azureFile:
shareName: string
readOnly: boolean
storageAccountName: string
storageAccountKey: string
emptyDir: {}
secret: {}
gitRepo:
directory: string
repository: string
revision: string
diagnostics:
logAnalytics:
workspaceId: string
workspaceKey: string
workspaceResourceId: string
logType: string
metadata: {}
subnetIds: # Subnet to deploy the container group into
- id: string
name: string
dnsConfig: # DNS configuration for container group
nameServers:
- string
searchDomains: string
options: string
sku: string # SKU for the container group
encryptionProperties:
vaultBaseUrl: string
keyName: string
keyVersion: string
initContainers: # Array of init containers in the group
- name: string
properties:
image: string
command:
- string
environmentVariables:
- name: string
value: string
secureValue: string
volumeMounts:
- name: string
mountPath: string
readOnly: boolean
Valores de propriedade
As tabelas seguintes descrevem os valores que tem de definir no esquema.
O tipo de identidade utilizado para o grupo de contentores. O tipo "SystemAssigned, UserAssigned" inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo utilizador. O tipo "Nenhum" removerá quaisquer identidades do grupo de contentores. - SystemAssigned, UserAssigned, SystemAssigned, UserAssigned, None
userAssignedIdentities
objeto
No
A lista de identidades de utilizador associadas ao grupo de contentores. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do Azure Resource Manager no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
Reinicie a política para todos os contentores no grupo de contentores. - Always Reiniciar sempre – OnFailure Reiniciar após a falha – Never Nunca reiniciar. - Always, OnFailure, Never
endereço ip
objeto
No
O tipo de endereço IP do grupo de contentores. - Objeto IpAddress
osType
enumeração
Yes
O tipo de sistema operativo exigido pelos contentores no grupo de contentores. - Windows ou Linux
volumes
matriz
No
A lista de volumes que podem ser montados por contentores neste grupo de contentores. - Objeto de volume
O nome da partilha de Ficheiros do Azure a montar como um volume.
readOnly
boolean
No
O sinalizador que indica se o Ficheiro do Azure partilhado montado como um volume é só de leitura.
storageAccountName
string
Yes
O nome da conta de armazenamento que contém a partilha de Ficheiros do Azure.
storageAccountKey
cadeia (de carateres)
No
A chave de acesso da conta de armazenamento utilizada para aceder à partilha de Ficheiros do Azure.
Objeto GitRepoVolume
Nome
Tipo
Necessário
Valor
diretório
cadeia (de carateres)
No
Nome do diretório de destino. Não pode conter ou começar com '.'. Se '.' for fornecido, o diretório de volume será o repositório git. Caso contrário, se for especificado, o volume irá conter o repositório git no subdiretório com o nome especificado.
repository
string
Yes
URL do repositório
revision
cadeia (de carateres)
No
Consolide o hash da revisão especificada.
Objeto LogAnalytics
Nome
Tipo
Necessário
Valor
workspaceId
string
Yes
O ID da área de trabalho do Log Analytics
workspaceKey
string
Yes
A chave da área de trabalho para a análise de registos
workspaceResourceId
cadeia (de carateres)
No
O ID do recurso da área de trabalho para a análise de registos
logType
enumeração
No
O tipo de registo a utilizar. - ContainerInsights ou ContainerInstanceLogs
do IdP
objeto
No
Metadados da análise de registos.
Objeto InitContainerPropertiesDefinition
Nome
Tipo
Necessário
Valor
image
cadeia (de carateres)
No
A imagem do contentor init.
command
matriz
No
O comando a executar no contentor init no formulário exec. - cadeia
As SKUs de GPU K80 e P100 serão descontinuadas até 31 de agosto de 2023. Tal deve-se à descontinuação das VMs subjacentes utilizadas: Série NC e Série NCv2 Embora os SKUs V100 estejam disponíveis, é reativado para utilizar Azure Kubernetes Service em vez disso. Os recursos de GPU não são totalmente suportados e não devem ser utilizados para cargas de trabalho de produção. Utilize os seguintes recursos para migrar para o AKS atualmente: Como Migrar para o AKS.