Creación de una imagen de máquina virtual de Azure Stack HCI mediante imágenes en un recurso compartido local

• Asegúrese de revisar y completar los requisitos previos.

• Para imágenes personalizadas en un recurso compartido local en Azure Stack HCI, tendrá los siguientes requisitos previos adicionales:

  • Debe tener un VHD/VHDX cargado en un recurso compartido local en el clúster de Azure Stack HCI.
  • La imagen VHDX debe ser de tipo Gen 2 y arranque seguro habilitado.
  • La imagen VHDX debe estar preparada mediante sysprep /generalize /shutdown /oobe. Para obtener más información, consulte Opciones de la línea de comandos de Sysprep.
  • La imagen debe residir en un volumen compartido de clúster disponible para todos los servidores del clúster. Se admiten los sistemas operativos Windows y Linux.

• Si usa un cliente para conectarse al clúster de Azure Stack HCI, consulte Conexión a Azure Stack HCI a través del cliente de la CLI de Azure.

• Asegúrese de revisar y completar los requisitos previos.

• Para imágenes personalizadas en un recurso compartido local en Azure Stack HCI, tendrá los siguientes requisitos previos adicionales:

  • Debe tener un VHD/VHDX cargado en un recurso compartido local en el clúster de Azure Stack HCI.
  • La imagen VHDX debe ser de tipo Gen 2 y arranque seguro habilitado.
  • La imagen VHDX debe estar preparada mediante sysprep /generalize /shutdown /oobe. Para obtener más información, consulte Opciones de la línea de comandos de Sysprep.
  • La imagen debe residir en un volumen compartido de clúster disponible para todos los servidores del clúster. Se admiten los sistemas operativos Windows y Linux.

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

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

1. Conéctese a un servidor en el sistema de Azure Stack HCI.

2. Inicia sesión. Escriba:

   az login --use-device-code
   

3. Establezca la suscripción.

   az account set --subscription <Subscription ID>
   

Configure algunos parámetros.

1. Establezca la suscripción, el grupo de recursos, la ubicación, el tipo de sistema operativo para la imagen. Reemplace los parámetros de < > por los valores adecuados.

   $subscription = "<Subscription ID>"
   $resource_group = "<Resource group>"
   $location = "<Location for your Azure Stack HCI cluster>"
   $imageName = <VM image name>
   $imageSourcePath = <path to the source image>
   $osType = "<OS of source image>"
   

   Los parámetros se describen en la tabla siguiente:

   Parámetro	Descripción
   subscription	Grupo de recursos para el clúster de Azure Stack HCI que se asocia a esta imagen.
   resource_group	Grupo de recursos para el clúster de Azure Stack HCI que se asocia a esta imagen.
   location	Ubicación del clúster de Azure Stack HCI. Por ejemplo, podría ser eastus.
   image-path	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.
   name	Ruta de acceso a la imagen de la galería de origen (solo VHDX) en el clúster. Por ejemplo, C:\OSImages\winos.vhdx. Consulte los requisitos previos de la imagen de origen.
   os-type	Sistema operativo asociado a la imagen de origen. Puede ser Windows o Linux.

   Este es una salida de ejemplo:

   PS C:\Users\azcli> $subscription = "<Subscription ID>"
   PS C:\Users\azcli> $resource_group = "myhci-rg"
   PS C:\Users\azcli> $location = "eastus"
   PS C:\Users\azcli> $osType = "Windows"
   PS C:\ClusterStorage\Volume1> $imageName = "myhci-localimage"
   PS C:\ClusterStorage\Volume1> $imageSourcePath = "C:\ClusterStorage\Volume1\Windows_K8s_17763.2928.220505-1621_202205101158.vhdx"
   

Creación de una imagen de máquina virtual a partir de una imagen en un recurso compartido local

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 del clúster de Azure Stack HCI. Obtenga el identificador de ubicación personalizado para el clúster de Azure Stack HCI. Ejecute el siguiente comando:

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

2. Cree la imagen de máquina virtual a partir de una imagen especificada en un recurso compartido local en el clúster de Azure Stack HCI.

   az stack-hci-vm image create --subscription $subscription --resource-group $resource_group --custom-location $customLocationID --location $location --image-path $ImageSourcePath --name $ImageName --os-type $osType --storage-path-id $storagepathid
   
   

   Se inicia un trabajo de implementación para la imagen de máquina virtual.

   En este ejemplo, la ruta de acceso de almacenamiento se especificó con la --storage-path-id marca y que se ha asegurado de que los datos de la carga de trabajo (incluida la máquina virtual, la imagen de máquina virtual, el disco de datos que no es del sistema operativo) se colocan en la ruta de acceso de almacenamiento especificada.

   Si no se especifica la marca, los datos de carga de trabajo se colocan automáticamente en una ruta de acceso de almacenamiento de alta disponibilidad.

La implementación de la imagen tarda unos minutos en completarse. El tiempo necesario para descargar la imagen depende del tamaño de la imagen en el recurso compartido local y del ancho de banda de red disponible para la descarga.

Este es una salida de ejemplo:

PS C:\Users\azcli> $customLocationID=(az customlocation show --resource-group $resource_group --name "myhci-cl" --query id -o tsv)
PS C:\Users\azcli> az stack-hci-vm image create --subscription $subscription --resource-group $resource_group --custom-location $customLocationID --location $location --image-path $ImageSourcePath --name $ImageName --os-type $osType --storage-path-id $storagepathid
type="CustomLocation" --location $Location --name $mktplaceImage --os-type $osType --image-path $mktImageSourcePath
Command group 'azurestackhci' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
{
  "extendedLocation": {
    "name": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.ExtendedLocation/customLocations/myhci-cl",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/myhci-localimage",
  "location": "eastus",
  "name": "myhci-localimage",
  "properties": {
    "identifier": null,
    "imagePath": null,
    "osType": "Windows",
    "provisioningState": "Succeeded",
    "status": {
      "downloadStatus": {},
      "progressPercentage": 100,
      "provisioningStatus": {
        "operationId": "82f58893-b252-43db-97a9-258f6f7831d9*43114797B86E6D2B28C4B52B02302C81C889DABDD9D890F993665E223A5947C3",
        "status": "Succeeded"
      }
    },
    "storagepathId": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/storagecontainers/myhci-storagepath",
    "version": {
      "name": null,
      "properties": {
        "storageProfile": {
          "osDiskImage": {}
        }
      }
    }
  },
  "resourceGroup": "myhci-rg",
  "systemData": {
    "createdAt": "2023-11-02T06:15:10.450908+00:00",
    "createdBy": "guspinto@contoso.com",
    "createdByType": "User",
    "lastModifiedAt": "2023-11-02T06:15:56.689323+00:00",
    "lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05",
    "lastModifiedByType": "Application"
  },
  "tags": null,
  "type": "microsoft.azurestackhci/galleryimages"
}

PS C:\Users\azcli>

Para crear una imagen de máquina virtual, descargue una imagen que resida en un recurso compartido local en el clúster de Azure Stack HCI y, a continuación, use esa imagen de máquina virtual para implementar una máquina virtual.

En Azure Portal del recurso de clúster de Azure Stack HCI, realice los pasos siguientes:

1. Vaya a Imágenes de máquina virtual de recursos>.

2. Seleccione + Agregar imagen de máquina virtual y, en la lista desplegable, seleccione Agregar imagen de máquina virtual desde un recurso compartido local.

   

3. En la página Crear una imagen , en la pestaña Aspectos básicos , escriba la siguiente información:

   1. Suscripción. Seleccione una suscripción para asociarla a la imagen de máquina virtual.

   2. Grupo de recursos. Cree nuevo o seleccione un grupo de recursos existente que asocie a la imagen de máquina virtual.

   3. Guarde la imagen como. Escriba un nombre para la imagen de máquina virtual.

   4. Ubicación personalizada. Seleccione una ubicación personalizada para implementar la imagen de máquina virtual. La ubicación personalizada debe corresponder a la ubicación personalizada del clúster de Azure Stack HCI.

   5. Tipo de sistema operativo. Seleccione el sistema operativo de la imagen como Windows o Linux. Este es el sistema operativo asociado a la imagen de la cuenta de almacenamiento.

   6. Generación de máquinas virtuales. Seleccione la generación de la imagen.

   7. Origen. El origen de la imagen debe ser recurso compartido de archivos local y se rellena automáticamente.

   8. Ruta de acceso del recurso compartido de archivos local. Especifique la ruta de acceso del recurso compartido local para la imagen de origen en el clúster de HCI.

   9. Ruta de acceso de almacenamiento. Seleccione la ruta de acceso de almacenamiento de la imagen de máquina virtual. Seleccione Elegir automáticamente para tener una ruta de acceso de almacenamiento con alta disponibilidad seleccionada automáticamente. Seleccione Elegir manualmente para especificar una ruta de acceso de almacenamiento para almacenar imágenes de máquina virtual y archivos de configuración en el clúster de Azure Stack HCI. En este caso, asegúrese de que la ruta de acceso de almacenamiento especificada tenga suficiente espacio de almacenamiento.

4. Seleccione Revisar y crear para crear la imagen de máquina virtual.

   

5. Los parámetros de entrada se validan. Si las validaciones se realizan correctamente, puede revisar los detalles de la imagen de máquina virtual y seleccionar Crear.

   

   Se inicia un trabajo de implementación de plantillas de Azure Resource Manager para la imagen de máquina virtual. La implementación de la imagen tarda unos minutos en completarse. El tiempo necesario para descargar la imagen depende del tamaño de la imagen personalizada y del ancho de banda de red disponible para la descarga.

   Puede realizar un seguimiento de la implementación de imágenes en la cuadrícula de imágenes de máquina virtual. Puede ver la lista de las imágenes de máquina virtual que ya están descargadas y las que se están descargando en el clúster.

6. Una vez completada la descarga de la imagen, la imagen de máquina virtual aparece en la lista de imágenes y el estado se muestra como Disponible. Para ver más detalles de cualquier imagen, seleccione el nombre de la imagen de máquina virtual en la lista de imágenes de máquina virtual.

Siga estos pasos para enumerar la imagen de máquina virtual mediante la CLI de Azure.

1. Ejecuta PowerShell como administrador.

2. Configure algunos parámetros.

   $subscription = "<Subscription ID associated with your cluster>"
   $resource_group = "<Resource group name for your cluster>"
   

3. Enumere todas las imágenes de máquina virtual asociadas al clúster. Ejecute el siguiente comando:

   az stack-hci-vm image list --subscription $subscription --resource-group $resource_group
   

   En función del comando usado, se muestra un conjunto correspondiente de imágenes asociadas al clúster de Azure Stack HCI.

   • Si especifica solo la suscripción, el comando muestra todas las imágenes de la suscripción.
   • Si especifica tanto la suscripción como el grupo de recursos, el comando muestra todas las imágenes del grupo de recursos.

   Estas imágenes incluyen:

   • Imágenes de máquina virtual de imágenes de Marketplace.
   • Imágenes personalizadas que residen en su cuenta de Azure Storage o están en un recurso compartido local en el clúster o en un cliente conectado al clúster.

Esta es una salida de ejemplo.

PS C:\Users\azcli> az stack-hci-vm image list --subscription "<Subscription ID>" --resource-group "myhci-rg"
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
[
  {
    "extendedLocation": {
      "name": "/subscriptions/<Subscription ID>/resourcegroups/myhci-rg/providers/microsoft.extendedlocation/customlocations/myhci-cl",
      "type": "CustomLocation"
    },
    "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/microsoft.azurestackhci/marketplacegalleryimages/w
inServer2022Az-01",
    "location": "eastus",
    "name": "winServer2022Az-01",
    "properties": {
      "hyperVGeneration": "V2",
      "identifier": {
        "offer": "windowsserver",
        "publisher": "microsoftwindowsserver",
        "sku": "2022-datacenter-azure-edition-core"
      },
      "imagePath": null,
      "osType": "Windows",
      "provisioningState": "Succeeded",
      "status": {
        "downloadStatus": {
          "downloadSizeInMB": 6710
        },
        "progressPercentage": 100,
        "provisioningStatus": {
          "operationId": "19742d69-4a00-4086-8f17-4dc1f7ee6681*E1E9889F0D1840B93150BD74D428EAE483CB67B0904F9A198C161AD471F670ED",
          "status": "Succeeded"
        }
      },
      "storagepathId": null,
      "version": {
        "name": "20348.2031.231006",
        "properties": {
          "storageProfile": {
            "osDiskImage": {
              "sizeInMB": 130050
            }
          }
        }
      }
    },
    "resourceGroup": "myhci-rg",
    "systemData": {
      "createdAt": "2023-10-30T21:44:53.020512+00:00",
      "createdBy": "guspinto@contoso.com",
      "createdByType": "User",
      "lastModifiedAt": "2023-10-30T22:08:25.495995+00:00",
      "lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05",
      "lastModifiedByType": "Application"
    },
    "tags": {},
    "type": "microsoft.azurestackhci/marketplacegalleryimages"
  }
]
PS C:\Users\azcli>

Para más información sobre este comando de la CLI, consulte az stack-hci-vm image list.

En Azure Portal del recurso de clúster de Azure Stack HCI, puede realizar un seguimiento de la implementación de la imagen de máquina virtual en la cuadrícula de imágenes de máquina virtual. Puede ver la lista de las imágenes de máquina virtual que ya están descargadas y las que se están descargando en el clúster.

Siga estos pasos para ver la lista de imágenes de máquina virtual en Azure Portal.

1. En Azure Portal, vaya al recurso de clúster de Azure Stack HCI.

2. Vaya a Imágenes de máquina virtual de recursos>.

3. En el panel derecho, puede ver la lista de imágenes de máquina virtual.

   

Siga estos pasos para usar la CLI de Azure para ver las propiedades de una imagen:

1. Ejecuta PowerShell como administrador.

2. Establezca los parámetros siguientes.

   $subscription = "<Subscription ID>"
   $resource_group = "<Cluster resource group>"
   $mktplaceImage = "<Marketplace image name>"
   

3. Puede ver las propiedades de la imagen de dos maneras diferentes: especificar el identificador o especificar el nombre y el grupo de recursos. Siga estos pasos al especificar el identificador de imagen de Marketplace:

   1. Establezca el siguiente parámetro.

      $mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/myhci-marketplaceimage"
      

   2. Ejecute el siguiente comando para ver las propiedades.

      az stack-hci-vm image show --ids $mktplaceImageID

      Esta es una salida de ejemplo para este comando:

      PS C:\Users\azcli> az stack-hci-vm image show --ids $mktplaceImageID
      Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
      {
        "extendedLocation": {
          "name": "/subscriptions/<Subscription ID>/resourcegroups/myhci-rg/providers/microsoft.extendedlocation/customlocations/myhci-cl",
          "type": "CustomLocation"
        },
        "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/myhci-marketplaceimage",
        "location": "eastus",
        "name": "myhci-marketplaceimage",
        "properties": {
          "containerName": null,
          "hyperVGeneration": null,
          "identifier": null,
          "imagePath": null,
          "osType": "Windows",
          "provisioningState": "Succeeded",
          "status": null,
          "version": null
        },
        "resourceGroup": "myhci-rg",
        "systemData": {
          "createdAt": "2022-08-05T20:52:38.579764+00:00",
          "createdBy": "guspinto@microsoft.com",
          "createdByType": "User",
          "lastModifiedAt": "2022-08-05T20:52:38.579764+00:00",
          "lastModifiedBy": "guspinto@microsoft.com",
          "lastModifiedByType": "User"
        },
        "tags": null,
        "type": "microsoft.azurestackhci/galleryimages"
      }
      PS C:\Users\azcli> 
      

En Azure Portal del recurso de clúster de Azure Stack HCI, realice los pasos siguientes:

1. Vaya a Imágenes de máquina virtual de recursos>. En el panel derecho, se muestra una lista de imágenes de máquina virtual.

   

2. Seleccione el nombre de la imagen de máquina virtual para ver las propiedades.

   

1. Ejecuta PowerShell como administrador.

2. Establezca los siguientes parámetros:

   $subscription = "<Subscription ID>"
   $resource_group = "<Cluster resource group>"
   $mktplaceImage = "<Markeplace image name>"    
   

3. Quite una imagen de máquina virtual existente. Ejecute el siguiente comando:

   az stack-hci-vm image delete --subscription $subscription --resource-group $resource_group --name $mktplaceImage --yes
   

Puede eliminar la imagen de dos maneras:

• Especifique el nombre y el grupo de recursos.
• Especifique el identificador.

Después de eliminar una imagen, puede comprobar que la imagen se quita. Esta es una salida de ejemplo cuando se eliminó la imagen especificando el nombre y el grupo de recursos.

PS C:\Users\azcli> $subscription = "<Subscription ID>"
PS C:\Users\azcli> $resource_group = "myhci-rg"
PS C:\Users\azcli> $mktplaceImage = "myhci-marketplaceimage"
PS C:\Users\azcli> az stack-hci-vm image delete --name $mktplaceImage --resource-group $resource_group
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Are you sure you want to perform this operation? (y/n): y
PS C:\Users\azcli> az stack-hci-vm image show --name $mktplaceImage --resource-group $resource_group
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
ResourceNotFound: The Resource 'Microsoft.AzureStackHCI/marketplacegalleryimages/myhci-marketplaceimage' under resource group 'myhci-rg' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix
PS C:\Users\azcli>

En Azure Portal del recurso de clúster de Azure Stack HCI, realice los pasos siguientes:

1. Vaya a Imágenes de máquina virtual de recursos>.

2. En la lista de imágenes de máquina virtual que se muestran en el panel derecho, seleccione el icono de papelera junto a la imagen de máquina virtual que desea eliminar.

   

3. Cuando se le pida que confirme la eliminación, seleccione Sí.

   

Una vez eliminada la imagen de máquina virtual, la lista de imágenes de máquina virtual se actualiza para reflejar la imagen eliminada.