Creación de una definición de imagen y una versión de imagen

Artigo
08/27/2024

Precaución

En este artículo se hace referencia a CentOS, una distribución de Linux con un estado de finalización del servicio (EOL). Tenga en cuenta su uso y planifique en consecuencia. Para más información, consulte la Guía de fin de ciclo de vida de CentOS.

Una instancia de Azure Compute Gallery (anteriormente denominada Shared Image Gallery) simplifica el uso compartido de imágenes personalizadas en la organización. Las imágenes personalizadas son como las imágenes de Marketplace, pero las puede crear usted mismo. Las imágenes se pueden crear desde una máquina virtual, un disco duro virtual, una instantánea, una imagen administrada u otra versión de imagen.

Azure Compute Gallery le permite compartir las imágenes de máquina virtual personalizadas con otros usuarios de la organización, ya sea dentro o entre regiones, dentro de un inquilino de Microsoft Entra o, públicamente, mediante una galería de la comunidad. Elija las imágenes que desea compartir, qué regiones desea que estén disponibles en ellas y con quién desea compartirlas. Puede crear varias galerías que le permitirán agrupar las imágenes de forma lógica. Muchas de las nuevas características, como ARM64, Redes aceleradas, TrustedVM, etc., solo se admiten mediante Azure Compute Gallery y no están disponibles para imágenes administradas.

La característica Azure Compute Gallery tiene varios tipos de recursos:

Recurso	Descripción
Origen de imagen	Se trata de un recurso que se puede usar para crear una versión de imagen en una galería. Un origen de imagen puede ser una máquina virtual de Azure existente, ya sea generalizada o especializada, una imagen administrada, una instantánea o una versión de imagen de otra galería.
Galería	Al igual que Azure Marketplace, una galería es un repositorio para administrar y compartir imágenes y aplicaciones de máquina virtual, pero con control sobre quién tiene acceso.
Definición de la imagen	Las definiciones de imagen se crean dentro de una galería y contienen información sobre la imagen y los requisitos para usarla internamente. Esto incluye si la imagen es Windows o Linux, notas de la versión y los requisitos de memoria mínima y máxima. Es una definición de un tipo de imagen.
Versión de la imagen	Una versión de la imagen es lo que se usa para crear una VM cuando se usa una galería. Puede tener varias versiones de una imagen según sea necesario para su entorno. Al igual que una imagen administrada, cuando se usa una versión de la imagen para crear una VM, la versión de la imagen se usa para crear nuevos discos para la VM. Las versiones de las imágenes pueden usarse varias veces.

Antes de empezar

Para completar este artículo, debe tener una instancia de Azure Compute Gallery existente y un origen para la imagen disponible en Azure. Los orígenes de imagen pueden ser los siguientes:

Una máquina virtual de la suscripción. Puede capturar una imagen a partir de máquinas virtuales especializadas y generalizadas.
Una imagen administrada.
Discos de datos y sistema operativo administrados.
Discos de datos y sistema operativo como discos duros virtuales en una cuenta de almacenamiento.
Otras versiones de imagen en la misma galería u otra galería de la misma suscripción.

Si la imagen va a contener discos de datos, el tamaño del disco de datos no puede ser mayor de 1 TB.

Los nombres de las definiciones de imagen pueden estar formados por letras mayúsculas o minúsculas, números, puntos y guiones. Para más información sobre los valores que se pueden especificar para una definición de imagen, consulte Definiciones de imagen.

Los caracteres permitidos para la versión de la imagen son números y puntos. Los números deben estar dentro del rango de un entero de 32 bits. Formato: VersiónPrincipal.VersiónSecundaria.Revisión.

Al trabajar en este artículo, reemplace los nombres de los recursos y de la máquina virtual cuando proceda.

Para obtener imágenes generalizadas, consulte la guía específica del sistema operativo antes de capturar la imagen:

Linux
- Pasos genéricos
- CentOS
- Debian
- Flatcar
- FreeBSD
- Oracle Linux
- OpenBSD
- Red Hat
- SUSE
- Ubuntu
Windows

Si tiene pensado ejecutar Sysprep antes de cargar el disco duro virtual (VHD) en Azure por primera vez, asegúrese de que tiene preparada la máquina virtual.

Galería de la comunidad

Si va a compartir las imágenes mediante una galería de la comunidad, asegúrese de crear la galería, las definiciones de imágenes y las versiones de imagen en la misma región.

Cuando los usuarios buscan imágenes en la galería de la comunidad, solo se muestra la última versión de una imagen.

Importante

La información de las definiciones de imagen estará disponible públicamente, por ejemplo, la que proporcione para Publicador, Oferta y SKU.

Crear una imagen

Elija una opción a continuación para crear la definición y la versión de la imagen:

Para crear una imagen a partir de una máquina virtual en el portal, consulte Captura de una imagen de una máquina virtual.

Para crear una imagen con un origen distinto de una máquina virtual, siga estos pasos.

Vaya a Azure Portal y busque y seleccione Azure Compute Gallery.
Seleccione la galería que desea usar en la lista.
En la página de la galería, seleccione Agregar en la parte superior de la página y, después, seleccione VM image definition (Definición de imagen de máquina virtual) en la lista desplegable.
En la página Add new image definition to Azure Compute Gallery (Agregar nueva definición de imagen a Azure Compute Gallery), en la pestaña Conceptos básicos, seleccione una Región.
En Nombre de definición de la imagen, escriba un nombre como myImageDefinition.
En Sistema operativo, seleccione la opción correcta en función de su origen.
En Generación de VM, seleccione la opción en función de su origen. En la mayoría de los casos, será Gen 1. Para obtener más información, consulte Compatibilidad para máquinas virtuales de generación 2 en Azure.
En Estado del sistema operativo, seleccione la opción en función de su origen. Para más información, consulte Generalizada o Especializada.
En Editor, escriba un nombre único, como miEditor.
En Oferta, escriba un nombre único como miOferta.
En SKU, escriba un nombre único como miSKU.
En la parte inferior de la página, seleccione Revisar y crear.
Después de que la definición de imagen pasa la validación, seleccione Crear.
Cuando la implementación finalice, seleccione Ir al recurso.
En la página de la definición de la imagen, en la pestaña Introducción, seleccione Crear una versión.
En Región, seleccione la región donde quiera que se cree la imagen. En algunos casos, el origen debe estar en la misma región en que se crea la imagen. Si no ve el origen en las lista desplegables posteriores, intente cambiar la región de la imagen. Siempre puede replicar la imagen en otras regiones más adelante.
En Número de versión, escriba un número como 1.0.0. El nombre de la versión de la imagen debe seguir el formato principal. secundaria. revisión con números enteros.

En Origen, seleccione el tipo de archivo que está usando como origen en la lista desplegable. Consulte la tabla siguiente para obtener detalles específicos de cada tipo de origen.

Origen	Otros campos
Discos o instantáneas	- En Disco del SO, seleccione el disco o la instantánea correspondiente en la lista desplegable. - Para agregar un disco de datos, escriba el número de unidad lógica (LUN) y, a continuación, seleccione el disco de datos correspondiente en la lista desplegable.
Versión de la imagen	- Seleccione la galería de origen en la lista desplegable. - Seleccione la definición de imagen correcta en la lista desplegable. - Seleccione la versión de la imagen existente que quiere usar en la lista desplegable.
Imagen administrada	Seleccione la imagen de origen en la lista desplegable. La imagen administrada debe estar en la misma región que eligió en Detalles de la instancia.
VHD en una cuenta de almacenamiento	Seleccione Examinar para elegir la cuenta de almacenamiento para el VHD.

En Excluir de la versión más reciente, deje el valor predeterminado No a menos que no desee que esta versión se use al crear una máquina virtual mediante latest en lugar de un número de versión.
En Fecha de finalización del ciclo de vida, seleccione la fecha del calendario en que considere que esta versión debe dejar de usarse.
En la pestaña Replicación, seleccione el tipo de almacenamiento en la lista desplegable.
Establezca el valor de Número de réplicas predeterminado; puede reemplazarlo para cada una de las regiones que agregue.
Debe replicar en la región de origen, por lo que la primera réplica de la lista será en la región donde creó la imagen. Para agregar más réplicas, seleccione la región en la lista desplegable y ajuste el número de réplicas según sea necesario.
Cuando haya terminado, seleccione Revisar y crear. Azure validará la configuración.
Una vez que la versión de la imagen supere la validación, seleccione Crear.
Cuando la implementación finalice, seleccione Ir al recurso.

La imagen puede tardar un rato en replicarse en todas las regiones de destino.

También puede capturar una máquina virtual existente como imagen desde el portal. Para obtener más información, consulte Creación de una imagen de una máquina virtual en el portal.

Las definiciones de imagen crean una agrupación lógica de imágenes. Estas se usan para administrar la información sobre las versiones de la imagen que se crean dentro de ellas.

Cree una definición de imagen en una galería mediante az sig image-definition create. Asegúrese de que la definición de la imagen sea del tipo correcto. Si ha generalizado la máquina virtual (con waagent -deprovision para Linux o Sysprep para Windows), debe crear una definición de imagen generalizada mediante --os-state generalized. Si quiere usar la máquina virtual sin quitar las cuentas de usuario existentes, cree una definición de imagen especializada mediante --os-state specialized.

Para más información sobre los parámetros que se pueden especificar para una definición de imagen, consulte Definiciones de imagen.

En este ejemplo, la definición de la imagen se denomina myImageDefinition y es para una imagen del sistema operativo Linux especializada. Para crear una definición para las imágenes que usan un sistema operativo Windows, utilice --os-type Windows.

az sig image-definition create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --publisher myPublisher \
   --offer myOffer \
   --sku mySKU \
   --os-type Linux \
   --os-state specialized

Nota:

Para las definiciones de imagen que contendrán imágenes descendientes de imágenes de Marketplace de terceros, la información del plan debe coincidir exactamente con la información del plan de la imagen de terceros. Para incluir la información del plan en la definición de imagen, agregue --plan-name, --plan-producty --plan-publisher al crearla.

Creación de la versión de la imagen

Cree una versión de imagen con az sig image version create.

La sintaxis para crear la imagen cambiará, en función de lo que use como origen. Puede mezclar los tipos de origen, siempre y cuando solo tenga un origen del sistema operativo. También puede tener orígenes diferentes para cada disco de datos.

Origen	Conjunto de parámetros
Disco del sistema operativo:
Máquina virtual con el identificador de máquina virtual	`--managed-image <Resource ID of the VM>`
Imagen administrada u otra versión de imagen	`--managed-image <Resource ID of the managed image or image version`
Instantánea o disco administrado	`--os-snapshot <Resource ID of the snapshot or managed disk>`
VHD en una cuenta de almacenamiento	`--os-vhd-uri <URI> --os-vhd-storage-account <storage account name>`.
Disco de datos:
Instantánea o disco administrado	`--data-snapshots <Resource ID of the snapshot or managed disk> --data-snapshot-luns <LUN number>`
VHD en una cuenta de almacenamiento	`--data-vhds-sa <storageaccountname> --data-vhds-uris <URI> --data-vhds-luns <LUN number>`

Para obtener ejemplos detallados de cómo especificar diferentes orígenes para la imagen, consulte los ejemplos de az sig image-version create.

En el siguiente ejemplo, vamos a crear una imagen a partir de una máquina virtual. La versión de la imagen es la 1.0.0 y vamos a crear dos réplicas en la región Centro-oeste de EE. UU. , una réplica en la región Centro-sur de EE. UU. y una réplica en la región Este de EE. UU. 2 mediante almacenamiento con redundancia de zona. Las regiones de replicación deben incluir la región donde se encuentra la máquina virtual de origen.

Se recomienda detener o desasignar la máquina virtual antes de crear una imagen.

Reemplace el valor de --managed-image en este ejemplo por el identificador de la máquina virtual.

az sig image-version create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --target-regions "westcentralus" "southcentralus=1" "eastus=1=standard_zrs" \
   --replica-count 2 \
   --managed-image "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Nota:

Deberá esperar a que la versión de la imagen termine de compilarse y replicarse por completo antes de poder usar la misma imagen administrada para crear otra versión de la imagen.

También puede almacenar la imagen en almacenamiento Premium agregando --storage-account-type premium_lrs, o en el almacenamiento con redundancia de zona agregando --storage-account-type standard_zrs al crear la versión de la imagen.

Las definiciones de imagen crean una agrupación lógica de imágenes. Al crear la definición de la imagen, asegúrese de tener toda la información correcta. Si no ha generalizado la máquina virtual de origen, debe crear una definición de imagen mediante -OsState generalized. Si no ha generalizado el origen, cree una definición de imagen mediante -OsState specialized.

Para más información sobre los valores que se pueden especificar para una definición de imagen, consulte Definiciones de imagen.

Cree la definición de imagen mediante New-AzGalleryImageDefinition.

En este ejemplo, la definición de la imagen se denomina myImageDefinition y es para una máquina virtual especializada que ejecuta Windows. Para crear una definición para las imágenes que usan Linux, use -OsType Linux.

$imageDefinition = New-AzGalleryImageDefinition `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -Name 'myImageDefinition' `
   -OsState specialized `
   -OsType Windows `
   -Publisher 'myPublisher' `
   -Offer 'myOffer' `
   -Sku 'mySKU'

Nota:

Para las definiciones de imagen que contendrán imágenes descendientes de imágenes de terceros, la información del plan debe coincidir exactamente con la información del plan de la imagen de terceros. Para incluir la información del plan en la definición de imagen, agregue -PurchasePlanName, -PurchasePlanProducty -PurchasePlanPublisher al crearla.

Creación de la versión de una imagen

Cree una versión de la imagen mediante New-AzGalleryImageVersion.

La sintaxis para crear la imagen cambiará, en función de lo que use como origen.

Origen	Conjunto de parámetros
Disco de SO
Máquina virtual con el identificador de máquina virtual	`-SourceImageId <Resource ID of the VM>`
Imagen administrada u otra versión de imagen	`-SourceImageId <Resource ID of the managed image or image version`
Instantánea o disco administrado	`-OSDiskImage <Resource ID of the snapshot or managed disk>`
Disco de datos
Instantánea o disco administrado	`-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }`

En el siguiente ejemplo, vamos a crear una versión de imagen a partir de una máquina virtual. Se recomienda detener o desasignar la máquina virtual antes de crear una imagen mediante Stop-AzVM.

En este ejemplo, la versión de imagen es 1.0.0 y se replica en los centros de datos Centro-oeste de EE. UU. y Centro-sur de EE. UU.. Al elegir las regiones de destino de la replicación, recuerde que también debe incluir la región de origen como destino de la replicación.

   $region1 = @{Name='South Central US';ReplicaCount=1}
   $region2 = @{Name='East US';ReplicaCount=2}
   $targetRegions = @($region1,$region2)

$job = $imageVersion = New-AzGalleryImageVersion `
   -GalleryImageDefinitionName $imageDefinition.Name`
   -GalleryImageVersionName '1.0.0' `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -TargetRegion $targetRegions  `
   -SourceImageId $sourceVm.Id.ToString() `
   -PublishingProfileEndOfLifeDate '2020-12-01' `  
   -asJob

Puede tardar un rato en replicar la imagen en todas las regiones de destino, por lo que creamos un trabajo para que pueda hacer un seguimiento del progreso. Para ver el progreso del trabajo, escriba $job.State.

$job.State

Nota:

Deberá esperar a que la versión de la imagen termine de compilarse y replicarse por completo antes de poder usar la misma imagen administrada para crear otra versión de la imagen.

También puede almacenar la imagen en almacenamiento Premium agregando -StorageAccountType Premium_LRS, o en el almacenamiento con redundancia de zona agregando -StorageAccountType Standard_ZRS al crear la versión de la imagen.

Cree una definición de imagen mediante la API de REST

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}?api-version=2019-12-01

{
    "location": "eastus",
    "properties": {
        "hyperVGeneration": "V1",
        "identifier": {
            "offer": "myOffer",
            "publisher": "myPublisher",
            "sku": "mySKU"
        },
        "osState": "Specialized",
        "osType": "Linux",
    },
}

Cree una versión de imagen mediante la API de REST. En este ejemplo, vamos a crear una versión de imagen a partir de una máquina virtual. Para usar otro origen, pase el identificador de recurso para el origen (por ejemplo, pase el identificador de la instantánea de disco del sistema operativo).

# @name imageVersion
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}/versions/{galleryImageVersionName}?api-version=2019-12-01

{
    "location": "{region}",
    "properties": {
        "publishingProfile": {
            "endOfLifeDate": "2024-12-02T00:00:00+00:00",
            "replicaCount": 1,
            "storageAccountType": "Standard_ZRS",
            "targetRegions": [
                {
                    "name": "eastus",
                    "regionalReplicaCount": 2,
                    "storageAccountType": "Standard_LRS",
                },
                {
                    "name": "westus2",
                }
            ]
        },
        "storageProfile": {
            "source": {
                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}"
            }
        }
    }
}

Creación de una imagen en un inquilino mediante la imagen de origen en otro inquilino

En la suscripción donde existe la imagen de origen, conceda permisos de lector al usuario. Una vez que el usuario tiene permiso de lector en la imagen de origen, inicie sesión en ambas cuentas (origen y destino).

Necesitará el elemento tenantID de la imagen de origen, subscriptionID para la suscripción donde se almacenará la nueva imagen (destino) y el elemento resourceID de la imagen de origen. Además, debe asegurarse de que la región o réplica de la imagen de origen y la región de destino sean las mismas.

CLI
PowerShell

# Set some variables
tenantID="<tenant ID for the source image>"
subID="<subscription ID where the image will be creted>"
sourceImageID="<resource ID of the source image>"

# Login to the subscription where the new image will be created
az login

# Log in to the tenant where the source image is available
az login --tenant $tenantID

# Log back in to the subscription where the image will be created and ensure subscription context is set
az login
az account set --subscription $subID

# Create the image
az sig image-version create `
   --gallery-image-definition myImageDef `
   --gallery-image-version 1.0.0 `
   --gallery-name myGallery `
   --resource-group myResourceGroup `
   --image-version $sourceImageID
   --location myLocation

# Set variables 
$targetSubID = "<subscription ID for the target>"
$sourceTenantID = "<tenant ID where for the source image>"
$sourceImageID = "<resource ID of the source image>"

# Login to the tenant where the source image is published
Connect-AzAccount -Tenant $sourceTenantID -UseDeviceAuthentication 

# Login to the subscription where the new image will be created and set the context
Connect-AzAccount -UseDeviceAuthentication -Subscription $targetSubID
Set-AzContext -Subscription $targetSubID 

# Create the image version from another image version in a different tenant
New-AzGalleryImageVersion `
   -ResourceGroupName myResourceGroup -GalleryName myGallery `
   -GalleryImageDefinitionName myImageDef `
   -Location "West US 2" `
   -Name 1.0.0 `
   -SourceImageId $sourceImageID

Pasos siguientes

Para saber cómo proporcionar información del plan de compra, consulte Indicación de la información del plan de compra de Azure Marketplace al crear imágenes.

Compartir por

Creación de una definición de imagen y una versión de imagen

Antes de empezar

Galería de la comunidad

Crear una imagen

Creación de una imagen en un inquilino mediante la imagen de origen en otro inquilino

Pasos siguientes

Comentarios

Recursos adicionais