Den här artikeln beskriver syntaxen och egenskaperna för YAML-filen som stöds av Azure Container Instances för att konfigurera en containergrupp. Använd en YAML-fil för att ange gruppkonfigurationen till kommandot az container create i Azure CLI.
En YAML-fil är ett praktiskt sätt att konfigurera en containergrupp för reproducerbara distributioner. Det är ett kortfattat alternativ till att använda en Resource Manager-mall eller Azure Container Instances SDK:er för att skapa eller uppdatera en containergrupp.
Anteckning
Den här referensen gäller YAML-filer för Azure Container Instances REST API-version 2021-10-01.
Schema
Schemat för YAML-filen följer, inklusive kommentarer för att markera viktiga egenskaper. En beskrivning av egenskaperna i det här schemat finns i avsnittet Egenskapsvärden .
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
Egenskapsvärden
I följande tabeller beskrivs de värden som du behöver ange i schemat.
Den typ av identitet som används för containergruppen. Typen "SystemAssigned, UserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen "Ingen" tar bort alla identiteter från containergruppen. – SystemAssigned, UserAssigned, SystemAssigned, UserAssigned, None
userAssignedIdentities
objekt
No
Listan över användaridentiteter som är associerade med containergruppen. Nyckelreferenser för användaridentitetsordlistan är Azure Resource Manager resurs-ID:t i formatet: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Starta om principen för alla containrar i containergruppen. - Always Starta alltid om – OnFailure Starta om vid fel – Never Starta aldrig om. - Alltid, OnFailure, Aldrig
Protokollet som är associerat med porten. – TCP eller UDP
port
heltal
Yes
Portnumret.
AzureFileVolume-objekt
Namn
Typ
Obligatorisk
Värde
Resursnamn
sträng
Ja
Namnet på den Azure-filresurs som ska monteras som en volym.
Readonly
boolean
No
Flaggan som anger om Den delade Azure-filen som är monterad som en volym är skrivskyddad.
storageAccountName
sträng
Ja
Namnet på lagringskontot som innehåller Azure-filresursen.
storageAccountKey
sträng
No
Åtkomstnyckeln för lagringskontot som används för att komma åt Azure-filresursen.
GitRepoVolume-objekt
Namn
Typ
Obligatorisk
Värde
katalog
sträng
No
Målkatalognamn. Får inte innehålla eller börja med ... Om "." anges är volymkatalogen git-lagringsplatsen. Om detta anges innehåller volymen git-lagringsplatsen i underkatalogen med det angivna namnet.
repository
sträng
Ja
Url för lagringsplats
revision
sträng
No
Checka in hash för den angivna revisionen.
LogAnalytics-objekt
Namn
Typ
Obligatorisk
Värde
workspaceId
sträng
Ja
Arbetsyte-ID:t för log analytics
workspaceKey
sträng
Ja
Arbetsytenyckeln för log analytics
workspaceResourceId
sträng
No
Arbetsytans resurs-ID för Log Analytics
logType
Enum
No
Den loggtyp som ska användas. – ContainerInsights eller ContainerInstanceLogs
metadata
objekt
No
Metadata för Log Analytics.
InitContainerPropertiesDefinition-objekt
Namn
Typ
Obligatorisk
Värde
image
sträng
No
Avbildningen av init-containern.
command
matris
No
Kommandot som ska köras i init-containern i exec-format. -Sträng
K80- och P100 GPU-SKU:er drar sig tillbaka senast den 31 augusti 2023. Detta beror på tillbakadragandet av de underliggande virtuella datorer som används: NC-serien och NCv2-serien Även om V100-SKU:er kommer att vara tillgängliga, är det återanvänt att använda Azure Kubernetes Service i stället. GPU-resurser stöds inte fullt ut och bör inte användas för produktionsarbetsbelastningar. Använd följande resurser för att migrera till AKS idag: Så här migrerar du till AKS.