Referenční informace k YAML: Azure Container Instances
Článek
Tento článek popisuje syntaxi a vlastnosti souboru YAML podporovaného Azure Container Instances ke konfiguraci skupiny kontejnerů. Pomocí souboru YAML zadejte konfiguraci skupiny do příkazu az container create v Azure CLI.
Soubor YAML je pohodlný způsob konfigurace skupiny kontejnerů pro reprodukovatelná nasazení. Je to stručná alternativa k vytvoření nebo aktualizaci skupiny kontejnerů pomocí šablony Resource Manager nebo sad SDK Azure Container Instances.
Poznámka
Tento odkaz se týká souborů YAML pro Azure Container Instances verze 2021-10-01rozhraní REST API .
Schéma
Následuje schéma pro soubor YAML, včetně komentářů ke zvýraznění klíčových vlastností. Popis vlastností v tomto schématu najdete v části Hodnoty vlastností .
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
Hodnoty vlastností
Následující tabulky popisují hodnoty, které je potřeba nastavit ve schématu.
Objekt Microsoft.ContainerInstance/containerGroups
Typ identity použité pro skupinu kontejnerů. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere ze skupiny kontejnerů všechny identity. – SystemAssigned, UserAssigned, SystemAssigned, UserAssigned, None
userAssignedIdentity
object
No
Seznam identit uživatelů přidružených ke skupině kontejnerů. Odkazy na klíče slovníku identit uživatelů budou ID prostředků Azure Resource Manager ve formátu /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.
Restartujte zásady pro všechny kontejnery v rámci skupiny kontejnerů. - Always Vždy restartovat – OnFailure Restartovat při selhání – Never Nikdy restartovat. - Vždy, OnFailure, Nikdy
Název sdílené složky Azure, která se má připojit jako svazek.
Readonly
boolean
No
Příznak označující, jestli je sdílený soubor Azure připojený jako svazek jen pro čtení.
storageAccountName
řetězec
Yes
Název účtu úložiště, který obsahuje sdílenou složku Azure.
storageAccountKey
řetězec
No
Přístupový klíč účtu úložiště, který se používá pro přístup ke sdílené složce Azure.
Objekt GitRepoVolume
Název
Typ
Vyžadováno
Hodnota
adresář
řetězec
No
Název cílového adresáře. Nesmí obsahovat ani začínat na ... Pokud zadáte ., adresář svazku bude úložištěm Git. V opačném případě bude svazek obsahovat úložiště git v podadresáři se zadaným názvem.
úložiště
řetězec
Yes
Adresa URL úložiště
revision
řetězec
No
Hodnota hash potvrzení pro zadanou revizi
Objekt LogAnalytics
Název
Typ
Vyžadováno
Hodnota
workspaceId
řetězec
Yes
ID pracovního prostoru pro Log Analytics
klíč pracovního prostoru
řetězec
Yes
Klíč pracovního prostoru pro Log Analytics
id prostředku pracovního prostoru
řetězec
No
ID prostředku pracovního prostoru pro Log Analytics
logType
enum
No
Typ protokolu, který se má použít. – ContainerInsights nebo ContainerInstanceLogs
zprostředkovatele identity
object
No
Metadata pro Log Analytics.
InitContainerPropertiesDefinition – objekt
Název
Typ
Vyžadováno
Hodnota
image
řetězec
No
Obrázek kontejneru init.
command
array
No
Příkaz, který se má spustit v kontejneru init ve formuláři exec. -Řetězec
Skladové položky GPU K80 a P100 budou vyřazeny do 31. srpna 2023. Důvodem je vyřazení použitých základních virtuálních počítačů: NC Series a NCv2 Series I když budou k dispozici skladové položky V100, mění se na používání Azure Kubernetes Service. Prostředky GPU nejsou plně podporované a neměly by se používat pro produkční úlohy. Při migraci do AKS využijte ještě dnes následující zdroje informací: Postup migrace do AKS.