Microsoft.VirtualMachineImages imageTemplates 2020-02-14
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@2020-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
}
vmProfile: {
osDiskSizeGB: int
vmSize: 'string'
vnetConfig: {
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'
Özellik değerleri
imageTemplates
Ad | Açıklama | Değer |
---|---|---|
name | Kaynak adı | dize (gerekli) |
location | Kaynak konumu | 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ı. 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) |
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ş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 | dize[] |
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 doğru 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'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[] |
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ştiricisi olabilir | 'Shell' (gerekli) |
inline | Yürütülecek kabuk komutları dizisi | dize[] |
scriptUri | Özelleştirme için çalıştırılacak kabuk betiğinin URI'sini seçin. Github bağlantısı, Azure Depolama için SAS URI'si 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ştiricisi 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ı bir büyüklük ve birim dizesi olarak belirtildi, ö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ştiricisi olabilir | 'WindowsUpdate' (gerekli) |
filtreler | Uygulanacak güncelleştirmeleri seçecek filtre dizisi. Varsayılanı kullanmak için boş diziyi atla veya belirt (filtre yok). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın. | dize[] |
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. 'En son' değerinin belirtilmesi, düzeltilecek ROUNDTRIP_INCONSISTENT_PROPERTY soruna neden olabilir. | 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) |
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 |
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 sanal makinesini 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 |
---|---|---|
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": "2020-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
},
"vmProfile": {
"osDiskSizeGB": "int",
"vmSize": "string",
"vnetConfig": {
"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"
Özellik değerleri
imageTemplates
Ad | Açıklama | Değer |
---|---|---|
tür | Kaynak türü | 'Microsoft.VirtualMachineImages/imageTemplates' |
apiVersion | Kaynak API'sinin sürümü | '2020-02-14' |
name | Kaynak adı | dize (gerekli) |
location | Kaynak konumu | 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ı. 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) |
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. 'En son' değerinin belirtilmesi, düzeltilecek ROUNDTRIP_INCONSISTENT_PROPERTY soruna neden olabilir. | 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) |
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 |
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 sanal makinesini 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 |
---|---|---|
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 Görüntü Oluşturucusu |
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, Dev Box 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 kaynaklara 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@2020-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
}
vmProfile = {
osDiskSizeGB = int
vmSize = "string"
vnetConfig = {
subnetId = "string"
}
}
}
})
}
ImageTemplateCustomizer nesneleri
nesne 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
]
Kabuk 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
nesne 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
nesne 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"
Özellik değerleri
imageTemplates
Ad | Açıklama | Değer |
---|---|---|
tür | Kaynak türü | "Microsoft.VirtualMachineImages/imageTemplates@2020-02-14" |
name | Kaynak adı | dize (gerekli) |
location | Kaynak konumu | 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 | 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. | "UserAssigned" |
identity_ids | 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}'. | 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ı. 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) |
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 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. 'En son' belirtilmesi, düzeltilecek ROUNDTRIP_INCONSISTENT_PROPERTY soruna neden olabilir. | 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) |
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 |
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 sanal makinesini 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 |
---|---|---|
subnetId | Önceden var olan bir alt ağın kaynak kimliği. | string |