Referenční informace k YAML: Azure Container Instances
Článek
Tento článek popisuje syntaxi a vlastnosti souboru YAML podporovaného službou Azure Container Instances pro konfiguraci skupiny kontejnerů. Pomocí souboru YAML zadejte konfiguraci skupiny do příkazu az container create v Azure CLI.
Soubor YAML představuje pohodlný způsob konfigurace skupiny kontejnerů pro reprodukovatelná nasazení. Jedná se o stručnou alternativu k vytvoření nebo aktualizaci skupiny kontejnerů pomocí šablony Resource Manageru nebo sad SDK služby Azure Container Instances.
Poznámka:
Tento odkaz se vztahuje na soubory YAML pro verzi 2021-10-01rozhraní REST API služby Azure Container Instances .
Schéma
Schéma souboru YAML následuje, včetně komentářů ke zvýraznění klíčových vlastností. Popis vlastností v tomto schématu naleznete v části Hodnoty vlastnosti.
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, který se používá pro skupinu kontejnerů. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere všechny identity ze skupiny kontejnerů. – SystemAssigned, UserAssigned, SystemAssigned, UserAssigned, None
userAssignedIdentities
objekt
No
Seznam identit uživatelů přidružených ke skupině kontejnerů. Odkazy na klíč slovníku identit uživatele jsou ID prostředků Azure Resource Manageru ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.
Restartujte zásadu pro všechny kontejnery ve skupině kontejnerů. - Always Vždy restartovat – OnFailure Restartování při selhání – Never Nikdy se nerestartuje. - Vždy, OnFailure, Nikdy
Název sdílené složky Azure, která se má připojit jako svazek.
jen pro čtení
boolean
No
Příznak označující, jestli je sdílený soubor Azure připojený jako svazek jen pro čtení.
storageAccountName
string
Ano
Název účtu úložiště, který obsahuje sdílenou složku Azure.
storageAccountKey
string
No
Přístupový klíč účtu úložiště, který se používá pro přístup ke sdílené složce Azure.
Objekt GitRepoVolume
Name
Type
Požaduje se
Hodnota
adresář
string
No
Název cílového adresáře. Nesmí obsahovat ani začínat na ".". Pokud se zadá ".", adresář svazku je úložiště git. V opačném případě obsahuje svazek úložiště Git v podadresáři s daným názvem.
úložiště
string
Ano
Adresa URL úložiště
revision
string
No
Potvrďte hodnotu hash pro zadanou revizi.
Objekt LogAnalytics
Name
Type
Požaduje se
Hodnota
workspaceId
string
Ano
ID pracovního prostoru pro Log Analytics
workspaceKey
string
Ano
Klíč pracovního prostoru pro Log Analytics
workspaceResourceId
string
No
ID prostředku pracovního prostoru pro Log Analytics
logType
enum
No
Typ protokolu, který se má použít. – ContainerInsights nebo ContainerInstanceLogs
metadata
objekt
No
Metadata pro log analytics
InitContainerPropertiesDefinition – objekt
Name
Type
Požaduje se
Hodnota
image
string
No
Obrázek inicializačního kontejneru
příkaz
pole
No
Příkaz, který se má provést v kontejneru inicializačních souborů ve formuláři exec. -řetězec
Skladové položky GPU K80 a P100 se vyřazuje do 31. srpna 2023. Důvodem je vyřazení použitých základních virtuálních počítačů: Řada NC a řada NCv2 , i když budou k dispozici skladové položky V100, doporučujeme místo toho službu Azure Kubernetes Service znovu použít. Prostředky GPU nejsou plně podporované a neměly by se používat pro produkční úlohy. Pomocí následujících prostředků můžete migrovat do AKS ještě dnes: Jak migrovat do AKS.