Imagen Microsoft.VirtualMachineImagesTemplates 2020-02-14
Definición de recursos de Bicep
El tipo de recurso imageTemplates se puede implementar en:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.VirtualMachineImages/imageTemplates, agregue el siguiente bicep a la plantilla.
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'
}
}
}
}
Objetos ImageTemplateCustomizer
Establezca la propiedad type para especificar el tipo de objeto.
Para Archivo, use:
type: 'File'
destination: 'string'
sha256Checksum: 'string'
sourceUri: 'string'
Para 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
Establezca la propiedad type para especificar el 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
Establezca la propiedad type para especificar el 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'
Valores de propiedad
imageTemplates
Nombre | Descripción | Value |
---|---|---|
name | El nombre del recurso | string (obligatorio) |
ubicación | Ubicación de los recursos | string (obligatorio) |
etiquetas | Etiquetas del recurso | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
identidad | Identidad de la plantilla de imagen, si está configurada. | ImageTemplateIdentity (obligatorio) |
properties | Propiedades de la plantilla de imagen | ImageTemplateProperties |
ImageTemplateIdentity
Nombre | Descripción | Value |
---|---|---|
type | Tipo de identidad que se usa para la plantilla de imagen. El tipo "None" quitará las identidades de la plantilla de imagen. | 'Ninguno' 'UserAssigned' |
userAssignedIdentities | Lista de identidades de usuario asociadas a la plantilla de imagen. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | object |
ImageTemplateProperties
Nombre | Descripción | Valor |
---|---|---|
buildTimeoutInMinutes | Duración máxima para esperar mientras se compila la plantilla de imagen. Omita o especifique 0 para usar el valor predeterminado (4 horas). | int |
Personalización | Especifica las propiedades usadas para describir los pasos de personalización de la imagen, como el origen de la imagen, etc. | ImageTemplateCustomizer[] |
distribuir | Los destinos de distribución a los que debe ir la salida de la imagen. | ImageTemplateDistributor[] (obligatorio) |
source | Especifica las propiedades usadas para describir la imagen de origen. | ImageTemplateSource (obligatorio) |
vmProfile | Describe cómo se configura la máquina virtual para compilar imágenes | ImageTemplateVmProfile |
ImageTemplateCustomizer
Nombre | Descripción | Value |
---|---|---|
name | Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de personalización | string |
type | Establecimiento del tipo de objeto | Archivo PowerShell Shell WindowsRestart WindowsUpdate (obligatorio) |
ImageTemplateFileCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | 'Archivo' (obligatorio) |
destination | Ruta de acceso absoluta a un archivo (con estructuras de directorio anidadas ya creadas) donde el archivo (desde sourceUri) se cargará en en la máquina virtual. | string |
sha256Checksum | Suma de comprobación SHA256 del archivo proporcionado en el campo sourceUri anterior | string |
SourceUri | URI del archivo que se va a cargar para personalizar la máquina virtual. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. | string |
ImageTemplatePowerShellCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | 'PowerShell' (obligatorio) |
inline | Matriz de comandos de PowerShell que se van a ejecutar | string[] |
runAsSystem | Si se especifica, el script de PowerShell se ejecutará con privilegios elevados mediante el usuario del sistema local. Solo puede ser true cuando el campo runElevated anterior está establecido en true. | bool |
runElevated | Si se especifica, el script de PowerShell se ejecutará con privilegios elevados. | bool |
scriptUri | URI del script de PowerShell que se va a ejecutar para personalizar. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. | string |
sha256Checksum | Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior | string |
validExitCodes | Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0] | int[] |
ImageTemplateShellCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | 'Shell' (obligatorio) |
inline | Matriz de comandos de shell que se van a ejecutar | string[] |
scriptUri | URI del script de shell que se va a ejecutar para personalizar. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. | string |
sha256Checksum | Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri | string |
ImageTemplateRestartCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | 'WindowsRestart' (obligatorio) |
restartCheckCommand | Comando para comprobar si el reinicio se ha realizado correctamente [Valor predeterminado: ''] | string |
restartCommand | Comando para ejecutar el reinicio [Valor predeterminado: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
restartTimeout | Tiempo de espera de reinicio especificado como una cadena de magnitud y unidad, por ejemplo, "5m" (5 minutos) o "2h" (2 horas) [Valor predeterminado: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | 'WindowsUpdate' (obligatorio) |
filters | Matriz de filtros para seleccionar las actualizaciones que se van a aplicar. Omita o especifique una matriz vacía para usar el valor predeterminado (sin filtro). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo. | string[] |
searchCriteria | Criterios para buscar actualizaciones. Omita o especifique una cadena vacía para usar el valor predeterminado (buscar todo). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo. | string |
updateLimit | Número máximo de actualizaciones que se aplicarán a la vez. Omita o especifique 0 para usar el valor predeterminado (1000) | int |
ImageTemplateDistributor
Nombre | Descripción | Valor |
---|---|---|
artifactTags | Etiquetas que se aplicarán al artefacto una vez que el distribuidor haya creado o actualizado. | object |
runOutputName | Nombre que se va a usar para el RunOutput asociado. | string (obligatorio) |
tipo | Establecimiento del tipo de objeto | ManagedImage SharedImage VHD (obligatorio) |
ImageTemplateManagedImageDistributor
Nombre | Descripción | Value |
---|---|---|
type | Tipo de distribución. | 'ManagedImage' (obligatorio) |
imageId | Identificador de recurso de la imagen de disco administrado | string (obligatorio) |
ubicación | La ubicación de Azure de la imagen debe coincidir si la imagen ya existe. | string (obligatorio) |
ImageTemplateSharedImageDistributor
Nombre | Descripción | Value |
---|---|---|
type | Tipo de distribución. | 'SharedImage' (obligatorio) |
excludeFromLatest | Marca que indica si la versión de la imagen creada debe excluirse de la versión más reciente. Omita para usar el valor predeterminado (false). | bool |
galleryImageId | Identificador de recurso de la imagen de Shared Image Gallery | string (obligatorio) |
replicationRegions | Lista de regiones en las que se replicará la imagen | string[] (obligatorio) |
storageAccountType | Tipo de cuenta de almacenamiento que se va a usar para almacenar la imagen compartida. Omita usar el valor predeterminado (Standard_LRS). | 'Standard_LRS' 'Standard_ZRS' |
ImageTemplateVhdDistributor
Nombre | Descripción | Value |
---|---|---|
type | Tipo de distribución. | 'VHD' (obligatorio) |
ImageTemplateSource
Nombre | Descripción | Value |
---|---|---|
type | Establecimiento del tipo de objeto | ManagedImage PlatformImage SharedImageVersion (obligatorio) |
ImageTemplateManagedImageSource
Nombre | Descripción | Value |
---|---|---|
type | Especifica el tipo de imagen de origen con el que desea empezar. | 'ManagedImage' (obligatorio) |
imageId | Identificador de recurso de ARM de la imagen administrada en la suscripción del cliente | string (obligatorio) |
ImageTemplatePlatformImageSource
Nombre | Descripción | Value |
---|---|---|
type | Especifica el tipo de imagen de origen con el que desea empezar. | 'PlatformImage' (obligatorio) |
offer | Oferta de imagen de las imágenes de la Galería de Azure. | string |
planInfo | Configuración opcional del plan de compra para la imagen de plataforma. | PlatformImagePurchasePlan |
publisher | Image Publisher en imágenes de la Galería de Azure. | string |
sku | SKU de imagen de las imágenes de la Galería de Azure. | string |
version | Versión de la imagen de las imágenes de la Galería de Azure. Si se especifica "latest" aquí, la versión se evalúa cuando tiene lugar la compilación de la imagen, no cuando se envía la plantilla. Especificar "latest" podría provocar ROUNDTRIP_INCONSISTENT_PROPERTY problema que se corregirá. | string |
PlatformImagePurchasePlan
Nombre | Descripción | Valor |
---|---|---|
planName | Nombre del plan de compra. | string (obligatorio) |
planProduct | Producto del plan de compra. | string (obligatorio) |
planPublisher | Publicador del plan de compra. | string (obligatorio) |
ImageTemplateSharedImageVersionSource
Nombre | Descripción | Value |
---|---|---|
type | Especifica el tipo de imagen de origen con el que desea empezar. | 'SharedImageVersion' (obligatorio) |
imageVersionId | Identificador de recurso de ARM de la versión de la imagen en la galería de imágenes compartidas | string (obligatorio) |
ImageTemplateVmProfile
Nombre | Descripción | Valor |
---|---|---|
osDiskSizeGB | Tamaño del disco del sistema operativo en GB. Omita o especifique 0 para usar el tamaño predeterminado del disco del sistema operativo de Azure. | int |
vmSize | Tamaño de la máquina virtual que se usa para compilar, personalizar y capturar imágenes. Omita o especifique una cadena vacía para usar el valor predeterminado (Standard_D1_v2 para imágenes de Gen1 y Standard_D2ds_v4 para imágenes de Gen2). | string |
vnetConfig | Configuración opcional de la red virtual que se va a usar para implementar la máquina virtual de compilación en . Omítalo si no es necesario usar ninguna red virtual específica. | VirtualNetworkConfig |
VirtualNetworkConfig
Nombre | Descripción | Valor |
---|---|---|
subnetId | Identificador de recurso de una subred preexistente. | string |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
Plantilla | Descripción |
---|---|
Azure Image Builder con Azure Windows Baseline |
Crea un entorno de Azure Image Builder y crea una imagen de Windows Server con la versión más reciente de Windows Novedades y La línea de base de Windows de Azure aplicada. |
Configuración del servicio Dev Box |
Esta plantilla crearía todos los recursos de administración de Dev Box según la guía de inicio rápido de Dev Box. Puede ver todos los recursos creados o ir directamente a DevPortal.microsoft.com para crear su primer dev Box. |
Definición de recursos de plantilla de ARM
El tipo de recurso imageTemplates se puede implementar en:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.VirtualMachineImages/imageTemplates, agregue el siguiente json a la plantilla.
{
"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"
}
}
}
}
Objetos ImageTemplateCustomizer
Establezca la propiedad type para especificar el tipo de objeto.
Para Archivo, use:
"type": "File",
"destination": "string",
"sha256Checksum": "string",
"sourceUri": "string"
Para 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
Establezca la propiedad type para especificar el 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
Establezca la propiedad type para especificar el 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"
Valores de propiedad
imageTemplates
Nombre | Descripción | Value |
---|---|---|
type | Tipo de recurso | 'Microsoft.VirtualMachineImages/imageTemplates' |
apiVersion | La versión de la API de recursos | '2020-02-14' |
name | El nombre del recurso | string (obligatorio) |
ubicación | Ubicación de los recursos | string (obligatorio) |
etiquetas | Etiquetas del recurso | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
identidad | Identidad de la plantilla de imagen, si está configurada. | ImageTemplateIdentity (obligatorio) |
properties | Propiedades de la plantilla de imagen | ImageTemplateProperties |
ImageTemplateIdentity
Nombre | Descripción | Value |
---|---|---|
type | Tipo de identidad que se usa para la plantilla de imagen. El tipo "None" quitará las identidades de la plantilla de imagen. | 'Ninguno' "UserAssigned" |
userAssignedIdentities | Lista de identidades de usuario asociadas a la plantilla de imagen. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recurso de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | object |
ImageTemplateProperties
Nombre | Descripción | Valor |
---|---|---|
buildTimeoutInMinutes | Duración máxima de espera al compilar la plantilla de imagen. Omita o especifique 0 para usar el valor predeterminado (4 horas). | int |
Personalización | Especifica las propiedades usadas para describir los pasos de personalización de la imagen, como el origen de la imagen, etc. | ImageTemplateCustomizer[] |
distribuir | Los destinos de distribución a los que debe ir la salida de la imagen. | ImageTemplateDistributor[] (obligatorio) |
source | Especifica las propiedades usadas para describir la imagen de origen. | ImageTemplateSource (obligatorio) |
vmProfile | Describe cómo se configura la máquina virtual para compilar imágenes. | ImageTemplateVmProfile |
ImageTemplateCustomizer
Nombre | Descripción | Value |
---|---|---|
name | Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de personalización | string |
type | Establecimiento del tipo de objeto | Archivo PowerShell Shell WindowsRestart WindowsUpdate (obligatorio) |
ImageTemplateFileCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | 'File' (obligatorio) |
destination | Ruta de acceso absoluta a un archivo (con estructuras de directorio anidadas ya creadas) donde el archivo (desde sourceUri) se cargará en en la máquina virtual. | string |
sha256Checksum | Suma de comprobación SHA256 del archivo proporcionado en el campo sourceUri anterior | string |
SourceUri | URI del archivo que se va a cargar para personalizar la máquina virtual. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. | string |
ImageTemplatePowerShellCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | 'PowerShell' (obligatorio) |
inline | Matriz de comandos de PowerShell que se van a ejecutar | string[] |
runAsSystem | Si se especifica, el script de PowerShell se ejecutará con privilegios elevados mediante el usuario del sistema local. Solo puede ser true cuando el campo runElevated anterior se establece en true. | bool |
runElevated | Si se especifica, el script de PowerShell se ejecutará con privilegios elevados. | bool |
scriptUri | URI del script de PowerShell que se va a ejecutar para la personalización. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. | string |
sha256Checksum | Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior | string |
validExitCodes | Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0] | int[] |
ImageTemplateShellCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | 'Shell' (obligatorio) |
inline | Matriz de comandos de shell que se van a ejecutar | string[] |
scriptUri | URI del script de shell que se va a ejecutar para personalizar. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. | string |
sha256Checksum | Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri | string |
ImageTemplateRestartCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | 'WindowsRestart' (obligatorio) |
restartCheckCommand | Comando para comprobar si el reinicio se ha realizado correctamente [Valor predeterminado: ''] | string |
restartCommand | Comando para ejecutar el reinicio [Valor predeterminado: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
restartTimeout | Tiempo de espera de reinicio especificado como una cadena de magnitud y unidad, por ejemplo, "5m" (5 minutos) o "2h" (2 horas) [Valor predeterminado: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | 'WindowsUpdate' (obligatorio) |
filters | Matriz de filtros para seleccionar las actualizaciones que se van a aplicar. Omita o especifique una matriz vacía para usar el valor predeterminado (sin filtro). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo. | string[] |
searchCriteria | Criterios para buscar actualizaciones. Omita o especifique una cadena vacía para usar el valor predeterminado (buscar todo). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo. | string |
updateLimit | Número máximo de actualizaciones que se aplicarán a la vez. Omita o especifique 0 para usar el valor predeterminado (1000) | int |
ImageTemplateDistributor
Nombre | Descripción | Valor |
---|---|---|
artifactTags | Etiquetas que se aplicarán al artefacto una vez que el distribuidor haya creado o actualizado. | object |
runOutputName | Nombre que se va a usar para el RunOutput asociado. | string (obligatorio) |
tipo | Establecimiento del tipo de objeto | ManagedImage SharedImage VHD (obligatorio) |
ImageTemplateManagedImageDistributor
Nombre | Descripción | Value |
---|---|---|
type | Tipo de distribución. | 'ManagedImage' (obligatorio) |
imageId | Identificador de recurso de la imagen de disco administrado | string (obligatorio) |
ubicación | La ubicación de Azure de la imagen debe coincidir si la imagen ya existe. | string (obligatorio) |
ImageTemplateSharedImageDistributor
Nombre | Descripción | Value |
---|---|---|
type | Tipo de distribución. | 'SharedImage' (obligatorio) |
excludeFromLatest | Marca que indica si la versión de la imagen creada debe excluirse de la versión más reciente. Omita usar el valor predeterminado (false). | bool |
galleryImageId | Identificador de recurso de la imagen de Shared Image Gallery | string (obligatorio) |
replicationRegions | Lista de regiones en las que se replicará la imagen. | string[] (obligatorio) |
storageAccountType | Tipo de cuenta de almacenamiento que se usará para almacenar la imagen compartida. Omita usar el valor predeterminado (Standard_LRS). | 'Standard_LRS' 'Standard_ZRS' |
ImageTemplateVhdDistributor
Nombre | Descripción | Value |
---|---|---|
type | Tipo de distribución. | 'VHD' (obligatorio) |
ImageTemplateSource
Nombre | Descripción | Value |
---|---|---|
type | Establecimiento del tipo de objeto | ManagedImage PlatformImage SharedImageVersion (obligatorio) |
ImageTemplateManagedImageSource
Nombre | Descripción | Value |
---|---|---|
type | Especifica el tipo de imagen de origen con el que desea empezar. | 'ManagedImage' (obligatorio) |
imageId | Identificador de recurso de ARM de la imagen administrada en la suscripción del cliente | string (obligatorio) |
ImageTemplatePlatformImageSource
Nombre | Descripción | Value |
---|---|---|
type | Especifica el tipo de imagen de origen con el que desea empezar. | 'PlatformImage' (obligatorio) |
offer | Oferta de imagen de las imágenes de la Galería de Azure. | string |
planInfo | Configuración opcional del plan de compra para la imagen de plataforma. | PlatformImagePurchasePlan |
publisher | Image Publisher en imágenes de la Galería de Azure. | string |
sku | SKU de imagen de las imágenes de la Galería de Azure. | string |
version | Versión de la imagen de las imágenes de la Galería de Azure. Si se especifica "latest" aquí, la versión se evalúa cuando tiene lugar la compilación de la imagen, no cuando se envía la plantilla. Especificar "latest" podría provocar ROUNDTRIP_INCONSISTENT_PROPERTY problema que se corregirá. | string |
PlatformImagePurchasePlan
Nombre | Descripción | Valor |
---|---|---|
planName | Nombre del plan de compra. | string (obligatorio) |
planProduct | Producto del plan de compra. | string (obligatorio) |
planPublisher | Publicador del plan de compra. | string (obligatorio) |
ImageTemplateSharedImageVersionSource
Nombre | Descripción | Value |
---|---|---|
type | Especifica el tipo de imagen de origen con el que desea empezar. | 'SharedImageVersion' (obligatorio) |
imageVersionId | Identificador de recurso de ARM de la versión de la imagen en la galería de imágenes compartidas | string (obligatorio) |
ImageTemplateVmProfile
Nombre | Descripción | Valor |
---|---|---|
osDiskSizeGB | Tamaño del disco del sistema operativo en GB. Omita o especifique 0 para usar el tamaño predeterminado del disco del sistema operativo de Azure. | int |
vmSize | Tamaño de la máquina virtual que se usa para compilar, personalizar y capturar imágenes. Omita o especifique una cadena vacía para usar el valor predeterminado (Standard_D1_v2 para imágenes de Gen1 y Standard_D2ds_v4 para imágenes de Gen2). | string |
vnetConfig | Configuración opcional de la red virtual que se va a usar para implementar la máquina virtual de compilación en . Omítalo si no es necesario usar ninguna red virtual específica. | VirtualNetworkConfig |
VirtualNetworkConfig
Nombre | Descripción | Valor |
---|---|---|
subnetId | Identificador de recurso de una subred preexistente. | string |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
Plantilla | Descripción |
---|---|
Azure Image Builder con Azure Windows Baseline |
Crea un entorno de Azure Image Builder y crea una imagen de Windows Server con la versión más reciente de Windows Novedades y La línea de base de Windows de Azure aplicada. |
Configuración del servicio Dev Box |
Esta plantilla crearía todos los recursos de administración de Dev Box según la guía de inicio rápido de Dev Box. Puede ver todos los recursos creados o ir directamente a DevPortal.microsoft.com para crear su primer dev Box. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso imageTemplates se puede implementar en:
- Grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.VirtualMachineImages/imageTemplates, agregue el siguiente Terraform a la plantilla.
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"
}
}
}
})
}
Objetos ImageTemplateCustomizer
Establezca la propiedad type para especificar el tipo de objeto.
Para Archivo, use:
type = "File"
destination = "string"
sha256Checksum = "string"
sourceUri = "string"
Para 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
Establezca la propiedad type para especificar el 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
Establezca la propiedad type para especificar el 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"
Valores de propiedad
imageTemplates
Nombre | Descripción | Value |
---|---|---|
type | Tipo de recurso | "Microsoft.VirtualMachineImages/imageTemplates@2020-02-14" |
name | El nombre del recurso | string (obligatorio) |
ubicación | Ubicación de los recursos | string (obligatorio) |
parent_id | Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. | string (obligatorio) |
etiquetas | Etiquetas del recurso | Diccionario de nombres y valores de etiqueta. |
identidad | Identidad de la plantilla de imagen, si está configurada. | ImageTemplateIdentity (obligatorio) |
properties | Propiedades de la plantilla de imagen | ImageTemplateProperties |
ImageTemplateIdentity
Nombre | Descripción | Value |
---|---|---|
type | Tipo de identidad que se usa para la plantilla de imagen. El tipo "None" quitará las identidades de la plantilla de imagen. | "UserAssigned" |
identity_ids | Lista de identidades de usuario asociadas a la plantilla de imagen. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recurso de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | Matriz de identificadores de identidad de usuario. |
ImageTemplateProperties
Nombre | Descripción | Valor |
---|---|---|
buildTimeoutInMinutes | Duración máxima de espera al compilar la plantilla de imagen. Omita o especifique 0 para usar el valor predeterminado (4 horas). | int |
Personalización | Especifica las propiedades usadas para describir los pasos de personalización de la imagen, como el origen de la imagen, etc. | ImageTemplateCustomizer[] |
distribuir | Los destinos de distribución a los que debe ir la salida de la imagen. | ImageTemplateDistributor[] (obligatorio) |
source | Especifica las propiedades usadas para describir la imagen de origen. | ImageTemplateSource (obligatorio) |
vmProfile | Describe cómo se configura la máquina virtual para compilar imágenes. | ImageTemplateVmProfile |
ImageTemplateCustomizer
Nombre | Descripción | Value |
---|---|---|
name | Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de personalización | string |
type | Establecimiento del tipo de objeto | Archivo PowerShell Shell WindowsRestart WindowsUpdate (obligatorio) |
ImageTemplateFileCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | "Archivo" (obligatorio) |
destination | Ruta de acceso absoluta a un archivo (con estructuras de directorio anidadas ya creadas) donde el archivo (desde sourceUri) se cargará en en la máquina virtual. | string |
sha256Checksum | Suma de comprobación SHA256 del archivo proporcionado en el campo sourceUri anterior | string |
SourceUri | URI del archivo que se va a cargar para personalizar la máquina virtual. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. | string |
ImageTemplatePowerShellCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | "PowerShell" (obligatorio) |
inline | Matriz de comandos de PowerShell que se van a ejecutar | string[] |
runAsSystem | Si se especifica, el script de PowerShell se ejecutará con privilegios elevados mediante el usuario del sistema local. Solo puede ser true cuando el campo runElevated anterior se establece en true. | bool |
runElevated | Si se especifica, el script de PowerShell se ejecutará con privilegios elevados. | bool |
scriptUri | URI del script de PowerShell que se va a ejecutar para la personalización. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. | string |
sha256Checksum | Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior | string |
validExitCodes | Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0] | int[] |
ImageTemplateShellCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | "Shell" (obligatorio) |
inline | Matriz de comandos de shell que se van a ejecutar | string[] |
scriptUri | URI del script de shell que se va a ejecutar para personalizar. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. | string |
sha256Checksum | Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri | string |
ImageTemplateRestartCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | "WindowsRestart" (obligatorio) |
restartCheckCommand | Comando para comprobar si el reinicio se realizó correctamente [Valor predeterminado: ''] | string |
restartCommand | Comando para ejecutar el reinicio [Valor predeterminado: 'shutdown /r /f /t 0 /c "packer restart"'] | string |
restartTimeout | Tiempo de espera de reinicio especificado como una cadena de magnitud y unidad, por ejemplo, '5m' (5 minutos) o '2h' (2 horas) [Valor predeterminado: '5m'] | string |
ImageTemplateWindowsUpdateCustomizer
Nombre | Descripción | Value |
---|---|---|
type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. | "WindowsUpdate" (obligatorio) |
filters | Matriz de filtros para seleccionar las actualizaciones que se van a aplicar. Omita o especifique una matriz vacía para usar el valor predeterminado (sin filtro). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo. | string[] |
searchCriteria | Criterios para buscar actualizaciones. Omita o especifique una cadena vacía para usar el valor predeterminado (buscar todo). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo. | string |
updateLimit | Número máximo de actualizaciones que se aplicarán a la vez. Omita o especifique 0 para usar el valor predeterminado (1000) | int |
ImageTemplateDistributor
Nombre | Descripción | Valor |
---|---|---|
artifactTags | Etiquetas que se aplicarán al artefacto una vez que el distribuidor haya creado o actualizado. | object |
runOutputName | Nombre que se va a usar para el RunOutput asociado. | string (obligatorio) |
tipo | Establecimiento del tipo de objeto | ManagedImage SharedImage VHD (obligatorio) |
ImageTemplateManagedImageDistributor
Nombre | Descripción | Value |
---|---|---|
type | Tipo de distribución. | "ManagedImage" (obligatorio) |
imageId | Identificador de recurso de la imagen de disco administrado | string (obligatorio) |
ubicación | La ubicación de Azure de la imagen debe coincidir si la imagen ya existe. | string (obligatorio) |
ImageTemplateSharedImageDistributor
Nombre | Descripción | Value |
---|---|---|
type | Tipo de distribución. | "SharedImage" (obligatorio) |
excludeFromLatest | Marca que indica si la versión de la imagen creada debe excluirse de la versión más reciente. Omita para usar el valor predeterminado (false). | bool |
galleryImageId | Identificador de recurso de la imagen de Shared Image Gallery | string (obligatorio) |
replicationRegions | Lista de regiones en las que se replicará la imagen | string[] (obligatorio) |
storageAccountType | Tipo de cuenta de almacenamiento que se va a usar para almacenar la imagen compartida. Omita usar el valor predeterminado (Standard_LRS). | "Standard_LRS" "Standard_ZRS" |
ImageTemplateVhdDistributor
Nombre | Descripción | Value |
---|---|---|
type | Tipo de distribución. | "VHD" (obligatorio) |
ImageTemplateSource
Nombre | Descripción | Value |
---|---|---|
type | Establecimiento del tipo de objeto | ManagedImage PlatformImage SharedImageVersion (obligatorio) |
ImageTemplateManagedImageSource
Nombre | Descripción | Value |
---|---|---|
type | Especifica el tipo de imagen de origen con el que desea empezar. | "ManagedImage" (obligatorio) |
imageId | Identificador de recurso de ARM de la imagen administrada en la suscripción del cliente | string (obligatorio) |
ImageTemplatePlatformImageSource
Nombre | Descripción | Value |
---|---|---|
type | Especifica el tipo de imagen de origen con el que desea empezar. | "PlatformImage" (obligatorio) |
offer | Oferta de imagen de las imágenes de la Galería de Azure. | string |
planInfo | Configuración opcional del plan de compra para la imagen de plataforma. | PlatformImagePurchasePlan |
publisher | Image Publisher en imágenes de la Galería de Azure. | string |
sku | SKU de imagen de las imágenes de la Galería de Azure. | string |
version | Versión de la imagen de las imágenes de la Galería de Azure. Si se especifica "latest" aquí, la versión se evalúa cuando tiene lugar la compilación de la imagen, no cuando se envía la plantilla. Especificar "latest" podría provocar ROUNDTRIP_INCONSISTENT_PROPERTY problema que se corregirá. | string |
PlatformImagePurchasePlan
Nombre | Descripción | Valor |
---|---|---|
planName | Nombre del plan de compra. | string (obligatorio) |
planProduct | Producto del plan de compra. | string (obligatorio) |
planPublisher | Publicador del plan de compra. | string (obligatorio) |
ImageTemplateSharedImageVersionSource
Nombre | Descripción | Value |
---|---|---|
type | Especifica el tipo de imagen de origen con el que desea empezar. | "SharedImageVersion" (obligatorio) |
imageVersionId | Identificador de recurso de ARM de la versión de la imagen en la galería de imágenes compartidas | string (obligatorio) |
ImageTemplateVmProfile
Nombre | Descripción | Valor |
---|---|---|
osDiskSizeGB | Tamaño del disco del sistema operativo en GB. Omita o especifique 0 para usar el tamaño predeterminado del disco del sistema operativo de Azure. | int |
vmSize | Tamaño de la máquina virtual que se usa para compilar, personalizar y capturar imágenes. Omita o especifique una cadena vacía para usar el valor predeterminado (Standard_D1_v2 para imágenes de Gen1 y Standard_D2ds_v4 para imágenes de Gen2). | string |
vnetConfig | Configuración opcional de la red virtual que se va a usar para implementar la máquina virtual de compilación en . Omítalo si no es necesario usar ninguna red virtual específica. | VirtualNetworkConfig |
VirtualNetworkConfig
Nombre | Descripción | Valor |
---|---|---|
subnetId | Identificador de recurso de una subred preexistente. | string |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de