Bu makalede, kapsayıcı grubunu yapılandırmak için Azure Container Instances tarafından desteklenen YAML dosyasının söz dizimi ve özellikleri yer alır. Grup yapılandırmasını Azure CLI'daki az container create komutuna giriş yapmak için YAML dosyası kullanın.
YAML dosyası, kapsayıcı grubunu yeniden üretilebilir dağıtımlar için yapılandırmanın kullanışlı bir yoludur. Kapsayıcı grubu oluşturmak veya güncelleştirmek için Resource Manager şablonu veya Azure Container Instances SDK'ları kullanmaya kısa bir alternatiftir.
Not
Bu başvuru, Azure Container Instances REST API sürümü 2021-10-01için YAML dosyaları için geçerlidir.
Şema
YAML dosyasının şeması, anahtar özellikleri vurgulamak için açıklamalar da dahil olmak üzere aşağıdaki gibidir. Bu şemadaki özelliklerin açıklaması için Özellik değerleri bölümüne bakın.
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
Özellik değerleri
Aşağıdaki tablolarda şemada ayarlamanız gereken değerler açıklanmaktadır.
Kapsayıcı grubu için kullanılan kimlik türü. 'SystemAssigned, UserAssigned' türü hem örtük olarak oluşturulmuş bir kimliği hem de kullanıcı tarafından atanan kimlik kümesini içerir. 'Hiçbiri' türü kapsayıcı grubundan tüm kimlikleri kaldırır. - SystemAssigned, UserAssigned, SystemAssigned, UserAssigned, None
userAssignedIdentities
object
No
Kapsayıcı grubuyla ilişkili kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlüğü anahtar başvuruları şu biçimde Azure Resource Manager kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Kapsayıcı grubundaki tüm kapsayıcılar için ilkeyi yeniden başlatın. - Always Her zaman yeniden başlat- OnFailure Hatada yeniden başlatma- Never Hiçbir zaman yeniden başlatma. - Her Zaman, OnFailure, Asla
Bağlantı noktasıyla ilişkili protokol. - TCP veya UDP
port
tamsayı
Yes
Bağlantı noktası numarası.
AzureFileVolume nesnesi
Ad
Tür
Gerekli
Değer
Paylaşımadı
string
Yes
Birim olarak bağlanacak Azure Dosya paylaşımının adı.
Readonly
boolean
No
Paylaşılan Azure Dosyasının birim olarak bağlanıp bağlanmadığını gösteren bayrak salt okunurdur.
storageAccountName
string
Yes
Azure Dosya paylaşımını içeren depolama hesabının adı.
storageAccountKey
dize
No
Azure Dosya paylaşımına erişmek için kullanılan depolama hesabı erişim anahtarı.
GitRepoVolume nesnesi
Ad
Tür
Gerekli
Değer
dizin
dize
No
Hedef dizin adı. '..' içermemeli veya '..' ile başlamamalıdır. '.' sağlanırsa birim dizini git deposu olur. Aksi takdirde, belirtilirse birim, verilen ada sahip alt dizindeki git deposunu içerir.
depo
string
Yes
Depo URL'si
revision
dize
No
Belirtilen düzeltme için karma işleyin.
LogAnalytics nesnesi
Ad
Tür
Gerekli
Değer
workspaceId
string
Yes
Log Analytics için çalışma alanı kimliği
workspaceKey
string
Yes
Log Analytics için çalışma alanı anahtarı
workspaceResourceId
dize
No
Log Analytics için çalışma alanı kaynak kimliği
Logtype
enum
No
Kullanılacak günlük türü. - ContainerInsights veya ContainerInstanceLogs
meta veriler
object
No
Log Analytics için meta veriler.
InitContainerPropertiesDefinition nesnesi
Ad
Tür
Gerekli
Değer
image
dize
No
init kapsayıcısının görüntüsü.
command
array
No
exec biçiminde init kapsayıcısı içinde yürütülecek komut. -Dize
K80 ve P100 GPU SKU'ları 31 Ağustos 2023'e kadar kaldırılıyor. Bunun nedeni, kullanılan temel vm'lerin kullanımdan kaldırılmasıdır: NC Serisi ve NCv2 Serisi V100 SKU'ları kullanılabilir olsa da, bunun yerine Azure Kubernetes Service kullanılması gerekir. GPU kaynakları tam olarak desteklenmez ve üretim iş yükleri için kullanılmamalıdır. Bugün AKS'ye geçiş yapmak için aşağıdaki kaynakları kullanın: AKS'ye Geçiş.