Creación de una definición de imagen y una versión de 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.

1. Vaya al portal Azure y, a continuación, busque y seleccione Azure Compute Gallery.

2. Seleccione la galería que desea usar en la lista.

3. 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.

4. en la página Agregar nueva definición de imagen a la Galería de Imágenes de Azure, en la pestaña Básicos, seleccione una Región.

5. En Nombre de definición de la imagen, escriba un nombre como myImageDefinition.

6. En Sistema operativo, seleccione la opción correcta en función de su origen.

7. 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.

8. En Estado del sistema operativo, seleccione la opción en función de su origen. Para más información, consulte Generalizada o Especializada.

9. Para Publisher, escriba un nombre único como myPublisher.

10. En Oferta, escriba un nombre único como miOferta.

11. En SKU, escriba un nombre único como miSKU.

12. En la parte inferior de la página, seleccione Revisar y crear.

13. Después de que la definición de imagen pasa la validación, seleccione Crear.

14. Cuando la implementación finalice, seleccione Ir al recurso.

15. En la página de la definición de la imagen, en la pestaña Introducción, seleccione Crear una versión.

16. 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.

17. 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 mayor.menor.parche con números enteros.

18. 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.

19. 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.

20. 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.

21. En la pestaña Replicación, seleccione el tipo de almacenamiento en la lista desplegable.

22. Establezca el valor de Número de réplicas predeterminado; puede reemplazarlo para cada una de las regiones que agregue.

23. 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.

24. Cuando haya terminado, seleccione Revisar y crear. Azure validará la configuración.

25. Una vez que la versión de la imagen supere la validación, seleccione Crear.

26. 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.

Para crear una imagen mediante el CLI de Azure, primero debe crear una definición de imagen. 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 has generalizado la máquina virtual (usando waagent -deprovision para Linux o Sysprep para Windows), debes 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 de imágenes mediante un sistema operativo de Windows, use --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

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.

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 --virtual-machine 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 \
   --virtual-machine "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Para crear una imagen mediante PowerShell, primero debe crear una definición de 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 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 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'

Crea una versión de 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.

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 hemos creado una tarea para realizar un seguimiento del progreso. Para ver el progreso del trabajo, escriba $job.State.

$job.State

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}"
            }
        }
    }
}

Utilice la CLI de Azure para crear una versión de imagen en una entidad usando la versión de imagen de origen en otra entidad.

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

# Sign in to the subscription where the new image version will be created
az login

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

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

# Create the image version from the source image version
az sig image-version create \
   --gallery-image-definition myImageDef \
   --gallery-image-version 1.0.0 \
   --gallery-name myGallery \
   --resource-group myResourceGroup \
   --image-version $sourceImageVersionID \
   --location myLocation

Use PowerShell para crear una versión de imagen en un inquilino utilizando la versión de imagen de origen en otro inquilino.

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

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

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

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