Creación de una imagen de máquina virtual local de Azure mediante imágenes de Azure Compute Gallery

Se aplica a: Implementaciones hiperconvergidas de Azure Local

En este artículo se describe cómo crear máquinas virtuales (VM) locales de Azure habilitadas para Azure Arc mediante imágenes de origen de Azure Compute Gallery. Puede crear imágenes de máquina virtual en la CLI de Azure mediante las instrucciones de este artículo y, a continuación, usar estas imágenes de máquina virtual para crear máquinas virtuales locales de Azure.

Prerrequisitos

  • Revise y complete los requisitos previos de la máquina virtual local de Azure.
  • Asegúrese de que la imagen usa un sistema operativo compatible con el agente de máquina conectada a Azure Arc .

    Nota:

    No todos los sistemas operativos enumerados en la página de sistemas operativos compatibles con servidores habilitados para Azure Arc son compatibles con la habilitación de Arc (gestión de invitados) en Azure Local. La administración de invitados requiere compatibilidad con Hyper-V socket (socket HV), lo que limita aún más el sistema operativo admitido.

  • Para imágenes personalizadas en Azure Compute Gallery, asegúrese de cumplir estos requisitos previos adicionales:
    • Tiene un disco duro virtual (VHD) cargado en azure Compute Gallery. Vea cómo crear una definición de imagen y una versión de imagen.
    • Si usa un disco duro virtual v2 (VHDX):
      • La imagen VHDX es de tipo Generación 2 con arranque seguro habilitado.
      • La imagen VHDX se prepara mediante sysprep /generalize /shutdown /oobe. Para obtener más información, consulte Opciones de la línea de comandos de Sysprep.

Siga estos pasos para crear una imagen de máquina virtual local de Azure mediante la CLI de Azure.

Inicio de sesión y establecimiento de la suscripción

  1. Conéctese a una máquina en la instancia local de Azure.

  2. Inicie sesión y escriba el siguiente comando:

    az login --use-device-code

  3. Establezca la suscripción.

    az account set --subscription <Subscription ID>

Exportación de la imagen al disco administrado

Para transferir la imagen de Azure Compute Gallery para que sea una imagen compatible con Azure Local, debe exportar la versión de la imagen de Azure Compute Gallery a un disco administrado.

  1. Para descargar la imagen de Azure Compute Gallery en el grupo de recursos, siga los pasos descritos en Exportación de una versión de imagen a un disco administrado. Anote el nombre del disco administrado.

Importante

La acción de exportación debe realizarse en la suscripción de origen y el grupo de recursos de origen que contienen la versión de la imagen de Azure Compute Gallery.

Al crear el disco administrado, asegúrese de que:

  • Seleccione el grupo de recursos donde existe la imagen de la galería (suscripción de origen), no el grupo de recursos de destino local de Azure.
  • El disco administrado resultante permanecerá en la suscripción de origen. Azure Local accederá más adelante a él a través de la dirección URL de SAS.

Se producirá un error al intentar crear el disco administrado en el grupo de recursos local de Azure de destino porque la versión de la imagen no existe allí.

  1. Obtenga el token de firma de acceso compartido (SAS) del disco administrado mediante el comando siguiente:

    # Variables to get SAS URL for the managed disk
$resource_group = "<Resource Group Name>"
$diskName = "<myDiskName>" # Replace 'myDiskName' with your actual disk name
$sasExpiryDuration = 100000 # Duration in seconds for SAS URL validity

    az disk grant-access --resource-group $resource_group --name $diskName --duration-in-seconds $sasExpiryDuration --query [accessSas] -o tsv

Establecimiento de parámetros

Antes de crear una imagen de máquina virtual local de Azure, debe establecer algunos parámetros.

  • Establezca la suscripción, el grupo de recursos, la ubicación, la ruta de acceso a la imagen en el recurso compartido local y el tipo de sistema operativo de la imagen. Reemplace los parámetros de < > por los valores adecuados.

    $subscription = "<Subscription ID>"
$resource_group = "<Resource group>"
$location = "<Location for your Azure Local>"
$osType = "<OS of source image>"
$imageName = "<VM image name>"
$customLocationID = "<Custom Location ID>"
$imageSourcePath = '"<SAS URL path to the source image>"'

    En la siguiente tabla se describen los parámetros:

    Parámetro Descripción
    subscription Suscripción de Azure Local que asocias con la imagen de la galería.
    resource_group Grupo de recursos de Azure Local que asocias con la imagen de la galería.
    location Ubicación de la instancia local de Azure. Por ejemplo: eastus.
    imageName Nombre de la imagen de máquina virtual creada a partir de la imagen en el recurso compartido local.
    Nota: Azure rechaza todos los nombres que contienen la palabra clave Windows.
    os-type Sistema operativo asociado a la imagen de origen. Por ejemplo, Windows o Linux.
    customLocationID Id. de ubicación personalizada para la instancia local de Azure.
    imageSourcePath Ruta de acceso a la dirección URL de SAS del disco administrado de la imagen de la galería.

    Esta es una salida de ejemplo:

    PS C:\Users\azcli> $subscription = "<Subscription ID>"
PS C:\Users\azcli> $resource_group = "mylocal-rg"
PS C:\Users\azcli> $location = "eastus"
PS C:\Users\azcli> $osType = "Windows"
PS C:\Users\azcli> $imageName = "mylocal-computegalleryimage"
PS C:\Users\azcli> $customLocationID = "/subscriptions/$subscription/resourcegroups/$resource_group/providers/microsoft.extendedlocation/customlocations/$customLocationName"
PS C:\Users\azcli> $imageSourcePath = '"https://EXAMPLE.blob.storage.azure.net/EXAMPLE/abcd<sas-token>"'

Creación de una imagen de máquina virtual local de Azure

Para crear una imagen de máquina virtual local de Azure, siga estos pasos:

  1. Seleccione una ubicación personalizada para implementar la imagen de máquina virtual. La ubicación personalizada debe corresponder a la ubicación personalizada de Azure Local. Obtenga el identificador de ubicación personalizado de Azure Local. Ejecute el siguiente comando:

    $customLocationID=(az customlocation show --resource-group $resource_group --name "<custom location name for your Azure Local>" --query id -o tsv)

  2. Cree la imagen de máquina virtual a partir de una imagen de galería especificada. Asegúrese de especificar la oferta, el publicador, la unidad de mantenimiento de existencias (SKU) y la versión de la imagen.

    az stack-hci-vm image create --subscription $subscription --resource-group $resource_Group --custom-location $customLocationID --location $location --name $imageName --os-type $osType --image-path $imageSourcePath

    Un trabajo de implementación se inicia para la imagen de máquina virtual y tarda unos minutos en completarse. El tiempo de descarga de la imagen depende del tamaño de la imagen y del ancho de banda de red disponible para la descarga.

    Esta es una salida de ejemplo:

    { 
  "extendedLocation": { 
    "name": "/subscriptions/<Subscription ID>/resourceGroups/mylocal-rg/providers/Microsoft.ExtendedLocation/customLocations/mylocal-cl", 
    "type": "CustomLocation" 
  }, 
  "id": "/subscriptions/<Subscription ID>/resourceGroups/mylocal-rg/providers/Microsoft.AzureStackHCI/galleryImages/mylocal-image", 
  "location": "eastus", 
  "name": "mylocal-image", 
  "properties": { 
    "cloudInitDataSource": null, 
    "containerId": "/subscriptions/<Subscription ID>/resourceGroups/mylocal-rg/providers/Microsoft.AzureStackHCI/storageContainers/mylocal-storagepath", 
    "hyperVGeneration": null, 
    "identifier": null, 
    "imagePath": null, 
    "osType": "Windows", 
    "provisioningState": "Succeeded", 
    "sourceVirtualMachineId": null, 
    "status": { 
      "downloadStatus": { 
        "downloadSizeInMb": 11482 
      }, 
      "errorCode": "", 
      "errorMessage": "", 
      "progressPercentage": 100, 
      "provisioningStatus": { 
        "operationId": "00000000-0000-0000-0000-000000000000*0000000000000000000000000000000000000000000000000000000000000000", 
        "status": "Succeeded" 
      } 
    }, 
    "version": { 
      "name": null, 
      "properties": { 
        "storageProfile": { 
          "osDiskImage": { 
            "sizeInMb": 130050 
          } 
        } 
      } 
    }, 
    "vmImageRepositoryCredentials": null 
  }, 
  "resourceGroup": "mylocal-rg", 
  "systemData": { 
    "createdAt": "2025-05-21T00:44:16.385633+00:00", 
    "createdBy": "[email protected]", 
    "createdByType": "User", 
    "lastModifiedAt": "2025-05-21T00:48:34.016113+00:00", 
    "lastModifiedBy": "00000000-0000-0000-0000-000000000000", 
    "lastModifiedByType": "Application" 
  }, 
  "tags": null, 
  "type": "microsoft.azurestackhci/galleryimages" 
}

  3. Para evitar costos asociados a un disco, asegúrese de eliminar el disco administrado que se usó para crear esta imagen mediante el siguiente comando:

    az disk delete --name $diskName --resource-group $resourceGroupName

Pasos siguientes

  • Last updated on