YAML-referencia: Azure Container Instances

Ez a cikk a tárolócsoport konfigurálásához Azure Container Instances által támogatott YAML-fájl szintaxisát és tulajdonságait ismerteti. YAML-fájl használatával adja meg a csoportkonfigurációt az az container create parancshoz az Azure CLI-ben.

A YAML-fájlok kényelmesen konfigurálhatók a reprodukálható üzemelő példányok tárolócsoportjaihoz. Ez egy tömör alternatíva, ha egy Resource Manager sablont vagy Azure Container Instances SDK-t használ tárolócsoport létrehozásához vagy frissítéséhez.

Megjegyzés

Ez a hivatkozás a AZURE CONTAINER INSTANCES REST API-verziójának 2021-10-01YAML-fájljaira vonatkozik.

Séma

A YAML-fájl sémája a következő, a főbb tulajdonságok kiemelésére vonatkozó megjegyzésekkel együtt. A séma tulajdonságainak leírását a Tulajdonságértékek szakaszban találja.

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

Tulajdonságértékek

Az alábbi táblázatok a sémában beállítandó értékeket írják le.

Microsoft.ContainerInstance/containerGroups objektum

Név Típus Kötelező Érték
name sztring Igen A tárolócsoport neve.
apiVersion Enum Yes 2021-10-01 (legújabb), 2021-09-01, 2021-07-01, 2021-03-01, 2020-11-01, 2019-12-01, 2018-10-01, 2018-09-01, 2018-07-01, 2018-06-01, 2018-04-01
location sztring No Az erőforrás helye.
tags object No Az erőforráscímkék.
identity object No A tárolócsoport identitása, ha konfigurálva van. - ContainerGroupIdentity objektum
properties object Yes ContainerGroupProperties objektum

ContainerGroupIdentity objektum

Név Típus Kötelező Érték
típus Enum No A tárolócsoporthoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolítja az identitásokat a tárolócsoportból. - SystemAssigned, UserAssigned, SystemAssigned, UserAssigned, None
userAssignedIdentities object No A tárolócsoporthoz társított felhasználói identitások listája. A felhasználói identitás szótárának kulcshivatkozásai az Azure Resource Manager erőforrás-azonosítók lesznek a következő űrlapon: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

ContainerGroupProperties objektum

Név Típus Kötelező Érték
tárolók array Yes A tárolócsoporton belüli tárolók. - Tárolóobjektum
imageRegistryCredentials array No A lemezkép-beállításjegyzék hitelesítő adatai, amelyekből a tárolócsoport létrejön. - ImageRegistryCredential objektum
restartPolicy Enum No Indítsa újra a házirendet a tárolócsoport összes tárolójára vonatkozóan. - Always Mindig újrainduljon – OnFailure Újraindítás sikertelenül – Never Soha ne indítsa újra. - Always, OnFailure, Never
ipAddress object No A tárolócsoport IP-címtípusa. - IpAddress objektum
osType Enum Yes A tárolócsoport tárolói által igényelt operációsrendszer-típus. - Windows vagy Linux
volumes array No A tárolócsoport tárolói által csatlakoztatható kötetek listája. - Kötetobjektum
diagnosztika object No Egy tárolócsoport diagnosztikai információi. - ContainerGroupDiagnostics objektum
alhálózati azonosítók object No Egy tárolócsoport alhálózati információi. - ContainerGroupSubnetIds objektum
dnsConfig object No Egy tárolócsoport DNS-konfigurációs információi. - DnsConfiguration objektum
Sku Enum No Tárolócsoport termékváltozata – Standard vagy Dedikált
encryptionProperties object No A tárolócsoportok titkosítási tulajdonságai. - EncryptionProperties objektum
initContainers array No Egy tárolócsoport init-tárolói. - InitContainerDefinition objektum

Tárolóobjektum

Név Típus Kötelező Érték
name sztring Igen A tárolópéldány felhasználó által megadott neve.
properties object Yes A tárolópéldány tulajdonságai. - ContainerProperties objektum

ImageRegistryCredential objektum

Név Típus Kötelező Érték
kiszolgáló sztring Igen A Docker lemezkép-beállításjegyzék-kiszolgálója protokoll nélkül, például "http" és "https".
username sztring No A privát beállításjegyzék felhasználóneve.
jelszó sztring No A privát beállításjegyzék jelszava.
identity sztring No A hitelesítéshez használt felhasználó vagy rendszer által hozzárendelt felügyelt identitás erőforrás-azonosítója.
identityUrl sztring No A privát beállításjegyzék identitás URL-címe.

IpAddress objektum

Név Típus Kötelező Érték
ports array Yes A tárolócsoportban közzétett portok listája. - Portobjektum
típus Enum Yes Azt adja meg, hogy az IP-cím elérhetővé legyen-e téve a nyilvános internetnek vagy a magánhálózati virtuális hálózatnak. - Nyilvános vagy privát
Ip sztring No A nyilvános interneten elérhető IP-cím.
dnsNameLabel sztring No Az IP-cím DNS-névcímkéje.

Kötetobjektum

Név Típus Kötelező Érték
name sztring Igen A kötet neve.
azureFile object No Az Azure File-kötet. - AzureFileVolume objektum
emptyDir object No Az üres könyvtárkötet.
titkos kód object No A titkos kötet.
gitRepo object No A Git-adattár kötete. - GitRepoVolume objektum

ContainerGroupDiagnostics objektum

Név Típus Kötelező Érték
logAnalytics object No Tárolócsoport naplóelemzési adatai. - LogAnalytics objektum

ContainerGroupSubnetIds objektum

Név Típus Kötelező Érték
id sztring Igen Az alhálózat azonosítója.
name sztring No Az alhálózat neve.

DnsConfiguration objektum

Név Típus Kötelező Érték
Névszervereket array Yes A tárolócsoport DNS-kiszolgálói. -Karakterlánc
searchDomains sztring No A DNS keresési tartományai a tárolócsoportban lévő állomásnév-kereséshez.
Lehetőségek sztring No A tárolócsoport DNS-beállításai.

EncryptionProperties objektum

Név Típus Kötelező Érték
vaultBaseUrl sztring Igen A keyvault alap URL-címe.
Kulcsnév sztring Igen A titkosítási kulcs neve.
keyVersion sztring Igen A titkosítási kulcs verziója.

InitContainerDefinition objektum

Név Típus Kötelező Érték
name sztring Igen Az init-tároló neve.
properties object Yes Az init-tároló tulajdonságai. - InitContainerPropertiesDefinition objektum

ContainerProperties objektum

Név Típus Kötelező Érték
image sztring Igen A tárolópéldány létrehozásához használt rendszerkép neve.
command array No A tárolópéldányban végrehajtható parancsok exec formában. -Karakterlánc
ports array No A tárolópéldány közzétett portja. - ContainerPort objektum
environmentVariables array No A tárolópéldányban beállítandó környezeti változók. - EnvironmentVariable objektum
resources object Yes A tárolópéldány erőforrás-követelményei. - ResourceRequirements objektum
volumeMounts array No A tárolópéldány számára elérhető kötetcsatlakozások. - VolumeMount objektum
livenessProbe object No Az élőképesség-mintavétel. - ContainerProbe objektum
readinessProbe object No A készültségi mintavétel. - ContainerProbe objektum

Portobjektum

Név Típus Kötelező Érték
Protokoll Enum No A porthoz társított protokoll. - TCP vagy UDP
port egész szám Yes A portszám.

AzureFileVolume objektum

Név Típus Kötelező Érték
shareName sztring Igen A kötetként csatlakoztatni kívánt Azure-fájlmegosztás neve.
readOnly boolean No A jelölő azt jelzi, hogy a kötetként csatlakoztatott Megosztott Azure-fájl írásvédett-e.
storageAccountName sztring Igen Az Azure-fájlmegosztást tartalmazó tárfiók neve.
storageAccountKey sztring No Az Azure-fájlmegosztás eléréséhez használt tárfiók hozzáférési kulcsa.

GitRepoVolume objektum

Név Típus Kötelező Érték
címtár sztring No Célkönyvtár neve. Nem tartalmazhat és nem kezdődhet ".." betűvel. Ha "." van megadva, a kötetkönyvtár lesz a git-adattár. Ellenkező esetben, ha meg van adva, a kötet a git-adattárat fogja tartalmazni az alkönyvtárban a megadott névvel.
repository sztring Igen Adattár URL-címe
változat sztring No Véglegesítési kivonat a megadott változathoz.

LogAnalytics objektum

Név Típus Kötelező Érték
workspaceId sztring Igen A log analytics munkaterület-azonosítója
workspaceKey sztring Igen A log analytics munkaterületkulcsa
workspaceResourceId sztring No A log analytics munkaterületi erőforrás-azonosítója
logType Enum No A használni kívánt naplótípus. - ContainerInsights vagy ContainerInstanceLogs
metaadatok object No A log analytics metaadatai.

InitContainerPropertiesDefinition objektum

Név Típus Kötelező Érték
image sztring No Az init-tároló képe.
command array No Az init-tárolóban végrehajtható parancs exec formában. -Karakterlánc
environmentVariables array No Az init-tárolóban beállítandó környezeti változók. - EnvironmentVariable objektum
volumeMounts array No A kötet csatlakoztatható az init-tárolóhoz. - VolumeMount objektum

ContainerPort objektum

Név Típus Kötelező Érték
Protokoll Enum No A porthoz társított protokoll. - TCP vagy UDP
port egész szám Yes A tárolócsoporton belül közzétett portszám.

EnvironmentVariable objektum

Név Típus Kötelező Érték
name sztring Igen A környezeti változó neve.
érték sztring No A környezeti változó értéke.
secureValue sztring No A biztonságos környezeti változó értéke.

ResourceRequirements objektum

Név Típus Kötelező Érték
Kérelmek object Yes A tárolópéldány erőforrás-kérelmei. - ResourceRequests objektum
Határok object No A tárolópéldány erőforráskorlátai. - ResourceLimits objektum

VolumeMount objektum

Név Típus Kötelező Érték
name sztring Igen A kötet csatlakoztatásának neve.
mountPath sztring Igen Annak a tárolónak az elérési útja, amelyen a kötetet csatlakoztatni kell. Nem tartalmazhat kettőspontot (:).
readOnly boolean No A jelölő, amely jelzi, hogy a kötet csatlakoztatása írásvédett-e.

ContainerProbe objektum

Név Típus Kötelező Érték
Exec object No A mintavételezés végrehajtási parancsa – ContainerExec objektum
httpGet object No A mintavételhez használandó HTTP-lekérési beállítások – TárolóhttpGet-objektum
initialDelaySeconds egész szám No A kezdeti késleltetési másodperc.
periodSeconds egész szám No Az időszak másodperce.
failureThreshold egész szám No A hiba küszöbértéke.
successThreshold egész szám No A siker küszöbértéke.
timeoutSeconds egész szám No Az időtúllépési másodperc.

ResourceRequests objektum

Név Típus Kötelező Érték
memoryInGB szám Yes A tárolópéldány GB-beli memóriakérelmének száma.
Cpu szám Yes A tárolópéldány CPU-kérése.
Gpu object No A tárolópéldány GPU-kérése. - GpuResource objektum

ResourceLimits objektum

Név Típus Kötelező Érték
memoryInGB szám No A tárolópéldány GB-ban megadott memóriakorlátja.
Cpu szám No A tárolópéldány processzorkorlátja.
Gpu object No A tárolópéldány GPU-korlátja. - GpuResource objektum

ContainerExec objektum

Név Típus Kötelező Érték
command array No A tárolóban végrehajtandó parancsok. -Karakterlánc

TárolóhttpGet objektum

Név Típus Kötelező Érték
path sztring No A mintavétel elérési útja.
port egész szám Yes A mintavételhez használt port száma.
Rendszer Enum No A séma. - http vagy https
httpHeaders object No A mintavételben szereplő HTTP-fejlécek. - HttpHeaders-objektum

HttpHeaders-objektum

Név Típus Kötelező Érték
name sztring No A fejléc neve.
érték sztring No A fejléc értéke.

Fontos

A K80- és P100 GPU-termékváltozatok 2023. augusztus 31-ig megszűnnek. Ennek oka a használt mögöttes virtuális gépek kivonása: NC sorozat és NCv2 sorozat Bár a V100 termékváltozatok elérhetők lesznek, a rendszer Azure Kubernetes Service használ. A GPU-erőforrások nem teljes mértékben támogatottak, és nem használhatók éles számítási feladatokhoz. A következő erőforrásokat használhatja az AKS-be való migráláshoz: Migrálás az AKS-be.

GpuResource objektum

Név Típus Kötelező Érték
count egész szám Yes A GPU-erőforrás száma.
Sku Enum Yes A GPU-erőforrás termékváltozata. - V100

Következő lépések

Lásd: Többtárolós csoport üzembe helyezése YAML-fájl használatával.

Példák arra, hogy yaML-fájl használatával helyezhet üzembe tárolócsoportokat egy virtuális hálózaton , vagy külső kötetet csatlakoztathat.