YAML 참조: Azure Container Instances

이 문서에서는 컨테이너 그룹을 구성하기 위해 Azure Container Instances에서 지원하는 YAML 파일의 구문과 속성을 설명합니다. YAML 파일은 Azure CLI에서 az container create 명령에 그룹 구성을 입력하는 데 사용됩니다.

YAML 파일은 재현 가능한 배포를 위해 컨테이너 그룹을 구성하는 편리한 방법입니다. Resource Manager 템플릿 또는 Azure Container Instances SDK를 사용하여 컨테이너 그룹을 만들거나 업데이트하는 방법의 간단한 대안이 되기도 합니다.

스키마

YAML 파일의 스키마는 키 속성을 강조 표시하는 주석을 포함하여 다음과 같습니다. 이 스키마의 속성에 대한 설명은 속성 값 섹션을 참조하세요.

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

속성 값

다음 표에서는 스키마에서 설정해야 하는 값을 설명합니다.

Microsoft.ContainerInstance/containerGroups 개체

ContainerGroupIdentity 개체

ContainerGroupProperties 개체

컨테이너 개체

ImageRegistryCredential 개체

IpAddress 개체

Volume 개체

ContainerGroupDiagnostics 개체

ContainerGroupSubnetIds 개체

DnsConfiguration 개체

EncryptionProperties 개체

InitContainerDefinition 개체

ContainerProperties 개체

포트 개체

AzureFileVolume 개체

GitRepoVolume 개체

LogAnalytics 개체

InitContainerPropertiesDefinition 개체

ContainerPort 개체

EnvironmentVariable 개체

ResourceRequirements 개체

VolumeMount 개체

ContainerProbe 개체

ResourceRequests 개체

ResourceLimits 개체

ContainerExec 개체

ContainerHttpGet 개체

HttpHeaders 개체

GpuResource 개체

다음 단계

YAML 파일을 사용하여 다중 컨테이너 그룹 배포 자습서를 참조하세요.

YAML 파일을 사용하여 가상 네트워크에서 컨테이너 그룹을 배포하거나 외부 볼륨을 탑재하는 예제를 참조하세요.