Microsoft.VirtualMachineImages imageTemplates
Definição de recurso do Bicep
O tipo de recurso imageTemplates pode ser implantado em:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o Bicep a seguir ao modelo.
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'
}
}
}
}
Objetos ImageTemplateCustomizer
Defina a propriedade type para especificar o tipo de objeto.
Para Arquivo, use:
type: 'File'
destination: 'string'
sha256Checksum: 'string'
sourceUri: 'string'
Para o PowerShell, use:
type: 'PowerShell'
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
Para Shell, use:
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
Para WindowsRestart, use:
type: 'WindowsRestart'
restartCheckCommand: 'string'
restartCommand: 'string'
restartTimeout: 'string'
Para WindowsUpdate, use:
type: 'WindowsUpdate'
filters: [
'string'
]
searchCriteria: 'string'
updateLimit: int
Objetos ImageTemplateDistributor
Defina a propriedade type para especificar o tipo de objeto.
Para ManagedImage, use:
type: 'ManagedImage'
imageId: 'string'
location: 'string'
Para SharedImage, use:
type: 'SharedImage'
excludeFromLatest: bool
galleryImageId: 'string'
replicationRegions: [
'string'
]
storageAccountType: 'string'
Para VHD, use:
type: 'VHD'
Objetos ImageTemplateSource
Defina a propriedade type para especificar o tipo de objeto.
Para ManagedImage, use:
type: 'ManagedImage'
imageId: 'string'
Para PlatformImage, use:
type: 'PlatformImage'
offer: 'string'
planInfo: {
planName: 'string'
planProduct: 'string'
planPublisher: 'string'
}
publisher: 'string'
sku: 'string'
version: 'string'
Para SharedImageVersion, use:
type: 'SharedImageVersion'
imageVersionId: 'string'
Objetos ImageTemplateInVMValidator
Defina a propriedade type para especificar o tipo de objeto.
Para o PowerShell, use:
type: 'PowerShell'
inline: [
'string'
]
runAsSystem: bool
runElevated: bool
scriptUri: 'string'
sha256Checksum: 'string'
validExitCodes: [
int
]
Para Shell, use:
type: 'Shell'
inline: [
'string'
]
scriptUri: 'string'
sha256Checksum: 'string'
Valores de propriedade
imageTemplates
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso | cadeia de caracteres (obrigatório) |
| local | A localização geográfica em que o recurso reside | cadeia de caracteres (obrigatório) |
| marcas | Marcas de recurso. | Dicionário de nomes e valores de marcas. Confira Marcas em modelos |
| identidade | A identidade do modelo de imagem, se configurada. | ImageTemplateIdentity (obrigatório) |
| properties | As propriedades do modelo de imagem | ImageTemplateProperties |
ImageTemplateIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade usado para o modelo de imagem. O tipo 'None' removerá todas as identidades do modelo de imagem. | 'None' 'UserAssigned' |
| userAssignedIdentities | A lista de identidades de usuário associadas ao modelo de imagem. As referências de chave de dicionário de identidade do usuário serão IDs de recurso do ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | objeto |
ImageTemplateProperties
| Nome | Descrição | Valor |
|---|---|---|
| buildTimeoutInMinutes | Duração máxima a aguardar durante a compilação do modelo de imagem (inclui todas as personalizações, validações e distribuições). Omita ou especifique 0 para usar o padrão (4 horas). | INT |
| Personalizar | Especifica as propriedades usadas para descrever as etapas de personalização da imagem, como Fonte de imagem etc. | ImageTemplateCustomizer[] |
| distribuir | A distribuição é direcionada para onde a saída da imagem precisa ir. | ImageTemplateDistributor[] (obrigatório) |
| source | Especifica as propriedades usadas para descrever a imagem de origem. | ImageTemplateSource (obrigatório) |
| stagingResourceGroup | A ID do grupo de recursos de preparo na mesma assinatura que o modelo de imagem que será usado para compilar a imagem. Se esse campo estiver vazio, um grupo de recursos com um nome aleatório será criado. Se o grupo de recursos especificado neste campo não existir, ele será criado com o mesmo nome. Se o grupo de recursos especificado existir, ele deverá estar vazio e na mesma região que o modelo de imagem. O grupo de recursos criado será excluído durante a exclusão do modelo se esse campo estiver vazio ou o grupo de recursos especificado não existir, mas se o grupo de recursos especificado existir, os recursos criados no grupo de recursos serão excluídos durante a exclusão do modelo e o próprio grupo de recursos permanecerá. | string |
| validade | Opções de configuração e lista de validações a serem executadas na imagem resultante. | ImageTemplatePropertiesValidate |
| vmProfile | Descreve como a máquina virtual é configurada para criar imagens | ImageTemplateVmProfile |
ImageTemplateCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome amigável para fornecer contexto sobre o que essa etapa de personalização faz | string |
| type | Definir o tipo de objeto | Arquivo PowerShell Shell WindowsRestart WindowsUpdate (obrigatório) |
ImageTemplateFileCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | 'File' (obrigatório) |
| destino | O caminho absoluto para um arquivo (com estruturas de diretório aninhadas já criadas) em que o arquivo (de sourceUri) será carregado na VM | string |
| sha256Checksum | Soma de verificação SHA256 do arquivo fornecido no campo sourceUri acima | string |
| sourceUri | O URI do arquivo a ser carregado para personalizar a VM. Pode ser um link do github, URI de SAS para o Armazenamento do Azure etc. | string |
ImageTemplatePowerShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | 'PowerShell' (obrigatório) |
| inline | Matriz de comandos do PowerShell a serem executados | string[] |
| runAsSystem | Se especificado, o script do PowerShell será executado com privilégios elevados usando o usuário do Sistema Local. Só pode ser true quando o campo runElevated acima é definido como true. | bool |
| runElevated | Se especificado, o script do PowerShell será executado com privilégios elevados | bool |
| scriptUri | URI do script do PowerShell a ser executado para personalização. Pode ser um link do github, URI de SAS para o Armazenamento do Azure etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script do Power Shell fornecido no campo scriptUri acima | string |
| validExitCodes | Códigos de saída válidos para o script do PowerShell. [Padrão: 0] | int[] |
ImageTemplateShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | 'Shell' (obrigatório) |
| inline | Matriz de comandos de shell a serem executados | string[] |
| scriptUri | URI do script de shell a ser executado para personalização. Pode ser um link do github, URI de SAS para o Armazenamento do Azure etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script de shell fornecido no campo scriptUri | string |
ImageTemplateRestartCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | 'WindowsRestart' (obrigatório) |
| restartCheckCommand | Comando para marcar se a reinicialização foi bem-sucedida [Padrão: ''] | string |
| restartCommand | Comando para executar a reinicialização [Padrão: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
| restartTimeout | Tempo limite de reinicialização especificado como uma cadeia de caracteres de magnitude e unidade, por exemplo, '5m' (5 minutos) ou '2h' (2 horas) [Padrão: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser um personalizador de shell | 'WindowsUpdate' (obrigatório) |
| filtros | Matriz de filtros para selecionar atualizações a serem aplicadas. Omita ou especifique a matriz vazia para usar o padrão (sem filtro). Consulte o link acima para obter exemplos e descrição detalhada desse campo. | string[] |
| searchCriteria | Critérios para pesquisar atualizações. Omita ou especifique a cadeia de caracteres vazia para usar o padrão (pesquisar tudo). Consulte o link acima para obter exemplos e descrição detalhada desse campo. | string |
| updateLimit | Número máximo de atualizações a serem aplicadas por vez. Omita ou especifique 0 para usar o padrão (1000) | INT |
ImageTemplateDistributor
| Nome | Descrição | Valor |
|---|---|---|
| artifactTags | Marcas que serão aplicadas ao artefato depois que ele for criado/atualizado pelo distribuidor. | objeto |
| runOutputName | O nome a ser usado para o RunOutput associado. | cadeia de caracteres (obrigatório) |
| tipo | Definir o tipo de objeto | ManagedImage SharedImage VHD (obrigatório) |
ImageTemplateManagedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | 'ManagedImage' (obrigatório) |
| imageId | ID do recurso da imagem de disco gerenciado | cadeia de caracteres (obrigatório) |
| local | O local do Azure para a imagem deve corresponder se a imagem já existir | cadeia de caracteres (obrigatório) |
ImageTemplateSharedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | 'SharedImage' (obrigatório) |
| excludeFromLatest | Sinalizador que indica se a versão da imagem criada deve ser excluída da versão mais recente. Omita para usar o padrão (false). | bool |
| galleryImageId | ID do recurso da imagem do Galeria de Imagens Compartilhadas | cadeia de caracteres (obrigatório) |
| replicationRegions | Uma lista de regiões para as quais a imagem será replicada | string[] (obrigatório) |
| storageAccountType | Tipo de conta de armazenamento a ser usado para armazenar a imagem compartilhada. Omita para usar o padrão (Standard_LRS). | 'Standard_LRS' 'Standard_ZRS' |
ImageTemplateVhdDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | 'VHD' (obrigatório) |
ImageTemplateSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Definir o tipo de objeto | ManagedImage PlatformImage SharedImageVersion (obrigatório) |
ImageTemplateManagedImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com a qual você deseja começar. | 'ManagedImage' (obrigatório) |
| imageId | ID de recurso do ARM da imagem gerenciada na assinatura do cliente | cadeia de caracteres (obrigatório) |
ImageTemplatePlatformImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com o qual você deseja começar. | 'PlatformImage' (obrigatório) |
| oferta | Oferta de imagem das Imagens da Galeria do Azure. | string |
| planInfo | Configuração opcional do plano de compra para imagem de plataforma. | PlatformImagePurchasePlan |
| publicador | Editor de Imagens nas Imagens da Galeria do Azure. | string |
| sku | SKU de imagem das imagens da Galeria do Azure. | string |
| version | Versão da imagem das imagens da Galeria do Azure. Se 'latest' for especificado aqui, a versão será avaliada quando o build da imagem ocorrer, não quando o modelo for enviado. | string |
PlatformImagePurchasePlan
| Nome | Descrição | Valor |
|---|---|---|
| planName | Nome do plano de compra. | cadeia de caracteres (obrigatório) |
| planProduct | Produto do plano de compra. | cadeia de caracteres (obrigatório) |
| planPublisher | Publicador do plano de compra. | cadeia de caracteres (obrigatório) |
ImageTemplateSharedImageVersionSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com o qual você deseja começar. | 'SharedImageVersion' (obrigatório) |
| imageVersionId | ID de recurso do ARM da versão da imagem na galeria de imagens compartilhadas | cadeia de caracteres (obrigatório) |
ImageTemplatePropertiesValidate
| Nome | Descrição | Valor |
|---|---|---|
| continueDistributeOnFailure | Se a validação falhar e esse campo for definido como false, as imagens de saída não serão distribuídas. Esse é o comportamento padrão. Se a validação falhar e esse campo for definido como true, as imagens de saída ainda serão distribuídas. Use essa opção com cuidado, pois ela pode resultar na distribuição de imagens incorretas para uso. Em ambos os casos (verdadeiro ou falso), a execução de imagem de ponta a ponta será relatada como tendo falhado em caso de falha de validação. [Observação: esse campo não terá efeito se a validação for bem-sucedida.] | bool |
| inVMValidations | Lista de validações a serem executadas. | ImageTemplateInVMValidator[] |
| sourceValidationOnly | Se esse campo for definido como true, a imagem especificada na seção 'source' será validada diretamente. Nenhuma compilação separada será executada para gerar e validar uma imagem personalizada. | bool |
ImageTemplateInVMValidator
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome amigável para fornecer contexto sobre o que essa etapa de validação faz | string |
| type | Definir o tipo de objeto | PowerShell Shell (obrigatório) |
ImageTemplatePowerShellValidator
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de validação que você deseja usar na Imagem. Por exemplo, "Shell" pode ser validação de shell | 'PowerShell' (obrigatório) |
| inline | Matriz de comandos do PowerShell a serem executados | string[] |
| runAsSystem | Se especificado, o script do PowerShell será executado com privilégios elevados usando o usuário do Sistema Local. Só pode ser true quando o campo runElevated acima é definido como true. | bool |
| runElevated | Se especificado, o script do PowerShell será executado com privilégios elevados | bool |
| scriptUri | URI do script do PowerShell a ser executado para validação. Pode ser um link do github, URI de Armazenamento do Azure etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script do Power Shell fornecido no campo scriptUri acima | string |
| validExitCodes | Códigos de saída válidos para o script do PowerShell. [Padrão: 0] | int[] |
ImageTemplateShellValidator
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de validação que você deseja usar na Imagem. Por exemplo, "Shell" pode ser validação de shell | 'Shell' (obrigatório) |
| inline | Matriz de comandos de shell a serem executados | string[] |
| scriptUri | URI do script de shell a ser executado para validação. Pode ser um link do github, URI de Armazenamento do Azure etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script de shell fornecido no campo scriptUri | string |
ImageTemplateVmProfile
| Nome | Descrição | Valor |
|---|---|---|
| osDiskSizeGB | Tamanho do disco do sistema operacional em GB. Omita ou especifique 0 para usar o tamanho padrão do disco do sistema operacional do Azure. | INT |
| userAssignedIdentities | Matriz opcional de IDs de recurso de identidades gerenciadas atribuídas pelo usuário a serem configuradas na VM de build e na VM de validação. Isso pode incluir a identidade do modelo de imagem. | string[] |
| vmSize | Tamanho da máquina virtual usada para criar, personalizar e capturar imagens. Omita ou especifique a cadeia de caracteres vazia para usar o padrão (Standard_D1_v2 para imagens gen1 e Standard_D2ds_v4 para imagens Gen2). | string |
| vnetConfig | Configuração opcional da rede virtual a ser usada para implantar a VM de build e a VM de validação. Omita isso se nenhuma rede virtual específica precisar ser usada. | VirtualNetworkConfig |
VirtualNetworkConfig
| Nome | Descrição | Valor |
|---|---|---|
| proxyVmSize | Tamanho da máquina virtual proxy usada para passar o tráfego para a VM de build e a VM de validação. Omita ou especifique a cadeia de caracteres vazia para usar o padrão (Standard_A1_v2). | string |
| subnetId | ID de recurso de uma sub-rede pré-existente. | string |
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
| Modelo | Descrição |
|---|---|
Construtor de Imagens do Azure com a Linha de Base do Windows do Azure |
Cria um ambiente do Construtor de Imagens do Azure e cria uma imagem do Windows Server com o Windows Atualizações mais recente e a Linha de Base do Windows do Azure aplicadas. |
| Configurar o serviço Dev Box |
Esse modelo criaria todos os recursos de administrador do Dev Box de acordo com o guia de início rápido do Dev Box. Você pode exibir todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar seu primeiro Dev Box. |
Definição de recurso de modelo do ARM
O tipo de recurso imageTemplates pode ser implantado em:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o JSON a seguir ao modelo.
{
"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"
}
}
}
}
Objetos ImageTemplateCustomizer
Defina a propriedade type para especificar o tipo de objeto.
Para Arquivo, use:
"type": "File",
"destination": "string",
"sha256Checksum": "string",
"sourceUri": "string"
Para o PowerShell, use:
"type": "PowerShell",
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
Para Shell, use:
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
Para WindowsRestart, use:
"type": "WindowsRestart",
"restartCheckCommand": "string",
"restartCommand": "string",
"restartTimeout": "string"
Para WindowsUpdate, use:
"type": "WindowsUpdate",
"filters": [ "string" ],
"searchCriteria": "string",
"updateLimit": "int"
Objetos ImageTemplateDistributor
Defina a propriedade type para especificar o tipo de objeto.
Para ManagedImage, use:
"type": "ManagedImage",
"imageId": "string",
"location": "string"
Para SharedImage, use:
"type": "SharedImage",
"excludeFromLatest": "bool",
"galleryImageId": "string",
"replicationRegions": [ "string" ],
"storageAccountType": "string"
Para VHD, use:
"type": "VHD"
Objetos ImageTemplateSource
Defina a propriedade type para especificar o tipo de objeto.
Para ManagedImage, use:
"type": "ManagedImage",
"imageId": "string"
Para PlatformImage, use:
"type": "PlatformImage",
"offer": "string",
"planInfo": {
"planName": "string",
"planProduct": "string",
"planPublisher": "string"
},
"publisher": "string",
"sku": "string",
"version": "string"
Para SharedImageVersion, use:
"type": "SharedImageVersion",
"imageVersionId": "string"
Objetos ImageTemplateInVMValidator
Defina a propriedade type para especificar o tipo de objeto.
Para o PowerShell, use:
"type": "PowerShell",
"inline": [ "string" ],
"runAsSystem": "bool",
"runElevated": "bool",
"scriptUri": "string",
"sha256Checksum": "string",
"validExitCodes": [ "int" ]
Para Shell, use:
"type": "Shell",
"inline": [ "string" ],
"scriptUri": "string",
"sha256Checksum": "string"
Valores de propriedade
imageTemplates
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | 'Microsoft.VirtualMachineImages/imageTemplates' |
| apiVersion | A versão da API de recursos | '2022-02-14' |
| name | O nome do recurso | cadeia de caracteres (obrigatório) |
| local | A localização geográfica em que o recurso reside | cadeia de caracteres (obrigatório) |
| marcas | Marcas de recurso. | Dicionário de nomes e valores de marcas. Confira Marcas em modelos |
| identidade | A identidade do modelo de imagem, se configurada. | ImageTemplateIdentity (obrigatório) |
| properties | As propriedades do modelo de imagem | ImageTemplateProperties |
ImageTemplateIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade usado para o modelo de imagem. O tipo 'None' removerá todas as identidades do modelo de imagem. | 'None' 'UserAssigned' |
| userAssignedIdentities | A lista de identidades de usuário associadas ao modelo de imagem. As referências de chave de dicionário de identidade do usuário serão IDs de recurso do ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | objeto |
ImageTemplateProperties
| Nome | Descrição | Valor |
|---|---|---|
| buildTimeoutInMinutes | Duração máxima a aguardar durante a compilação do modelo de imagem (inclui todas as personalizações, validações e distribuições). Omita ou especifique 0 para usar o padrão (4 horas). | INT |
| Personalizar | Especifica as propriedades usadas para descrever as etapas de personalização da imagem, como Fonte de imagem etc. | ImageTemplateCustomizer[] |
| distribuir | A distribuição é direcionada para onde a saída da imagem precisa ir. | ImageTemplateDistributor[] (obrigatório) |
| source | Especifica as propriedades usadas para descrever a imagem de origem. | ImageTemplateSource (obrigatório) |
| stagingResourceGroup | A ID do grupo de recursos de preparo na mesma assinatura que o modelo de imagem que será usado para compilar a imagem. Se esse campo estiver vazio, um grupo de recursos com um nome aleatório será criado. Se o grupo de recursos especificado neste campo não existir, ele será criado com o mesmo nome. Se o grupo de recursos especificado existir, ele deverá estar vazio e na mesma região que o modelo de imagem. O grupo de recursos criado será excluído durante a exclusão do modelo se esse campo estiver vazio ou o grupo de recursos especificado não existir, mas se o grupo de recursos especificado existir, os recursos criados no grupo de recursos serão excluídos durante a exclusão do modelo e o próprio grupo de recursos permanecerá. | string |
| validade | Opções de configuração e lista de validações a serem executadas na imagem resultante. | ImageTemplatePropertiesValidate |
| vmProfile | Descreve como a máquina virtual é configurada para criar imagens | ImageTemplateVmProfile |
ImageTemplateCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome amigável para fornecer contexto sobre o que essa etapa de personalização faz | string |
| type | Definir o tipo de objeto | Arquivo PowerShell Shell WindowsRestart WindowsUpdate (obrigatório) |
ImageTemplateFileCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | 'File' (obrigatório) |
| destino | O caminho absoluto para um arquivo (com estruturas de diretório aninhadas já criadas) em que o arquivo (de sourceUri) será carregado na VM | string |
| sha256Checksum | Soma de verificação SHA256 do arquivo fornecido no campo sourceUri acima | string |
| sourceUri | O URI do arquivo a ser carregado para personalizar a VM. Pode ser um link do github, URI de SAS para o Armazenamento do Azure etc. | string |
ImageTemplatePowerShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | 'PowerShell' (obrigatório) |
| inline | Matriz de comandos do PowerShell a serem executados | string[] |
| runAsSystem | Se especificado, o script do PowerShell será executado com privilégios elevados usando o usuário do Sistema Local. Só pode ser true quando o campo runElevated acima é definido como true. | bool |
| runElevated | Se especificado, o script do PowerShell será executado com privilégios elevados | bool |
| scriptUri | URI do script do PowerShell a ser executado para personalização. Pode ser um link do github, URI de SAS para o Armazenamento do Azure etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script do Power Shell fornecido no campo scriptUri acima | string |
| validExitCodes | Códigos de saída válidos para o script do PowerShell. [Padrão: 0] | int[] |
ImageTemplateShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | 'Shell' (obrigatório) |
| inline | Matriz de comandos de shell a serem executados | string[] |
| scriptUri | URI do script de shell a ser executado para personalização. Pode ser um link do github, URI de SAS para o Armazenamento do Azure etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script de shell fornecido no campo scriptUri | string |
ImageTemplateRestartCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | 'WindowsRestart' (obrigatório) |
| restartCheckCommand | Comando para marcar se a reinicialização foi bem-sucedida [Padrão: ''] | string |
| restartCommand | Comando para executar a reinicialização [Padrão: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
| restartTimeout | Tempo limite de reinicialização especificado como uma cadeia de caracteres de magnitude e unidade, por exemplo, '5m' (5 minutos) ou '2h' (2 horas) [Padrão: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser personalizador de shell | 'WindowsUpdate' (obrigatório) |
| filtros | Matriz de filtros para selecionar atualizações a serem aplicadas. Omita ou especifique uma matriz vazia para usar o padrão (sem filtro). Consulte o link acima para obter exemplos e descrição detalhada desse campo. | string[] |
| searchCriteria | Critérios para pesquisar atualizações. Omita ou especifique uma cadeia de caracteres vazia para usar o padrão (pesquisar tudo). Consulte o link acima para obter exemplos e descrição detalhada desse campo. | string |
| updateLimit | Número máximo de atualizações a serem aplicadas por vez. Omita ou especifique 0 para usar o padrão (1000) | INT |
ImageTemplateDistributor
| Nome | Descrição | Valor |
|---|---|---|
| artifactTags | Marcas que serão aplicadas ao artefato depois que ele tiver sido criado/atualizado pelo distribuidor. | objeto |
| runOutputName | O nome a ser usado para o RunOutput associado. | cadeia de caracteres (obrigatório) |
| tipo | Definir o tipo de objeto | ManagedImage SharedImage VHD (obrigatório) |
ImageTemplateManagedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | 'ManagedImage' (obrigatório) |
| imageId | ID do recurso da imagem do disco gerenciado | cadeia de caracteres (obrigatório) |
| local | O local do Azure para a imagem deve corresponder se a imagem já existir | cadeia de caracteres (obrigatório) |
ImageTemplateSharedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | 'SharedImage' (obrigatório) |
| excludeFromLatest | Sinalizador que indica se a versão da imagem criada deve ser excluída da versão mais recente. Omita para usar o padrão (false). | bool |
| galleryImageId | ID do recurso da imagem do Galeria de Imagens Compartilhadas | cadeia de caracteres (obrigatório) |
| replicationRegions | Uma lista de regiões para as quais a imagem será replicada | string[] (obrigatório) |
| storageAccountType | Tipo de conta de armazenamento a ser usado para armazenar a imagem compartilhada. Omita para usar o padrão (Standard_LRS). | 'Standard_LRS' 'Standard_ZRS' |
ImageTemplateVhdDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | 'VHD' (obrigatório) |
ImageTemplateSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Definir o tipo de objeto | ManagedImage PlatformImage SharedImageVersion (obrigatório) |
ImageTemplateManagedImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com a qual você deseja começar. | 'ManagedImage' (obrigatório) |
| imageId | ID de recurso do ARM da imagem gerenciada na assinatura do cliente | cadeia de caracteres (obrigatório) |
ImageTemplatePlatformImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com a qual você deseja começar. | 'PlatformImage' (obrigatório) |
| oferta | Oferta de imagem das Imagens da Galeria do Azure. | string |
| planInfo | Configuração opcional do plano de compra para a imagem da plataforma. | PlatformImagePurchasePlan |
| publicador | Editor de Imagens na Galeria do Azure Imagens. | string |
| sku | SKU de imagem das Imagens da Galeria do Azure. | string |
| version | Versão da imagem das Imagens da Galeria do Azure. Se 'latest' for especificado aqui, a versão será avaliada quando o build de imagem ocorrer, não quando o modelo for enviado. | string |
PlatformImagePurchasePlan
| Nome | Descrição | Valor |
|---|---|---|
| planName | Nome do plano de compra. | cadeia de caracteres (obrigatório) |
| planProduct | Produto do plano de compra. | cadeia de caracteres (obrigatório) |
| planPublisher | Publicador do plano de compra. | cadeia de caracteres (obrigatório) |
ImageTemplateSharedImageVersionSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com a qual você deseja começar. | 'SharedImageVersion' (obrigatório) |
| imageVersionId | ID de recurso do ARM da versão da imagem na galeria de imagens compartilhadas | cadeia de caracteres (obrigatório) |
ImageTemplatePropertiesValidate
| Nome | Descrição | Valor |
|---|---|---|
| continueDistributeOnFailure | Se a validação falhar e esse campo for definido como false, as imagens de saída não serão distribuídas. Esse é o comportamento padrão. Se a validação falhar e esse campo for definido como true, as imagens de saída ainda serão distribuídas. Use essa opção com cuidado, pois pode resultar na distribuição de imagens incorretas para uso. Em ambos os casos (true ou false), a execução de imagem de ponta a ponta será relatada como tendo falhado no caso de uma falha de validação. [Observação: esse campo não terá efeito se a validação for bem-sucedida.] | bool |
| inVMValidations | Lista de validações a serem executadas. | ImageTemplateInVMValidator[] |
| sourceValidationOnly | Se esse campo for definido como true, a imagem especificada na seção 'source' será validada diretamente. Nenhuma compilação separada será executada para gerar e validar uma imagem personalizada. | bool |
ImageTemplateInVMValidator
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome amigável para fornecer contexto sobre o que essa etapa de validação faz | string |
| type | Definir o tipo de objeto | PowerShell Shell (obrigatório) |
ImageTemplatePowerShellValidator
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de validação que você deseja usar na Imagem. Por exemplo, "Shell" pode ser validação de shell | 'PowerShell' (obrigatório) |
| inline | Matriz de comandos do PowerShell a serem executados | string[] |
| runAsSystem | Se especificado, o script do PowerShell será executado com privilégios elevados usando o usuário do Sistema Local. Só pode ser verdadeiro quando o campo runElevated acima é definido como true. | bool |
| runElevated | Se especificado, o script do PowerShell será executado com privilégios elevados | bool |
| scriptUri | URI do script do PowerShell a ser executado para validação. Pode ser um link do github, URI de Armazenamento do Azure etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script do power shell fornecido no campo scriptUri acima | string |
| validExitCodes | Códigos de saída válidos para o script do PowerShell. [Padrão: 0] | int[] |
ImageTemplateShellValidator
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de validação que você deseja usar na Imagem. Por exemplo, "Shell" pode ser validação de shell | 'Shell' (obrigatório) |
| inline | Matriz de comandos de shell a serem executados | string[] |
| scriptUri | URI do script de shell a ser executado para validação. Pode ser um link do github, URI de Armazenamento do Azure etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script de shell fornecido no campo scriptUri | string |
ImageTemplateVmProfile
| Nome | Descrição | Valor |
|---|---|---|
| osDiskSizeGB | Tamanho do disco do sistema operacional em GB. Omita ou especifique 0 para usar o tamanho padrão do disco do sistema operacional do Azure. | INT |
| userAssignedIdentities | Matriz opcional de IDs de recurso de identidades gerenciadas atribuídas pelo usuário a serem configuradas na VM de build e na VM de validação. Isso pode incluir a identidade do modelo de imagem. | string[] |
| vmSize | Tamanho da máquina virtual usada para criar, personalizar e capturar imagens. Omita ou especifique a cadeia de caracteres vazia para usar o padrão (Standard_D1_v2 para imagens gen1 e Standard_D2ds_v4 para imagens Gen2). | string |
| vnetConfig | Configuração opcional da rede virtual a ser usada para implantar a VM de build e a VM de validação. Omita isso se nenhuma rede virtual específica precisar ser usada. | VirtualNetworkConfig |
VirtualNetworkConfig
| Nome | Descrição | Valor |
|---|---|---|
| proxyVmSize | Tamanho da máquina virtual proxy usada para passar o tráfego para a VM de build e a VM de validação. Omita ou especifique a cadeia de caracteres vazia para usar o padrão (Standard_A1_v2). | string |
| subnetId | ID de recurso de uma sub-rede pré-existente. | string |
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
| Modelo | Descrição |
|---|---|
| Construtor de Imagens do Azure com a Linha de Base do Windows do Azure |
Cria um ambiente do Construtor de Imagens do Azure e cria uma imagem do Windows Server com o Windows Atualizações mais recente e a Linha de Base do Windows do Azure aplicadas. |
| Configurar o serviço Dev Box |
Esse modelo criaria todos os recursos de administrador do Dev Box de acordo com o guia de início rápido do Dev Box. Você pode exibir todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar seu primeiro Dev Box. |
Definição de recurso do Terraform (provedor AzAPI)
O tipo de recurso imageTemplates pode ser implantado em:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o Terraform a seguir ao modelo.
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"
}
}
}
})
}
Objetos ImageTemplateCustomizer
Defina a propriedade type para especificar o tipo de objeto.
Para Arquivo, use:
type = "File"
destination = "string"
sha256Checksum = "string"
sourceUri = "string"
Para o PowerShell, use:
type = "PowerShell"
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
Para Shell, use:
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
Para WindowsRestart, use:
type = "WindowsRestart"
restartCheckCommand = "string"
restartCommand = "string"
restartTimeout = "string"
Para WindowsUpdate, use:
type = "WindowsUpdate"
filters = [
"string"
]
searchCriteria = "string"
updateLimit = int
Objetos ImageTemplateDistributor
Defina a propriedade type para especificar o tipo de objeto.
Para ManagedImage, use:
type = "ManagedImage"
imageId = "string"
location = "string"
Para SharedImage, use:
type = "SharedImage"
excludeFromLatest = bool
galleryImageId = "string"
replicationRegions = [
"string"
]
storageAccountType = "string"
Para VHD, use:
type = "VHD"
Objetos ImageTemplateSource
Defina a propriedade type para especificar o tipo de objeto.
Para ManagedImage, use:
type = "ManagedImage"
imageId = "string"
Para PlatformImage, use:
type = "PlatformImage"
offer = "string"
planInfo = {
planName = "string"
planProduct = "string"
planPublisher = "string"
}
publisher = "string"
sku = "string"
version = "string"
Para SharedImageVersion, use:
type = "SharedImageVersion"
imageVersionId = "string"
Objetos ImageTemplateInVMValidator
Defina a propriedade type para especificar o tipo de objeto.
Para o PowerShell, use:
type = "PowerShell"
inline = [
"string"
]
runAsSystem = bool
runElevated = bool
scriptUri = "string"
sha256Checksum = "string"
validExitCodes = [
int
]
Para Shell, use:
type = "Shell"
inline = [
"string"
]
scriptUri = "string"
sha256Checksum = "string"
Valores de propriedade
imageTemplates
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14" |
| name | O nome do recurso | cadeia de caracteres (obrigatório) |
| local | A localização geográfica em que o recurso reside | cadeia de caracteres (obrigatório) |
| parent_id | Para implantar em um grupo de recursos, use a ID desse grupo de recursos. | cadeia de caracteres (obrigatório) |
| marcas | Marcas de recurso. | Dicionário de nomes e valores de marcas. |
| identidade | A identidade do modelo de imagem, se configurada. | ImageTemplateIdentity (obrigatório) |
| properties | As propriedades do modelo de imagem | ImageTemplateProperties |
ImageTemplateIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade usado para o modelo de imagem. O tipo 'None' removerá todas as identidades do modelo de imagem. | "UserAssigned" |
| identity_ids | A lista de identidades de usuário associadas ao modelo de imagem. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | Matriz de IDs de identidade do usuário. |
ImageTemplateProperties
| Nome | Descrição | Valor |
|---|---|---|
| buildTimeoutInMinutes | Duração máxima a aguardar durante a compilação do modelo de imagem (inclui todas as personalizações, validações e distribuições). Omita ou especifique 0 para usar o padrão (4 horas). | INT |
| Personalizar | Especifica as propriedades usadas para descrever as etapas de personalização da imagem, como Fonte de imagem etc. | ImageTemplateCustomizer[] |
| distribuir | A distribuição é direcionada para onde a saída da imagem precisa ir. | ImageTemplateDistributor[] (obrigatório) |
| source | Especifica as propriedades usadas para descrever a imagem de origem. | ImageTemplateSource (obrigatório) |
| stagingResourceGroup | A ID do grupo de recursos de preparo na mesma assinatura que o modelo de imagem que será usado para compilar a imagem. Se esse campo estiver vazio, um grupo de recursos com um nome aleatório será criado. Se o grupo de recursos especificado nesse campo não existir, ele será criado com o mesmo nome. Se o grupo de recursos especificado existir, ele deverá estar vazio e na mesma região que o modelo de imagem. O grupo de recursos criado será excluído durante a exclusão do modelo se esse campo estiver vazio ou o grupo de recursos especificado não existir, mas se o grupo de recursos especificado existir, os recursos criados no grupo de recursos serão excluídos durante a exclusão do modelo e o próprio grupo de recursos permanecerá. | string |
| validade | Opções de configuração e lista de validações a serem executadas na imagem resultante. | ImageTemplatePropertiesValidate |
| vmProfile | Descreve como a máquina virtual é configurada para criar imagens | ImageTemplateVmProfile |
ImageTemplateCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome amigável para fornecer contexto sobre o que essa etapa de personalização faz | string |
| type | Definir o tipo de objeto | Arquivo PowerShell Shell WindowsRestart WindowsUpdate (obrigatório) |
ImageTemplateFileCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser um personalizador de shell | "Arquivo" (obrigatório) |
| destino | O caminho absoluto para um arquivo (com estruturas de diretório aninhadas já criadas) em que o arquivo (de sourceUri) será carregado na VM | string |
| sha256Checksum | Soma de verificação SHA256 do arquivo fornecido no campo sourceUri acima | string |
| sourceUri | O URI do arquivo a ser carregado para personalizar a VM. Pode ser um link do github, URI sas para o Armazenamento do Azure, etc. | string |
ImageTemplatePowerShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser um personalizador de shell | "PowerShell" (obrigatório) |
| inline | Matriz de comandos do PowerShell a serem executados | string[] |
| runAsSystem | Se especificado, o script do PowerShell será executado com privilégios elevados usando o usuário do Sistema Local. Só pode ser verdadeiro quando o campo runElevated acima é definido como true. | bool |
| runElevated | Se especificado, o script do PowerShell será executado com privilégios elevados | bool |
| scriptUri | URI do script do PowerShell a ser executado para personalização. Pode ser um link do github, URI sas para o Armazenamento do Azure, etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script do power shell fornecido no campo scriptUri acima | string |
| validExitCodes | Códigos de saída válidos para o script do PowerShell. [Padrão: 0] | int[] |
ImageTemplateShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser um personalizador de shell | "Shell" (obrigatório) |
| inline | Matriz de comandos de shell a serem executados | string[] |
| scriptUri | URI do script de shell a ser executado para personalização. Pode ser um link do github, URI sas para o Armazenamento do Azure, etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script de shell fornecido no campo scriptUri | string |
ImageTemplateRestartCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser um personalizador de shell | "WindowsRestart" (obrigatório) |
| restartCheckCommand | Comando para marcar se a reinicialização for bem-sucedida [Padrão: ''] | string |
| restartCommand | Comando para executar a reinicialização [Padrão: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
| restartTimeout | Tempo limite de reinicialização especificado como uma cadeia de caracteres de magnitude e unidade, por exemplo, '5m' (5 minutos) ou '2h' (2 horas) [Padrão: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "Shell" pode ser um personalizador de shell | "WindowsUpdate" (obrigatório) |
| filtros | Matriz de filtros para selecionar atualizações a serem aplicadas. Omita ou especifique a matriz vazia para usar o padrão (sem filtro). Consulte o link acima para obter exemplos e descrição detalhada desse campo. | string[] |
| searchCriteria | Critérios para pesquisar atualizações. Omita ou especifique a cadeia de caracteres vazia para usar o padrão (pesquisar tudo). Consulte o link acima para obter exemplos e descrição detalhada desse campo. | string |
| updateLimit | Número máximo de atualizações a serem aplicadas por vez. Omita ou especifique 0 para usar o padrão (1000) | INT |
ImageTemplateDistributor
| Nome | Descrição | Valor |
|---|---|---|
| artifactTags | Marcas que serão aplicadas ao artefato depois que ele for criado/atualizado pelo distribuidor. | objeto |
| runOutputName | O nome a ser usado para o RunOutput associado. | cadeia de caracteres (obrigatório) |
| tipo | Definir o tipo de objeto | ManagedImage SharedImage VHD (obrigatório) |
ImageTemplateManagedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "ManagedImage" (obrigatório) |
| imageId | ID do recurso da imagem de disco gerenciado | cadeia de caracteres (obrigatório) |
| local | O local do Azure para a imagem deve corresponder se a imagem já existir | cadeia de caracteres (obrigatório) |
ImageTemplateSharedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "SharedImage" (obrigatório) |
| excludeFromLatest | Sinalizador que indica se a versão da imagem criada deve ser excluída da versão mais recente. Omita para usar o padrão (false). | bool |
| galleryImageId | ID do recurso da imagem do Galeria de Imagens Compartilhadas | cadeia de caracteres (obrigatório) |
| replicationRegions | Uma lista de regiões para as quais a imagem será replicada | string[] (obrigatório) |
| storageAccountType | Tipo de conta de armazenamento a ser usado para armazenar a imagem compartilhada. Omita para usar o padrão (Standard_LRS). | "Standard_LRS" "Standard_ZRS" |
ImageTemplateVhdDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "VHD" (obrigatório) |
ImageTemplateSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Definir o tipo de objeto | ManagedImage PlatformImage SharedImageVersion (obrigatório) |
ImageTemplateManagedImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com o qual você deseja começar. | "ManagedImage" (obrigatório) |
| imageId | ID de recurso do ARM da imagem gerenciada na assinatura do cliente | cadeia de caracteres (obrigatório) |
ImageTemplatePlatformImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com o qual você deseja começar. | "PlatformImage" (obrigatório) |
| oferta | Oferta de imagem das Imagens da Galeria do Azure. | string |
| planInfo | Configuração opcional do plano de compra para imagem de plataforma. | PlatformImagePurchasePlan |
| publicador | Editor de Imagens nas Imagens da Galeria do Azure. | string |
| sku | SKU de imagem das imagens da Galeria do Azure. | string |
| version | Versão da imagem das imagens da Galeria do Azure. Se 'latest' for especificado aqui, a versão será avaliada quando o build da imagem ocorrer, não quando o modelo for enviado. | string |
PlatformImagePurchasePlan
| Nome | Descrição | Valor |
|---|---|---|
| planName | Nome do plano de compra. | cadeia de caracteres (obrigatório) |
| planProduct | Produto do plano de compra. | cadeia de caracteres (obrigatório) |
| planPublisher | Publicador do plano de compra. | cadeia de caracteres (obrigatório) |
ImageTemplateSharedImageVersionSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com o qual você deseja começar. | "SharedImageVersion" (obrigatório) |
| imageVersionId | ID de recurso do ARM da versão da imagem na galeria de imagens compartilhadas | cadeia de caracteres (obrigatório) |
ImageTemplatePropertiesValidate
| Nome | Descrição | Valor |
|---|---|---|
| continueDistributeOnFailure | Se a validação falhar e esse campo for definido como false, as imagens de saída não serão distribuídas. Esse é o comportamento padrão. Se a validação falhar e esse campo for definido como true, as imagens de saída ainda serão distribuídas. Use essa opção com cuidado, pois ela pode resultar na distribuição de imagens incorretas para uso. Em ambos os casos (verdadeiro ou falso), a execução de imagem de ponta a ponta será relatada como tendo falhado em caso de falha de validação. [Observação: esse campo não terá efeito se a validação for bem-sucedida.] | bool |
| inVMValidations | Lista de validações a serem executadas. | ImageTemplateInVMValidator[] |
| sourceValidationOnly | Se esse campo for definido como true, a imagem especificada na seção 'source' será validada diretamente. Nenhuma compilação separada será executada para gerar e validar uma imagem personalizada. | bool |
ImageTemplateInVMValidator
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome amigável para fornecer contexto sobre o que essa etapa de validação faz | string |
| type | Definir o tipo de objeto | PowerShell Shell (obrigatório) |
ImageTemplatePowerShellValidator
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de validação que você deseja usar na Imagem. Por exemplo, "Shell" pode ser validação de shell | "PowerShell" (obrigatório) |
| inline | Matriz de comandos do PowerShell a serem executados | string[] |
| runAsSystem | Se especificado, o script do PowerShell será executado com privilégios elevados usando o usuário do Sistema Local. Só pode ser true quando o campo runElevated acima é definido como true. | bool |
| runElevated | Se especificado, o script do PowerShell será executado com privilégios elevados | bool |
| scriptUri | URI do script do PowerShell a ser executado para validação. Pode ser um link do github, URI de Armazenamento do Azure etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script do Power Shell fornecido no campo scriptUri acima | string |
| validExitCodes | Códigos de saída válidos para o script do PowerShell. [Padrão: 0] | int[] |
ImageTemplateShellValidator
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de validação que você deseja usar na Imagem. Por exemplo, "Shell" pode ser validação de shell | "Shell" (obrigatório) |
| inline | Matriz de comandos de shell a serem executados | string[] |
| scriptUri | URI do script de shell a ser executado para validação. Pode ser um link do github, URI de Armazenamento do Azure etc. | string |
| sha256Checksum | Soma de verificação SHA256 do script de shell fornecido no campo scriptUri | string |
ImageTemplateVmProfile
| Nome | Descrição | Valor |
|---|---|---|
| osDiskSizeGB | Tamanho do disco do sistema operacional em GB. Omita ou especifique 0 para usar o tamanho padrão do disco do sistema operacional do Azure. | INT |
| userAssignedIdentities | Matriz opcional de IDs de recurso de identidades gerenciadas atribuídas pelo usuário a serem configuradas na VM de build e na VM de validação. Isso pode incluir a identidade do modelo de imagem. | string[] |
| vmSize | Tamanho da máquina virtual usada para criar, personalizar e capturar imagens. Omita ou especifique uma cadeia de caracteres vazia para usar o padrão (Standard_D1_v2 para imagens Gen1 e Standard_D2ds_v4 para imagens Gen2). | string |
| vnetConfig | Configuração opcional da rede virtual a ser usada para implantar a VM de build e a VM de validação. Omita isso se nenhuma rede virtual específica precisar ser usada. | VirtualNetworkConfig |
VirtualNetworkConfig
| Nome | Descrição | Valor |
|---|---|---|
| proxyVmSize | Tamanho da máquina virtual proxy usada para passar o tráfego para a VM de build e a VM de validação. Omita ou especifique uma cadeia de caracteres vazia para usar o padrão (Standard_A1_v2). | string |
| subnetId | ID do recurso de uma sub-rede pré-existente. | string |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de