Microsoft.VirtualMachineImages imageTemplates
Bicep kaynak tanımı
imageTemplates kaynak türü şu şekilde dağıtılabilir:
- Kaynak grupları - Bkz. kaynak grubu dağıtım komutları
Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.
Kaynak biçimi
Microsoft.VirtualMachineImages/imageTemplates kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.
resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2022-02-14' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
identity: {
type: 'string'
userAssignedIdentities: {}
}
properties: {
buildTimeoutInMinutes: int
customize: [
{
name: 'string'
type: 'string'
// For remaining properties, see ImageTemplateCustomizer objects
}
]
distribute: [
{
artifactTags: {}
runOutputName: 'string'
type: 'string'
// For remaining properties, see ImageTemplateDistributor objects
}
]
source: {
type: 'string'
// For remaining properties, see ImageTemplateSource objects
}
stagingResourceGroup: 'string'
validate: {
continueDistributeOnFailure: bool
inVMValidations: [
{
name: 'string'
type: 'string'
// For remaining properties, see ImageTemplateInVMValidator objects
}
]
sourceValidationOnly: bool
}
vmProfile: {
osDiskSizeGB: int
userAssignedIdentities: [
'string'
]
vmSize: 'string'
vnetConfig: {
proxyVmSize: 'string'
subnetId: 'string'
}
}
}
}
ImageTemplateCustomizer nesneleri
nesnenin türünü belirtmek için type özelliğini ayarlayın.
Dosya için şunu kullanın:
type: 'File'
destination: 'string'
sha256Checksum: 'string'
sourceUri: 'string'
PowerShell için şunu kullanın:
type: 'PowerShell'
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
Shell için şunu kullanın:
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
WindowsRestart için şunu kullanın:
type: 'WindowsRestart'
restartCheckCommand: 'string'
restartCommand: 'string'
restartTimeout: 'string'
WindowsUpdate için şunu kullanın:
type: 'WindowsUpdate'
filters: [
'string'
]
searchCriteria: 'string'
updateLimit: int
ImageTemplateDistributor nesneleri
nesnenin türünü belirtmek için type özelliğini ayarlayın.
ManagedImage için şunu kullanın:
type: 'ManagedImage'
imageId: 'string'
location: 'string'
SharedImage için şunu kullanın:
type: 'SharedImage'
excludeFromLatest: bool
galleryImageId: 'string'
replicationRegions: [
'string'
]
storageAccountType: 'string'
VHD için şunu kullanın:
type: 'VHD'
ImageTemplateSource nesneleri
nesnenin türünü belirtmek için type özelliğini ayarlayın.
ManagedImage için şunu kullanın:
type: 'ManagedImage'
imageId: 'string'
PlatformImage için şunu kullanın:
type: 'PlatformImage'
offer: 'string'
planInfo: {
planName: 'string'
planProduct: 'string'
planPublisher: 'string'
}
publisher: 'string'
sku: 'string'
version: 'string'
SharedImageVersion için şunu kullanın:
type: 'SharedImageVersion'
imageVersionId: 'string'
ImageTemplateInVMValidator nesneleri
nesnenin türünü belirtmek için type özelliğini ayarlayın.
PowerShell için şunu kullanın:
type: 'PowerShell'
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
Shell için şunu kullanın:
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
Özellik değerleri
imageTemplates
Ad | Açıklama | Değer |
---|---|---|
name | Kaynak adı | dize (gerekli) |
location | Kaynağın bulunduğu coğrafi konum | dize (gerekli) |
etiketler | Kaynak etiketleri. | Etiket adlarının ve değerlerinin sözlüğü. Bkz . Şablonlardaki etiketler |
identity | Görüntü şablonunun kimliği (yapılandırıldıysa). | ImageTemplateIdentity (gerekli) |
properties | Görüntü şablonunun özellikleri | ImageTemplateProperties |
ImageTemplateIdentity
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntü şablonu için kullanılan kimlik türü. 'Hiçbiri' türü, görüntü şablonundan tüm kimlikleri kaldırır. | 'Yok' 'UserAssigned' |
userAssignedIdentities | Görüntü şablonuyla ilişkili kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlüğü anahtarı başvuruları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | object |
ImageTemplateProperties
Ad | Açıklama | Değer |
---|---|---|
buildTimeoutInMinutes | Görüntü şablonunu oluştururken beklenme süresi üst sınırı (tüm özelleştirmeleri, doğrulamaları ve dağıtımları içerir). Varsayılan değeri (4 saat) kullanmak için 0 değerini atlar veya belirtin. | int |
Özelleştir | Görüntü kaynağı vb. gibi görüntünün özelleştirme adımlarını açıklamak için kullanılan özellikleri belirtir | ImageTemplateCustomizer[] |
Dağıtmak | Dağıtım, görüntü çıkışının gitmesi gereken yeri hedefler. | ImageTemplateDistributor[] (gerekli) |
kaynak | Kaynak görüntüyü açıklamak için kullanılan özellikleri belirtir. | ImageTemplateSource (gerekli) |
stagingResourceGroup | Görüntüyü oluşturmak için kullanılacak görüntü şablonuyla aynı abonelikteki hazırlama kaynak grubu kimliği. Bu alan boşsa, rastgele ada sahip bir kaynak grubu oluşturulur. Bu alanda belirtilen kaynak grubu yoksa, aynı adla oluşturulur. Belirtilen kaynak grubu varsa, boş ve görüntü şablonuyla aynı bölgede olmalıdır. Bu alan boşsa veya belirtilen kaynak grubu yoksa, şablon silme işlemi sırasında oluşturulan kaynak grubu silinir, ancak belirtilen kaynak grubu varsa, kaynak grubunda oluşturulan kaynaklar şablon silme işlemi sırasında silinir ve kaynak grubunun kendisi kalır. | string |
doğrulama | Sonuçta elde edilen görüntüde gerçekleştirilecek yapılandırma seçenekleri ve doğrulama listesi. | ImageTemplatePropertiesValidate |
vmProfile | Sanal makinenin görüntü oluşturmak için nasıl ayarlandığını açıklar | ImageTemplateVmProfile |
ImageTemplateCustomizer
Ad | Açıklama | Değer |
---|---|---|
name | Bu özelleştirme adımının yaptığı işlemle ilgili bağlam sağlamak için Kolay Ad | string |
tür | Nesne türünü ayarlama | Dosya PowerShell Kabuk WindowsRestart WindowsUpdate (gerekli) |
ImageTemplateFileCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | 'File' (gerekli) |
hedef | Dosyanın (sourceUri'den) VM'ye yüklendiği dosyanın mutlak yolu (iç içe dizin yapıları zaten oluşturulmuştur) | string |
sha256Checksum | Yukarıdaki sourceUri alanında sağlanan dosyanın SHA256 sağlama toplamı | string |
Sourceuri | VM'yi özelleştirmek için karşıya yüklenecek dosyanın URI'si. Github bağlantısı, Azure Depolama için SAS URI'sı vb. olabilir | string |
ImageTemplatePowerShellCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | 'PowerShell' (gerekli) |
inline | Yürütülecek PowerShell komutları dizisi | string[] |
runAsSystem | Belirtilirse, PowerShell betiği Yerel Sistem kullanıcısı kullanılarak yükseltilmiş ayrıcalıklarla çalıştırılır. Yalnızca yukarıdaki runElevated alanı true olarak ayarlandığında true olabilir. | bool |
runElevated | Belirtilirse PowerShell betiği yükseltilmiş ayrıcalıklarla çalıştırılır | bool |
scriptUri | Özelleştirme için çalıştırılacak PowerShell betiğinin URI'sini seçin. Github bağlantısı, Azure Depolama için SAS URI'sı vb. olabilir | string |
sha256Checksum | Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı | string |
validExitCodes | PowerShell betiği için geçerli çıkış kodları. [Varsayılan: 0] | int[] |
ImageTemplateShellCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | 'Shell' (gerekli) |
inline | Yürütülecek kabuk komutları dizisi | string[] |
scriptUri | Özelleştirme için çalıştırılacak kabuk betiğinin URI'si. Github bağlantısı, Azure Depolama için SAS URI'sı vb. olabilir | string |
sha256Checksum | scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı | string |
ImageTemplateRestartCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | 'WindowsRestart' (gerekli) |
restartCheckCommand | Yeniden başlatmanın başarılı olup olmadığını denetleme komutu [Varsayılan: ''] | string |
restartCommand | Yeniden başlatmayı yürütme komutu [Varsayılan: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
restartTimeout | Yeniden başlatma zaman aşımı büyüklük ve birim dizesi olarak belirtilir; örneğin ,'5m' (5 dakika) veya '2h' (2 saat) [Varsayılan: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | 'WindowsUpdate' (gerekli) |
filtreler | Uygulanacak güncelleştirmeleri seçecek filtre dizisi. Varsayılanı kullanmak için boş dizi atla veya belirt (filtre yok). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın. | string[] |
searchCriteria | Güncelleştirmeleri aramak için ölçütler. Varsayılanı kullanmak için boş dizeyi atla veya belirt (tümünü ara). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın. | string |
updateLimit | Bir kerede uygulanacak en fazla güncelleştirme sayısı. Varsayılan değeri kullanmak için 0 atla veya belirt (1000) | int |
ImageTemplateDistributor
Ad | Açıklama | Değer |
---|---|---|
artifactTags | Dağıtımcı tarafından oluşturulduktan/güncelleştirildikten sonra yapıta uygulanacak etiketler. | object |
runOutputName | İlişkili RunOutput için kullanılacak ad. | dize (gerekli) |
tür | Nesne türünü ayarlama | ManagedImage SharedImage VHD (gerekli) |
ImageTemplateManagedImageDistributor
Ad | Açıklama | Değer |
---|---|---|
tür | Dağıtım türü. | 'ManagedImage' (gerekli) |
imageId | Yönetilen Disk Görüntüsünün Kaynak Kimliği | dize (gerekli) |
location | Görüntü için Azure konumu, görüntü zaten varsa eşleşmelidir | dize (gerekli) |
ImageTemplateSharedImageDistributor
Ad | Açıklama | Değer |
---|---|---|
tür | Dağıtım türü. | 'SharedImage' (gerekli) |
excludeFromLatest | Oluşturulan görüntü sürümünün en son sürümden dışlanıp dışlanmayacağını gösteren bayrak. Varsayılan (false) değerini kullanmak için atla. | bool |
galleryImageId | Paylaşılan Görüntü Galerisi görüntüsünün Kaynak Kimliği | dize (gerekli) |
replicationRegions | Görüntünün çoğaltılacağı bölgelerin listesi | string[] (gerekli) |
storageAccountType | Paylaşılan görüntüyü depolamak için kullanılacak depolama hesabı türü. Varsayılan (Standard_LRS) kullanmak için atla. | 'Standard_LRS' 'Standard_ZRS' |
ImageTemplateVhdDistributor
Ad | Açıklama | Değer |
---|---|---|
tür | Dağıtım türü. | 'VHD' (gerekli) |
ImageTemplateSource
Ad | Açıklama | Değer |
---|---|---|
tür | Nesne türünü ayarlama | ManagedImage PlatformImage SharedImageVersion (gerekli) |
ImageTemplateManagedImageSource
Ad | Açıklama | Değer |
---|---|---|
tür | Başlamak istediğiniz kaynak görüntünün türünü belirtir. | 'ManagedImage' (gerekli) |
imageId | Müşteri aboneliğinde yönetilen görüntünün ARM kaynak kimliği | dize (gerekli) |
ImageTemplatePlatformImageSource
Ad | Açıklama | Değer |
---|---|---|
tür | Başlamak istediğiniz kaynak görüntünün türünü belirtir. | 'PlatformImage' (gerekli) |
teklif | Azure Galeri Görüntüleri'nden görüntü teklifi. | string |
planInfo | Platform görüntüsü için satın alma planının isteğe bağlı yapılandırması. | PlatformImagePurchasePlan |
yayımcı | Azure Galeri Görüntüleri'nde Görüntü Yayımcısı. | string |
Sku | Azure Galeri Görüntüleri'nden görüntü sku'su. | string |
sürüm | Azure Galeri Görüntüleri'nden görüntü sürümü. Burada 'en son' belirtilirse, şablon gönderildiğinde değil görüntü derlemesi gerçekleştiğinde sürüm değerlendirilir. | string |
PlatformImagePurchasePlan
Ad | Açıklama | Değer |
---|---|---|
planName | Satın alma planının adı. | dize (gerekli) |
planProduct | Satın alma planının ürünü. | dize (gerekli) |
planPublisher | Satın alma planının yayımcısı. | dize (gerekli) |
ImageTemplateSharedImageVersionSource
Ad | Açıklama | Değer |
---|---|---|
tür | Başlamak istediğiniz kaynak görüntünün türünü belirtir. | 'SharedImageVersion' (gerekli) |
imageVersionId | Paylaşılan görüntü galerisindeki görüntü sürümünün ARM kaynak kimliği | dize (gerekli) |
ImageTemplatePropertiesValidate
Ad | Açıklama | Değer |
---|---|---|
continueDistributeOnFailure | Doğrulama başarısız olursa ve bu alan false olarak ayarlanırsa, çıkış görüntüleri dağıtılmaz. Bu varsayılan davranıştır. Doğrulama başarısız olursa ve bu alan true olarak ayarlanırsa, çıkış görüntüleri yine dağıtılır. Hatalı görüntülerin kullanım için dağıtılmasıyla sonuçlandığı için lütfen bu seçeneği dikkatli kullanın. Her iki durumda da (true veya false) uçtan uca görüntü çalıştırmasının doğrulama hatası durumunda başarısız olduğu bildirilir. [Not: Doğrulama başarılı olursa bu alanın hiçbir etkisi olmaz.] | bool |
inVMValidations | Gerçekleştirilecek doğrulamaların listesi. | ImageTemplateInVMValidator[] |
sourceValidationOnly | Bu alan true olarak ayarlanırsa, 'kaynak' bölümünde belirtilen görüntü doğrudan doğrulanır. Özelleştirilmiş bir görüntü oluşturmak ve doğrulamak için ayrı bir derleme çalıştırılamaz. | bool |
ImageTemplateInVMValidator
Ad | Açıklama | Değer |
---|---|---|
name | Bu doğrulama adımının ne yaptığıyla ilgili bağlam sağlamak için Kolay Ad | string |
tür | Nesne türünü ayarlama | PowerShell Kabuk (gerekli) |
ImageTemplatePowerShellValidator
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir | 'PowerShell' (gerekli) |
inline | Yürütülecek PowerShell komutları dizisi | string[] |
runAsSystem | Belirtilirse, PowerShell betiği Yerel Sistem kullanıcısı kullanılarak yükseltilmiş ayrıcalıklarla çalıştırılır. Yalnızca yukarıdaki runElevated alanı true olarak ayarlandığında true olabilir. | bool |
runElevated | Belirtilirse PowerShell betiği yükseltilmiş ayrıcalıklarla çalıştırılır | bool |
scriptUri | Doğrulama için çalıştırılacak PowerShell betiğinin URI'sini seçin. Bu bir github bağlantısı, Azure Depolama URI'si vb. olabilir | string |
sha256Checksum | Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı | string |
validExitCodes | PowerShell betiği için geçerli çıkış kodları. [Varsayılan: 0] | int[] |
ImageTemplateShellValidator
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir | 'Shell' (gerekli) |
inline | Yürütülecek kabuk komutları dizisi | string[] |
scriptUri | Doğrulama için çalıştırılacak kabuk betiğinin URI'si. Bu bir github bağlantısı, Azure Depolama URI'si vb. olabilir | string |
sha256Checksum | scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı | string |
ImageTemplateVmProfile
Ad | Açıklama | Değer |
---|---|---|
osDiskSizeGB | İşletim sistemi diskinin GB cinsinden boyutu. Azure'ın varsayılan işletim sistemi disk boyutunu kullanmak için 0 değerini atlar veya belirtin. | int |
userAssignedIdentities | Derleme VM'sinde ve doğrulama VM'sinde yapılandırılacak kullanıcı tarafından atanan yönetilen kimliklerin isteğe bağlı kaynak kimlikleri dizisi. Bu, görüntü şablonunun kimliğini içerebilir. | string[] |
vmSize | Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu. Varsayılanı kullanmak için boş dizeyi atla veya belirt (1. Nesil görüntüleri için Standard_D1_v2 ve 2. Nesil görüntüleri için Standard_D2ds_v4). | string |
vnetConfig | derleme VM'sini ve doğrulama VM'sini dağıtmak için kullanılacak sanal ağın isteğe bağlı yapılandırması. Belirli bir sanal ağın kullanılması gerekmiyorsa atla. | VirtualNetworkConfig |
VirtualNetworkConfig
Ad | Açıklama | Değer |
---|---|---|
proxyVmSize | Derleme VM'sine ve doğrulama VM'sine trafik geçirmek için kullanılan ara sunucu sanal makinesinin boyutu. Varsayılan (Standard_A1_v2) kullanmak için boş dizeyi atla veya belirt. | string |
subnetId | Önceden var olan bir alt ağın kaynak kimliği. | string |
Hızlı başlangıç şablonları
Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.
Şablon | Description |
---|---|
Azure Windows Temeli ile Azure Image Builder |
Bir Azure Image Builder ortamı oluşturur ve en son Windows Güncelleştirmeler ve Azure Windows Temeli uygulanmış bir Windows Server görüntüsü oluşturur. |
Dev Box hizmetini yapılandırma |
Bu şablon, Geliştirme Kutusu hızlı başlangıç kılavuzuna göre tüm Dev Box yönetici kaynaklarını oluşturur. Oluşturulan tüm kaynakları görüntüleyebilir veya doğrudan DevPortal.microsoft.com giderek ilk Geliştirme Kutunuzu oluşturabilirsiniz. |
ARM şablonu kaynak tanımı
imageTemplates kaynak türü şu şekilde dağıtılabilir:
- Kaynak grupları - Bkz. kaynak grubu dağıtım komutları
Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.
Kaynak biçimi
Microsoft.VirtualMachineImages/imageTemplates kaynağı oluşturmak için şablonunuza aşağıdaki JSON'u ekleyin.
{
"type": "Microsoft.VirtualMachineImages/imageTemplates",
"apiVersion": "2022-02-14",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"identity": {
"type": "string",
"userAssignedIdentities": {}
},
"properties": {
"buildTimeoutInMinutes": "int",
"customize": [
{
"name": "string",
"type": "string"
// For remaining properties, see ImageTemplateCustomizer objects
}
],
"distribute": [
{
"artifactTags": {},
"runOutputName": "string",
"type": "string"
// For remaining properties, see ImageTemplateDistributor objects
}
],
"source": {
"type": "string"
// For remaining properties, see ImageTemplateSource objects
},
"stagingResourceGroup": "string",
"validate": {
"continueDistributeOnFailure": "bool",
"inVMValidations": [
{
"name": "string",
"type": "string"
// For remaining properties, see ImageTemplateInVMValidator objects
}
],
"sourceValidationOnly": "bool"
},
"vmProfile": {
"osDiskSizeGB": "int",
"userAssignedIdentities": [ "string" ],
"vmSize": "string",
"vnetConfig": {
"proxyVmSize": "string",
"subnetId": "string"
}
}
}
}
ImageTemplateCustomizer nesneleri
nesnenin türünü belirtmek için type özelliğini ayarlayın.
Dosya için şunu kullanın:
"type": "File",
"destination": "string",
"sha256Checksum": "string",
"sourceUri": "string"
PowerShell için şunu kullanın:
"type": "PowerShell",
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
Shell için şunu kullanın:
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
WindowsRestart için şunu kullanın:
"type": "WindowsRestart",
"restartCheckCommand": "string",
"restartCommand": "string",
"restartTimeout": "string"
WindowsUpdate için şunu kullanın:
"type": "WindowsUpdate",
"filters": [ "string" ],
"searchCriteria": "string",
"updateLimit": "int"
ImageTemplateDistributor nesneleri
nesnenin türünü belirtmek için type özelliğini ayarlayın.
ManagedImage için şunu kullanın:
"type": "ManagedImage",
"imageId": "string",
"location": "string"
SharedImage için şunu kullanın:
"type": "SharedImage",
"excludeFromLatest": "bool",
"galleryImageId": "string",
"replicationRegions": [ "string" ],
"storageAccountType": "string"
VHD için şunu kullanın:
"type": "VHD"
ImageTemplateSource nesneleri
nesnenin türünü belirtmek için type özelliğini ayarlayın.
ManagedImage için şunu kullanın:
"type": "ManagedImage",
"imageId": "string"
PlatformImage için şunu kullanın:
"type": "PlatformImage",
"offer": "string",
"planInfo": {
"planName": "string",
"planProduct": "string",
"planPublisher": "string"
},
"publisher": "string",
"sku": "string",
"version": "string"
SharedImageVersion için şunu kullanın:
"type": "SharedImageVersion",
"imageVersionId": "string"
ImageTemplateInVMValidator nesneleri
nesnenin türünü belirtmek için type özelliğini ayarlayın.
PowerShell için şunu kullanın:
"type": "PowerShell",
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
Shell için şunu kullanın:
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
Özellik değerleri
imageTemplates
Ad | Açıklama | Değer |
---|---|---|
tür | Kaynak türü | 'Microsoft.VirtualMachineImages/imageTemplates' |
apiVersion | Kaynak API'sinin sürümü | '2022-02-14' |
name | Kaynak adı | dize (gerekli) |
location | Kaynağın bulunduğu coğrafi konum | dize (gerekli) |
etiketler | Kaynak etiketleri. | Etiket adlarının ve değerlerinin sözlüğü. Bkz. Şablonlardaki etiketler |
identity | Yapılandırıldıysa, görüntü şablonunun kimliği. | ImageTemplateIdentity (gerekli) |
properties | Görüntü şablonunun özellikleri | ImageTemplateProperties |
ImageTemplateIdentity
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntü şablonu için kullanılan kimlik türü. 'Hiçbiri' türü, görüntü şablonundan tüm kimlikleri kaldırır. | 'Yok' 'UserAssigned' |
userAssignedIdentities | Görüntü şablonuyla ilişkilendirilmiş kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlüğü anahtar başvuruları şu biçimde ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | object |
ImageTemplateProperties
Ad | Açıklama | Değer |
---|---|---|
buildTimeoutInMinutes | Görüntü şablonunu oluştururken beklenme süresi üst sınırı (tüm özelleştirmeleri, doğrulamaları ve dağıtımları içerir). Varsayılan değeri (4 saat) kullanmak için 0 değerini atlar veya belirtin. | int |
Özelleştir | Görüntü kaynağı vb. gibi görüntünün özelleştirme adımlarını açıklamak için kullanılan özellikleri belirtir | ImageTemplateCustomizer[] |
Dağıtmak | Dağıtım, görüntü çıkışının gitmesi gereken yeri hedefler. | ImageTemplateDistributor[] (gerekli) |
kaynak | Kaynak görüntüyü açıklamak için kullanılan özellikleri belirtir. | ImageTemplateSource (gerekli) |
stagingResourceGroup | Görüntüyü oluşturmak için kullanılacak görüntü şablonuyla aynı abonelikteki hazırlama kaynak grubu kimliği. Bu alan boşsa, rastgele ada sahip bir kaynak grubu oluşturulur. Bu alanda belirtilen kaynak grubu yoksa, aynı adla oluşturulur. Belirtilen kaynak grubu varsa, boş ve görüntü şablonuyla aynı bölgede olmalıdır. Bu alan boşsa veya belirtilen kaynak grubu yoksa, şablon silme işlemi sırasında oluşturulan kaynak grubu silinir, ancak belirtilen kaynak grubu varsa, kaynak grubunda oluşturulan kaynaklar şablon silme sırasında silinir ve kaynak grubunun kendisi kalır. | string |
doğrulama | Elde edilen görüntüde gerçekleştirilecek yapılandırma seçenekleri ve doğrulama listesi. | ImageTemplatePropertiesValidate |
vmProfile | Sanal makinenin görüntü oluşturmak için nasıl ayarlandığını açıklar | ImageTemplateVmProfile |
ImageTemplateCustomizer
Ad | Açıklama | Değer |
---|---|---|
name | Bu özelleştirme adımının ne yaptığıyla ilgili bağlam sağlamak için Kolay Ad | string |
tür | Nesne türünü ayarlama | Dosya PowerShell Kabuk WindowsRestart WindowsUpdate (gerekli) |
ImageTemplateFileCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştiricisi olabilir | 'Dosya' (gerekli) |
hedef | Dosyanın (sourceUri'den) VM'ye yüklendiği dosyanın mutlak yolu (iç içe dizin yapıları önceden oluşturulmuş) | string |
sha256Checksum | Yukarıdaki sourceUri alanında sağlanan dosyanın SHA256 sağlama toplamı | string |
Sourceuri | VM'yi özelleştirmek için karşıya yüklenecek dosyanın URI'si. Github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir | string |
ImageTemplatePowerShellCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştiricisi olabilir | 'PowerShell' (gerekli) |
inline | Yürütülecek PowerShell komutları dizisi | string[] |
runAsSystem | Belirtilirse, PowerShell betiği Yerel Sistem kullanıcısı kullanılarak yükseltilmiş ayrıcalıklarla çalıştırılır. Yalnızca yukarıdaki runElevated alanı true olarak ayarlandığında true olabilir. | bool |
runElevated | Belirtilirse PowerShell betiği yükseltilmiş ayrıcalıklarla çalıştırılır | bool |
scriptUri | Özelleştirme için çalıştırılacak PowerShell betiğinin URI'sini seçin. Github bağlantısı, Azure Depolama için SAS URI'sı vb. olabilir | string |
sha256Checksum | Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı | string |
validExitCodes | PowerShell betiği için geçerli çıkış kodları. [Varsayılan: 0] | int[] |
ImageTemplateShellCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | 'Shell' (gerekli) |
inline | Yürütülecek kabuk komutları dizisi | string[] |
scriptUri | Özelleştirme için çalıştırılacak kabuk betiğinin URI'si. Github bağlantısı, Azure Depolama için SAS URI'sı vb. olabilir | string |
sha256Checksum | scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı | string |
ImageTemplateRestartCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | 'WindowsRestart' (gerekli) |
restartCheckCommand | Yeniden başlatmanın başarılı olup olmadığını denetleme komutu [Varsayılan: ''] | string |
restartCommand | Yeniden başlatmayı yürütme komutu [Varsayılan: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
restartTimeout | Yeniden başlatma zaman aşımı büyüklük ve birim dizesi olarak belirtilir; örneğin ,'5m' (5 dakika) veya '2h' (2 saat) [Varsayılan: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | 'WindowsUpdate' (gerekli) |
filtreler | Uygulanacak güncelleştirmeleri seçecek filtre dizisi. Varsayılanı kullanmak için boş dizi atla veya belirt (filtre yok). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın. | string[] |
searchCriteria | Güncelleştirmeleri aramak için ölçütler. Varsayılanı kullanmak için boş dizeyi atla veya belirt (tümünü ara). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın. | string |
updateLimit | Bir kerede uygulanacak en fazla güncelleştirme sayısı. Varsayılan değeri kullanmak için 0 atla veya belirt (1000) | int |
ImageTemplateDistributor
Ad | Açıklama | Değer |
---|---|---|
artifactTags | Dağıtımcı tarafından oluşturulduktan/güncelleştirildikten sonra yapıta uygulanacak etiketler. | object |
runOutputName | İlişkili RunOutput için kullanılacak ad. | dize (gerekli) |
tür | Nesne türünü ayarlama | ManagedImage SharedImage VHD (gerekli) |
ImageTemplateManagedImageDistributor
Ad | Açıklama | Değer |
---|---|---|
tür | Dağıtım türü. | 'ManagedImage' (gerekli) |
imageId | Yönetilen Disk Görüntüsünün Kaynak Kimliği | dize (gerekli) |
location | Görüntü için Azure konumu, görüntü zaten varsa eşleşmelidir | dize (gerekli) |
ImageTemplateSharedImageDistributor
Ad | Açıklama | Değer |
---|---|---|
tür | Dağıtım türü. | 'SharedImage' (gerekli) |
excludeFromLatest | Oluşturulan görüntü sürümünün en son sürümden dışlanıp dışlanmayacağını gösteren bayrak. Varsayılanı (false) kullanmak için atla. | bool |
galleryImageId | Paylaşılan Görüntü Galerisi görüntüsünün Kaynak Kimliği | dize (gerekli) |
replicationRegions | Görüntünün çoğaltılacağı bölgelerin listesi | string[] (gerekli) |
storageAccountType | Paylaşılan görüntüyü depolamak için kullanılacak depolama hesabı türü. Varsayılan (Standard_LRS) kullanmak için atla. | 'Standard_LRS' 'Standard_ZRS' |
ImageTemplateVhdDistributor
Ad | Açıklama | Değer |
---|---|---|
tür | Dağıtım türü. | 'VHD' (gerekli) |
ImageTemplateSource
Ad | Açıklama | Değer |
---|---|---|
tür | Nesne türünü ayarlama | ManagedImage PlatformImage SharedImageVersion (gerekli) |
ImageTemplateManagedImageSource
Ad | Açıklama | Değer |
---|---|---|
tür | Başlamak istediğiniz kaynak görüntünün türünü belirtir. | 'ManagedImage' (gerekli) |
imageId | Müşteri aboneliğindeki yönetilen görüntünün ARM kaynak kimliği | dize (gerekli) |
ImageTemplatePlatformImageSource
Ad | Açıklama | Değer |
---|---|---|
tür | Başlamak istediğiniz kaynak görüntünün türünü belirtir. | 'PlatformImage' (gerekli) |
teklif | Azure Galeri Görüntüleri'nden görüntü teklifi. | string |
planInfo | Platform görüntüsü için satın alma planının isteğe bağlı yapılandırması. | PlatformImagePurchasePlan |
yayımcı | Azure Galeri Görüntüleri'nde Image Publisher. | string |
Sku | Azure Galeri Görüntüleri'nden görüntü sku'su. | string |
sürüm | Azure Galeri Görüntüleri'nden görüntü sürümü. Burada 'en son' belirtilirse, şablon gönderildiğinde değil görüntü derlemesi gerçekleştiğinde sürüm değerlendirilir. | string |
PlatformImagePurchasePlan
Ad | Açıklama | Değer |
---|---|---|
planName | Satın alma planının adı. | dize (gerekli) |
planProduct | Satın alma planının ürünü. | dize (gerekli) |
planPublisher | Satın alma planının yayımcısı. | dize (gerekli) |
ImageTemplateSharedImageVersionSource
Ad | Açıklama | Değer |
---|---|---|
tür | Başlamak istediğiniz kaynak görüntünün türünü belirtir. | 'SharedImageVersion' (gerekli) |
imageVersionId | Paylaşılan görüntü galerisindeki görüntü sürümünün ARM kaynak kimliği | dize (gerekli) |
ImageTemplatePropertiesValidate
Ad | Açıklama | Değer |
---|---|---|
continueDistributeOnFailure | Doğrulama başarısız olursa ve bu alan false olarak ayarlanırsa, çıkış görüntüleri dağıtılmaz. Bu varsayılan davranıştır. Doğrulama başarısız olursa ve bu alan true olarak ayarlanırsa, çıkış görüntüleri yine dağıtılır. Hatalı görüntülerin kullanım için dağıtılmasıyla sonuçlandığı için lütfen bu seçeneği dikkatli kullanın. Her iki durumda da (true veya false) uçtan uca görüntü çalıştırmasının doğrulama hatası durumunda başarısız olduğu bildirilir. [Not: Doğrulama başarılı olursa bu alanın hiçbir etkisi olmaz.] | bool |
inVMValidations | Gerçekleştirilecek doğrulamaların listesi. | ImageTemplateInVMValidator[] |
sourceValidationOnly | Bu alan true olarak ayarlanırsa, 'kaynak' bölümünde belirtilen görüntü doğrudan doğrulanır. Özelleştirilmiş bir görüntü oluşturmak ve doğrulamak için ayrı bir derleme çalıştırılamaz. | bool |
ImageTemplateInVMValidator
Ad | Açıklama | Değer |
---|---|---|
name | Bu doğrulama adımının ne yaptığıyla ilgili bağlam sağlamak için Kolay Ad | string |
tür | Nesne türünü ayarlama | PowerShell Kabuk (gerekli) |
ImageTemplatePowerShellValidator
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir | 'PowerShell' (gerekli) |
inline | Yürütülecek PowerShell komutları dizisi | string[] |
runAsSystem | Belirtilirse, PowerShell betiği Yerel Sistem kullanıcısı kullanılarak yükseltilmiş ayrıcalıklarla çalıştırılır. Yalnızca yukarıdaki runElevated alanı true olarak ayarlandığında true olabilir. | bool |
runElevated | Belirtilirse PowerShell betiği yükseltilmiş ayrıcalıklarla çalıştırılır | bool |
scriptUri | Doğrulama için çalıştırılacak PowerShell betiğinin URI'sini seçin. Bu bir github bağlantısı, Azure Depolama URI'si vb. olabilir | string |
sha256Checksum | Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı | string |
validExitCodes | PowerShell betiği için geçerli çıkış kodları. [Varsayılan: 0] | int[] |
ImageTemplateShellValidator
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir | 'Shell' (gerekli) |
inline | Yürütülecek kabuk komutları dizisi | string[] |
scriptUri | Doğrulama için çalıştırılacak kabuk betiğinin URI'si. Bu bir github bağlantısı, Azure Depolama URI'si vb. olabilir | string |
sha256Checksum | scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı | string |
ImageTemplateVmProfile
Ad | Açıklama | Değer |
---|---|---|
osDiskSizeGB | İşletim sistemi diskinin GB cinsinden boyutu. Azure'ın varsayılan işletim sistemi disk boyutunu kullanmak için 0 değerini atlar veya belirtin. | int |
userAssignedIdentities | Derleme VM'sinde ve doğrulama VM'sinde yapılandırılacak kullanıcı tarafından atanan yönetilen kimliklerin isteğe bağlı kaynak kimlikleri dizisi. Bu, görüntü şablonunun kimliğini içerebilir. | string[] |
vmSize | Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu. Varsayılanı kullanmak için boş dizeyi atla veya belirt (1. Nesil görüntüleri için Standard_D1_v2 ve 2. Nesil görüntüleri için Standard_D2ds_v4). | string |
vnetConfig | derleme VM'sini ve doğrulama VM'sini dağıtmak için kullanılacak sanal ağın isteğe bağlı yapılandırması. Belirli bir sanal ağın kullanılması gerekmiyorsa atla. | VirtualNetworkConfig |
VirtualNetworkConfig
Ad | Açıklama | Değer |
---|---|---|
proxyVmSize | Derleme VM'sine ve doğrulama VM'sine trafik geçirmek için kullanılan ara sunucu sanal makinesinin boyutu. Varsayılan (Standard_A1_v2) kullanmak için boş dizeyi atla veya belirt. | string |
subnetId | Önceden var olan bir alt ağın kaynak kimliği. | string |
Hızlı başlangıç şablonları
Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.
Şablon | Description |
---|---|
Azure Windows Temeli ile Azure Image Builder |
Bir Azure Image Builder ortamı oluşturur ve en son Windows Güncelleştirmeler ve Azure Windows Temeli uygulanmış bir Windows Server görüntüsü oluşturur. |
Dev Box hizmetini yapılandırma |
Bu şablon, Geliştirme Kutusu hızlı başlangıç kılavuzuna göre tüm Dev Box yönetici kaynaklarını oluşturur. Oluşturulan tüm kaynakları görüntüleyebilir veya doğrudan DevPortal.microsoft.com giderek ilk Geliştirme Kutunuzu oluşturabilirsiniz. |
Terraform (AzAPI sağlayıcısı) kaynak tanımı
imageTemplates kaynak türü şu şekilde dağıtılabilir:
- Kaynak grupları
Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.
Kaynak biçimi
Microsoft.VirtualMachineImages/imageTemplates kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "UserAssigned"
identity_ids = []
}
body = jsonencode({
properties = {
buildTimeoutInMinutes = int
customize = [
{
name = "string"
type = "string"
// For remaining properties, see ImageTemplateCustomizer objects
}
]
distribute = [
{
artifactTags = {}
runOutputName = "string"
type = "string"
// For remaining properties, see ImageTemplateDistributor objects
}
]
source = {
type = "string"
// For remaining properties, see ImageTemplateSource objects
}
stagingResourceGroup = "string"
validate = {
continueDistributeOnFailure = bool
inVMValidations = [
{
name = "string"
type = "string"
// For remaining properties, see ImageTemplateInVMValidator objects
}
]
sourceValidationOnly = bool
}
vmProfile = {
osDiskSizeGB = int
userAssignedIdentities = [
"string"
]
vmSize = "string"
vnetConfig = {
proxyVmSize = "string"
subnetId = "string"
}
}
}
})
}
ImageTemplateCustomizer nesneleri
nesnenin türünü belirtmek için type özelliğini ayarlayın.
Dosya için şunu kullanın:
type = "File"
destination = "string"
sha256Checksum = "string"
sourceUri = "string"
PowerShell için şunu kullanın:
type = "PowerShell"
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
Shell için şunu kullanın:
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
WindowsRestart için şunu kullanın:
type = "WindowsRestart"
restartCheckCommand = "string"
restartCommand = "string"
restartTimeout = "string"
WindowsUpdate için şunu kullanın:
type = "WindowsUpdate"
filters = [
"string"
]
searchCriteria = "string"
updateLimit = int
ImageTemplateDistributor nesneleri
nesnenin türünü belirtmek için type özelliğini ayarlayın.
ManagedImage için şunu kullanın:
type = "ManagedImage"
imageId = "string"
location = "string"
SharedImage için şunu kullanın:
type = "SharedImage"
excludeFromLatest = bool
galleryImageId = "string"
replicationRegions = [
"string"
]
storageAccountType = "string"
VHD için şunu kullanın:
type = "VHD"
ImageTemplateSource nesneleri
nesnenin türünü belirtmek için type özelliğini ayarlayın.
ManagedImage için şunu kullanın:
type = "ManagedImage"
imageId = "string"
PlatformImage için şunu kullanın:
type = "PlatformImage"
offer = "string"
planInfo = {
planName = "string"
planProduct = "string"
planPublisher = "string"
}
publisher = "string"
sku = "string"
version = "string"
SharedImageVersion için şunu kullanın:
type = "SharedImageVersion"
imageVersionId = "string"
ImageTemplateInVMValidator nesneleri
nesnenin türünü belirtmek için type özelliğini ayarlayın.
PowerShell için şunu kullanın:
type = "PowerShell"
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
Shell için şunu kullanın:
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
Özellik değerleri
imageTemplates
Ad | Açıklama | Değer |
---|---|---|
tür | Kaynak türü | "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14" |
name | Kaynak adı | dize (gerekli) |
location | Kaynağın bulunduğu coğrafi konum | dize (gerekli) |
parent_id | Bir kaynak grubuna dağıtmak için bu kaynak grubunun kimliğini kullanın. | dize (gerekli) |
etiketler | Kaynak etiketleri. | Etiket adlarının ve değerlerinin sözlüğü. |
identity | Görüntü şablonunun kimliği (yapılandırıldıysa). | ImageTemplateIdentity (gerekli) |
properties | Görüntü şablonunun özellikleri | ImageTemplateProperties |
ImageTemplateIdentity
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntü şablonu için kullanılan kimlik türü. 'Hiçbiri' türü, görüntü şablonundan tüm kimlikleri kaldırır. | "UserAssigned" |
identity_ids | Görüntü şablonuyla ilişkili kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlüğü anahtarı başvuruları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | Kullanıcı kimliği kimlikleri dizisi. |
ImageTemplateProperties
Ad | Açıklama | Değer |
---|---|---|
buildTimeoutInMinutes | Görüntü şablonunu oluştururken beklenme süresi üst sınırı (tüm özelleştirmeleri, doğrulamaları ve dağıtımları içerir). Varsayılan değeri (4 saat) kullanmak için 0 değerini atlar veya belirtin. | int |
Özelleştir | Görüntü kaynağı vb. gibi görüntünün özelleştirme adımlarını açıklamak için kullanılan özellikleri belirtir | ImageTemplateCustomizer[] |
Dağıtmak | Dağıtım, görüntü çıkışının gitmesi gereken yeri hedefler. | ImageTemplateDistributor[] (gerekli) |
kaynak | Kaynak görüntüyü açıklamak için kullanılan özellikleri belirtir. | ImageTemplateSource (gerekli) |
stagingResourceGroup | Görüntüyü oluşturmak için kullanılacak görüntü şablonuyla aynı abonelikteki hazırlama kaynak grubu kimliği. Bu alan boşsa, rastgele ada sahip bir kaynak grubu oluşturulur. Bu alanda belirtilen kaynak grubu yoksa, aynı adla oluşturulur. Belirtilen kaynak grubu varsa, boş ve görüntü şablonuyla aynı bölgede olmalıdır. Bu alan boşsa veya belirtilen kaynak grubu yoksa, şablon silme işlemi sırasında oluşturulan kaynak grubu silinir, ancak belirtilen kaynak grubu varsa, kaynak grubunda oluşturulan kaynaklar şablon silme işlemi sırasında silinir ve kaynak grubunun kendisi kalır. | string |
doğrulama | Sonuçta elde edilen görüntüde gerçekleştirilecek yapılandırma seçenekleri ve doğrulama listesi. | ImageTemplatePropertiesValidate |
vmProfile | Sanal makinenin görüntü oluşturmak için nasıl ayarlandığını açıklar | ImageTemplateVmProfile |
ImageTemplateCustomizer
Ad | Açıklama | Değer |
---|---|---|
name | Bu özelleştirme adımının yaptığı işlemle ilgili bağlam sağlamak için Kolay Ad | string |
tür | Nesne türünü ayarlama | Dosya PowerShell Kabuk WindowsRestart WindowsUpdate (gerekli) |
ImageTemplateFileCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | "Dosya" (gerekli) |
hedef | Dosyanın (sourceUri'den) VM'ye yüklendiği dosyanın mutlak yolu (iç içe dizin yapıları zaten oluşturulmuştur) | string |
sha256Checksum | Yukarıdaki sourceUri alanında sağlanan dosyanın SHA256 sağlama toplamı | string |
Sourceuri | VM'yi özelleştirmek için karşıya yüklenecek dosyanın URI'si. Github bağlantısı, Azure Depolama için SAS URI'sı vb. olabilir | string |
ImageTemplatePowerShellCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | "PowerShell" (gerekli) |
inline | Yürütülecek PowerShell komutları dizisi | string[] |
runAsSystem | Belirtilirse, PowerShell betiği Yerel Sistem kullanıcısı kullanılarak yükseltilmiş ayrıcalıklarla çalıştırılır. Yalnızca yukarıdaki runElevated alanı true olarak ayarlandığında true olabilir. | bool |
runElevated | Belirtilirse PowerShell betiği yükseltilmiş ayrıcalıklarla çalıştırılır | bool |
scriptUri | Özelleştirme için çalıştırılacak PowerShell betiğinin URI'sini seçin. Github bağlantısı, Azure Depolama için SAS URI'sı vb. olabilir | string |
sha256Checksum | Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı | string |
validExitCodes | PowerShell betiği için geçerli çıkış kodları. [Varsayılan: 0] | int[] |
ImageTemplateShellCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | "Kabuk" (gerekli) |
inline | Yürütülecek kabuk komutları dizisi | string[] |
scriptUri | Özelleştirme için çalıştırılacak kabuk betiğinin URI'si. Github bağlantısı, Azure Depolama için SAS URI'sı vb. olabilir | string |
sha256Checksum | scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı | string |
ImageTemplateRestartCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | "WindowsRestart" (gerekli) |
restartCheckCommand | Yeniden başlatmanın başarılı olup olmadığını denetleme komutu [Varsayılan: ''] | string |
restartCommand | Yeniden başlatmayı yürütme komutu [Varsayılan: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
restartTimeout | Yeniden başlatma zaman aşımı büyüklük ve birim dizesi olarak belirtilir; örneğin ,'5m' (5 dakika) veya '2h' (2 saat) [Varsayılan: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir | "WindowsUpdate" (gerekli) |
filtreler | Uygulanacak güncelleştirmeleri seçecek filtre dizisi. Varsayılanı kullanmak için boş dizi atla veya belirt (filtre yok). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın. | string[] |
searchCriteria | Güncelleştirmeleri aramak için ölçütler. Varsayılanı kullanmak için boş dizeyi atla veya belirt (tümünü ara). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın. | string |
updateLimit | Bir kerede uygulanacak en fazla güncelleştirme sayısı. Varsayılan değeri kullanmak için 0 atla veya belirt (1000) | int |
ImageTemplateDistributor
Ad | Açıklama | Değer |
---|---|---|
artifactTags | Dağıtımcı tarafından oluşturulduktan/güncelleştirildikten sonra yapıta uygulanacak etiketler. | object |
runOutputName | İlişkili RunOutput için kullanılacak ad. | dize (gerekli) |
tür | Nesne türünü ayarlama | ManagedImage SharedImage VHD (gerekli) |
ImageTemplateManagedImageDistributor
Ad | Açıklama | Değer |
---|---|---|
tür | Dağıtım türü. | "ManagedImage" (gerekli) |
imageId | Yönetilen Disk Görüntüsünün Kaynak Kimliği | dize (gerekli) |
location | Görüntü için Azure konumu, görüntü zaten varsa eşleşmelidir | dize (gerekli) |
ImageTemplateSharedImageDistributor
Ad | Açıklama | Değer |
---|---|---|
tür | Dağıtım türü. | "SharedImage" (gerekli) |
excludeFromLatest | Oluşturulan görüntü sürümünün en son sürümden dışlanıp dışlanmayacağını gösteren bayrak. Varsayılan (false) değerini kullanmak için atla. | bool |
galleryImageId | Paylaşılan Görüntü Galerisi görüntüsünün Kaynak Kimliği | dize (gerekli) |
replicationRegions | Görüntünün çoğaltılacağı bölgelerin listesi | string[] (gerekli) |
storageAccountType | Paylaşılan görüntüyü depolamak için kullanılacak depolama hesabı türü. Varsayılan (Standard_LRS) kullanmak için atla. | "Standard_LRS" "Standard_ZRS" |
ImageTemplateVhdDistributor
Ad | Açıklama | Değer |
---|---|---|
tür | Dağıtım türü. | "VHD" (gerekli) |
ImageTemplateSource
Ad | Açıklama | Değer |
---|---|---|
tür | Nesne türünü ayarlama | ManagedImage PlatformImage SharedImageVersion (gerekli) |
ImageTemplateManagedImageSource
Ad | Açıklama | Değer |
---|---|---|
tür | Başlamak istediğiniz kaynak görüntünün türünü belirtir. | "ManagedImage" (gerekli) |
imageId | Müşteri aboneliğinde yönetilen görüntünün ARM kaynak kimliği | dize (gerekli) |
ImageTemplatePlatformImageSource
Ad | Açıklama | Değer |
---|---|---|
tür | Başlamak istediğiniz kaynak görüntünün türünü belirtir. | "PlatformImage" (gerekli) |
teklif | Azure Galeri Görüntüleri'nden görüntü teklifi. | string |
planInfo | Platform görüntüsü için satın alma planının isteğe bağlı yapılandırması. | PlatformImagePurchasePlan |
yayımcı | Azure Galeri Görüntüleri'nde Görüntü Yayımcısı. | string |
Sku | Azure Galeri Görüntüleri'nden görüntü sku'su. | string |
sürüm | Azure Galeri Görüntüleri'nden görüntü sürümü. Burada 'en son' belirtilirse, şablon gönderildiğinde değil görüntü derlemesi gerçekleştiğinde sürüm değerlendirilir. | string |
PlatformImagePurchasePlan
Ad | Açıklama | Değer |
---|---|---|
planName | Satın alma planının adı. | dize (gerekli) |
planProduct | Satın alma planının ürünü. | dize (gerekli) |
planPublisher | Satın alma planının yayımcısı. | dize (gerekli) |
ImageTemplateSharedImageVersionSource
Ad | Açıklama | Değer |
---|---|---|
tür | Başlamak istediğiniz kaynak görüntünün türünü belirtir. | "SharedImageVersion" (gerekli) |
imageVersionId | Paylaşılan görüntü galerisindeki görüntü sürümünün ARM kaynak kimliği | dize (gerekli) |
ImageTemplatePropertiesValidate
Ad | Açıklama | Değer |
---|---|---|
continueDistributeOnFailure | Doğrulama başarısız olursa ve bu alan false olarak ayarlanırsa, çıkış görüntüleri dağıtılmaz. Bu varsayılan davranıştır. Doğrulama başarısız olursa ve bu alan true olarak ayarlanırsa, çıkış görüntüleri yine dağıtılır. Hatalı görüntülerin kullanım için dağıtılmasıyla sonuçlandığı için lütfen bu seçeneği dikkatli kullanın. Her iki durumda da (true veya false) uçtan uca görüntü çalıştırmasının doğrulama hatası durumunda başarısız olduğu bildirilir. [Not: Doğrulama başarılı olursa bu alanın hiçbir etkisi olmaz.] | bool |
inVMValidations | Gerçekleştirilecek doğrulamaların listesi. | ImageTemplateInVMValidator[] |
sourceValidationOnly | Bu alan true olarak ayarlanırsa, 'kaynak' bölümünde belirtilen görüntü doğrudan doğrulanır. Özelleştirilmiş bir görüntü oluşturmak ve doğrulamak için ayrı bir derleme çalıştırılamaz. | bool |
ImageTemplateInVMValidator
Ad | Açıklama | Değer |
---|---|---|
name | Bu doğrulama adımının ne yaptığıyla ilgili bağlam sağlamak için Kolay Ad | string |
tür | Nesne türünü ayarlama | PowerShell Kabuk (gerekli) |
ImageTemplatePowerShellValidator
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir | "PowerShell" (gerekli) |
inline | Yürütülecek PowerShell komutları dizisi | string[] |
runAsSystem | Belirtilirse, PowerShell betiği Yerel Sistem kullanıcısı kullanılarak yükseltilmiş ayrıcalıklarla çalıştırılır. Yalnızca yukarıdaki runElevated alanı true olarak ayarlandığında true olabilir. | bool |
runElevated | Belirtilirse PowerShell betiği yükseltilmiş ayrıcalıklarla çalıştırılır | bool |
scriptUri | Doğrulama için çalıştırılacak PowerShell betiğinin URI'sini seçin. Bu bir github bağlantısı, Azure Depolama URI'si vb. olabilir | string |
sha256Checksum | Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı | string |
validExitCodes | PowerShell betiği için geçerli çıkış kodları. [Varsayılan: 0] | int[] |
ImageTemplateShellValidator
Ad | Açıklama | Değer |
---|---|---|
tür | Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir | "Kabuk" (gerekli) |
inline | Yürütülecek kabuk komutları dizisi | string[] |
scriptUri | Doğrulama için çalıştırılacak kabuk betiğinin URI'si. Bu bir github bağlantısı, Azure Depolama URI'si vb. olabilir | string |
sha256Checksum | scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı | string |
ImageTemplateVmProfile
Ad | Açıklama | Değer |
---|---|---|
osDiskSizeGB | İşletim sistemi diskinin GB cinsinden boyutu. Azure'ın varsayılan işletim sistemi disk boyutunu kullanmak için 0 değerini atlar veya belirtin. | int |
userAssignedIdentities | Derleme VM'sinde ve doğrulama VM'sinde yapılandırılacak kullanıcı tarafından atanan yönetilen kimliklerin isteğe bağlı kaynak kimlikleri dizisi. Bu, görüntü şablonunun kimliğini içerebilir. | string[] |
vmSize | Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu. Varsayılanı kullanmak için boş dizeyi atla veya belirt (1. Nesil görüntüleri için Standard_D1_v2 ve 2. Nesil görüntüleri için Standard_D2ds_v4). | string |
vnetConfig | derleme VM'sini ve doğrulama VM'sini dağıtmak için kullanılacak sanal ağın isteğe bağlı yapılandırması. Belirli bir sanal ağın kullanılması gerekmiyorsa atla. | VirtualNetworkConfig |
VirtualNetworkConfig
Ad | Açıklama | Değer |
---|---|---|
proxyVmSize | Derleme VM'sine ve doğrulama VM'sine trafik geçirmek için kullanılan ara sunucu sanal makinesinin boyutu. Varsayılan (Standard_A1_v2) kullanmak için boş dizeyi atla veya belirt. | string |
subnetId | Önceden var olan bir alt ağın kaynak kimliği. | string |