Artikel ini membahas sintaks dan properti untuk file YAML yang didukung oleh Azure Container Instances untuk mengonfigurasi grup kontainer. Gunakan file YAML untuk memasukkan konfigurasi grup ke perintah az container create di Azure CLI.
File YAML adalah cara mudah untuk mengonfigurasi grup kontainer untuk penyebaran yang dapat direproduksi. Ini adalah alternatif singkat untuk menggunakan Templat Resource Manager atau SDK Azure Container Instances untuk membuat atau memperbarui grup kontainer.
Catatan
Referensi ini berlaku untuk file YAML untuk Azure Container Instances versi REST API 2021-10-01.
Skema
Skema untuk file YAML mengikuti, termasuk komentar untuk menyoroti properti utama. Untuk deskripsi properti dalam skema ini, lihat bagian Nilai properti.
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
Nilai properti
Tabel berikut menjelaskan nilai yang perlu Anda atur dalam skema.
Jenis identitas yang digunakan untuk grup kontainer. Jenis 'SystemAssigned, UserAssigned' mencakup identitas yang dibuat secara implisit dan sekumpulan identitas yang ditetapkan pengguna. Jenis 'None' akan menghapus identitas apa pun dari grup kontainer. - SystemAssigned, UserAssigned, SystemAssigned, UserAssigned, None
userAssignedIdentities
objek
Tidak
Daftar identitas pengguna yang terkait dengan grup kontainer. Referensi kunci kamus identitas pengguna akan menjadi ID sumber daya Azure Resource Manager dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Kebijakan hidupkan ulang untuk semua kontainer dalam grup kontainer. - Always Selalu hidupkan ulang- OnFailure Hidupkan ulang pada kegagalan- Never Jangan pernah hidupkan ulang. - Always, OnFailure, Never
Nama pembagian File Azure yang akan dipasang sebagai volume.
readOnly
boolean
Tidak
Bendera yang menunjukkan apakah File Azure yang dibagikan dipasang sebagai volume bersifat baca-saja.
storageAccountName
string
Ya
Nama akun penyimpanan yang berisi pembagian File Azure.
storageAccountKey
string
Tidak
Kunci akses akun penyimpanan yang digunakan untuk mengakses pembagian File Azure.
Objek GitRepoVolume
Nama
Jenis
Diperlukan
Nilai
direktori
string
Tidak
Nama direktori target. Tidak boleh berisi atau dimulai dengan '..'. Jika '.' disediakan, direktori volume akan menjadi repositori git. Jika tidak, jika ditentukan, volume akan berisi repositori git di subdirektori dengan nama yang diberikan.
repositori
string
Ya
URL repositori
revisi
string
Tidak
Terapkan hash untuk revisi yang ditentukan.
Objek LogAnalytics
Nama
Jenis
Diperlukan
Nilai
workspaceId
string
Ya
ID ruang kerja untuk analitik log
workspaceKey
string
Ya
Kunci ruang kerja untuk analitik log
workspaceResourceId
string
Tidak
ID sumber daya ruang kerja untuk analitik log
logType
enum
Tidak
Jenis log yang akan digunakan. - ContainerInsights atau ContainerInstanceLogs
metadata
objek
Tidak
Metadata untuk analitik log.
Objek InitContainerPropertiesDefinition
Nama
Jenis
Diperlukan
Nilai
gambar
string
Tidak
Gambar kontainer init.
perintah
array
Tidak
Perintah untuk menjalankan dalam kontainer init dalam bentuk eksekusi. - string
SKU GPU K80 dan P100 dihentikan pada 31 Agustus 2023. Hal ini disebabkan oleh penghentian VM yang mendasar yang digunakan: Seri NC dan Seri NCv2 Meskipun SKU V100 akan tersedia, V100 akan direceommended untuk menggunakan Azure Kubernetes Service sebagai gantinya. Sumber daya GPU tidak didukung sepenuhnya dan tidak boleh digunakan untuk beban kerja produksi. Gunakan sumber daya berikut untuk bermigrasi ke AKS hari ini: Cara Bermigrasi ke AKS.