Megosztás a következőn keresztül:


YAML-referencia: Azure Container Instances

Ez a cikk az Azure Container Instances által a tárolócsoport konfigurálásához 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 egy tárolócsoportot reprodukálható üzemelő példányokhoz. Ez egy tömör alternatíva a Resource Manager-sablon vagy az Azure Container Instances SDK-k használatával tárolócsoport létrehozásához vagy frissítéséhez.

Feljegyzés

Ez a hivatkozás az Azure Container Instances REST API-verziójához 2021-10-01készült YAML-fájlokra vonatkozik.

Séma

A YAML-fájl sémája a következő, beleértve a főbb tulajdonságok kiemelésére vonatkozó megjegyzéseket is. 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ítani kívánt értékeket ismertetik.

Microsoft.ContainerInstance/containerGroups objektum

Név Típus Kötelező Érték
név sztring Igen A tárolócsoport neve.
apiVersion Enum Igen 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
hely húr Nem Az erőforrás helye.
címkét object Nem Az erőforráscímkék.
identitás object Nem A tárolócsoport identitása, ha konfigurálva van. - ContainerGroupIdentity objektum
tulajdonságok object Igen ContainerGroupProperties objektum

ContainerGroupIdentity objektum

Név Típus Kötelező Érték
típus Enum Nem 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ít minden identitást a tárolócsoportból. - SystemAssigned, UserAssigned, SystemAssigned, UserAssigned, None
userAssignedIdentities object Nem A tárolócsoporthoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai az Azure Resource Manager erőforrásazonosítói a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

ContainerGroupProperties objektum

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

Tárolóobjektum

Név Típus Kötelező Érték
név sztring Igen A tárolópéldány felhasználó által megadott neve.
tulajdonságok object Igen 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 rendszerkép-beállításjegyzék-kiszolgálója protokoll nélkül, például "http" és "https".
username húr Nem A magánregisztrációs adatbázis felhasználóneve.
jelszó húr Nem A privát beállításjegyzék jelszava.
identitás húr Nem A hitelesítéshez használt felhasználó vagy rendszer által hozzárendelt felügyelt identitás erőforrás-azonosítója.
identityUrl húr Nem 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 Igen A tárolócsoportban közzétett portok listája. - Portobjektum
típus Enum Igen Megadja, hogy az IP-cím a nyilvános internet vagy a magánhálózat számára legyen-e kitéve. - Nyilvános vagy privát
Ip húr Nem A nyilvános interneten közzétett IP-cím.
dnsNameLabel húr Nem Az IP dns-névfelirata.

Kötetobjektum

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

ContainerGroupDiagnostics objektum

Név Típus Kötelező Érték
logAnalytics object Nem 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.
név húr Nem Az alhálózat neve.

DnsConfiguration objektum

Név Típus Kötelező Érték
nameServers array Igen A tárolócsoport DNS-kiszolgálói. -húr
searchDomains húr Nem A DNS-keresési tartományok a tárolócsoport gazdagépnév-kereséséhez.
beállítások húr Nem 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.
keyName 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
név sztring Igen Az init-tároló neve.
tulajdonságok object Igen Az init-tároló tulajdonságai. - InitContainerPropertiesDefinition objektum

ContainerProperties objektum

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

Portobjektum

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

AzureFileVolume objektum

Név Típus Kötelező Érték
shareName sztring Igen A kötetként csatlakoztatandó Azure-fájlmegosztás neve.
readOnly Logikai Nem Az a jelző, amely jelzi, hogy a kötetként csatlakoztatott Azure-fájl írásvédett-e.
storageAccountName sztring Igen Az Azure-fájlmegosztást tartalmazó tárfiók neve.
storageAccountKey húr Nem 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 húr Nem Célkönyvtár neve. Nem tartalmazhat és nem kezdődhet ".." betűvel. Ha "." van megadva, a kötetkönyvtár a Git-adattár. Ellenkező esetben a kötet a git-adattárat tartalmazza az alkönyvtárban a megadott névvel.
repository sztring Igen Adattár URL-címe
átvizsgálás húr Nem 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 húr Nem A log analytics munkaterületi erőforrás-azonosítója
logType Enum Nem A használni kívánt naplótípus. - ContainerInsights vagy ContainerInstanceLogs
metaadatok object Nem A naplóelemzés metaadatai.

InitContainerPropertiesDefinition objektum

Név Típus Kötelező Érték
rendszerkép húr Nem Az init-tároló képe.
command array Nem Az init-tárolóban végrehajtható parancs exec formában. -húr
environmentVariables array Nem Az init-tárolóban beállítandó környezeti változók. - EnvironmentVariable objektum
volumeMounts array Nem Az init-tároló számára elérhető kötet-csatlakoztatások. - VolumeMount objektum

ContainerPort objektum

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

EnvironmentVariable objektum

Név Típus Kötelező Érték
név sztring Igen A környezeti változó neve.
Érték húr Nem A környezeti változó értéke.
secureValue húr Nem A biztonságos környezeti változó értéke.

ResourceRequirements objektum

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

VolumeMount objektum

Név Típus Kötelező Érték
név 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 Logikai Nem Az a jelző, amely jelzi, hogy a kötet csatlakoztatása írásvédett-e.

ContainerProbe objektum

Név Típus Kötelező Érték
főnök object Nem A mintavételhez használni kívánt végrehajtási parancs – ContainerExec objektum
httpGet object Nem A mintavételhez használandó Http Get-beállítások – ContainerHttpGet objektum
initialDelaySeconds egész szám Nem A kezdeti késleltetés másodperce.
periodSeconds egész szám Nem Az időszak másodperce.
failureThreshold egész szám Nem A hibaküszöb.
successThreshold egész szám Nem A siker küszöbértéke.
timeoutSeconds egész szám Nem Az időtúllépés másodperce.

ResourceRequests objektum

Név Típus Kötelező Érték
memoryInGB szám Igen A tárolópéldány GB-beli memóriakérelmét.
cpu szám Igen A tárolópéldány CPU-kérése.
gpu object Nem 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 Nem A tárolópéldány GB-beli memóriakorlátja.
cpu szám Nem A tárolópéldány cpu-korlátja.
gpu object Nem A tárolópéldány GPU-korlátja. - GpuResource objektum

ContainerExec objektum

Név Típus Kötelező Érték
command array Nem A tárolón belül végrehajtandó parancsok. -húr

ContainerHttpGet objektum

Név Típus Kötelező Érték
ösvény húr Nem A mintavétel elérési útja.
kikötő egész szám Igen A mintavételhez használt port száma.
cselszövés Enum Nem A séma. - http vagy https
httpHeaders object Nem A mintavételben szereplő HTTP-fejlécek. - HttpHeaders-objektum

HttpHeaders-objektum

Név Típus Kötelező Érték
név húr Nem A fejléc neve.
Érték húr Nem A fejléc értéke.

Fontos

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

GpuResource objektum

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

Következő lépések

Tekintse meg a többtárolós csoport ÜZEMBE helyezése YAML-fájllal című oktatóanyagot.

Példák yaML-fájl használatával tárolócsoportok virtuális hálózaton való üzembe helyezésére vagy külső kötet csatlakoztatására.