Creare l'immagine della macchina virtuale HCI di Azure Stack usando l'immagine nell'account di archiviazione di Azure

Si applica a: Azure Stack HCI, versione 23H2

Questo articolo descrive come creare immagini di macchine virtuali (VM) per Azure Stack HCI usando immagini di origine dall'account di archiviazione di Azure. È possibile creare immagini di macchine virtuali usando l'interfaccia della riga di comando di Portale di Azure o Azure e quindi usare queste immagini di macchina virtuale per creare macchine virtuali Arc nell'HCI di Azure Stack.

Prerequisiti

Prima di iniziare, assicurarsi che siano stati completati i prerequisiti seguenti.

  • Assicurarsi di esaminare e completare i prerequisiti.

  • È possibile accedere a un sistema Azure Stack HCI distribuito, ha un bridge di risorse Arc e una posizione personalizzata.

    • Passare alla pagina Panoramica > server nella risorsa di sistema azure Stack HCI. Verificare che Azure Arc sia visualizzato come Connesso. Verrà inoltre visualizzata una posizione personalizzata e un bridge di risorse Arc per il cluster.

      Screenshot della pagina Panoramica nella risorsa cluster azure Stack HCI che mostra Azure Arc come connesso.

  • Per le immagini personalizzate nell'account di archiviazione di Azure, sono disponibili i prerequisiti aggiuntivi seguenti:

Aggiungere l'immagine della macchina virtuale dall'account di archiviazione di Azure

Si crea un'immagine di macchina virtuale a partire da un'immagine nell'account di archiviazione di Azure e quindi si usa questa immagine per distribuire macchine virtuali nel cluster Azure Stack HCI.

Seguire questa procedura per creare un'immagine di macchina virtuale usando l'interfaccia della riga di comando di Azure.

Accedere e impostare la sottoscrizione

  1. Connettersi a un server nel sistema Azure Stack HCI.

  2. Accedere. Digitare:

    az login --use-device-code
    
  3. Impostare la sottoscrizione.

    az account set --subscription <Subscription ID>
    

Impostare alcuni parametri

  1. Impostare la sottoscrizione, il gruppo di risorse, il percorso, il percorso dell'immagine nella condivisione locale e il tipo di sistema operativo per l'immagine. Sostituire i parametri in < > con i valori appropriati.
$subscription = "<Subscription ID>"
$resource_group = "<Resource group>"
$location = "<Location for your Azure Stack HCI cluster>"
$osType = "<OS of source image>"
$imageName = "<VM image name>"
$imageSourcePath = "<path to the source image in the Storage account>"

I parametri vengono descritti nella tabella seguente:

Parametro Descrizione
subscription Gruppo di risorse per il cluster HCI di Azure Stack associato a questa immagine.
resource_group Gruppo di risorse per il cluster HCI di Azure Stack associato a questa immagine.
location Percorso per il cluster Azure Stack HCI. Ad esempio, potrebbe essere eastus.
imageName Nome dell'immagine della macchina virtuale creata a partire dall'immagine nella condivisione locale.
Nota: Azure rifiuta tutti i nomi che contengono la parola chiave Windows.
imageSourcePath Percorso dell'URL della firma di accesso condiviso BLOB dell'immagine nell'account di archiviazione. Per altre informazioni, vedere istruzioni su come ottenere un URL di firma di accesso condiviso BLOB dell'immagine nell'account di archiviazione.
Nota: assicurarsi che tutte le amperande nel percorso vengano escape con virgolette doppie e che l'intera stringa di percorso venga sottoposta a wrapping all'interno di virgolette singole.
os-type Sistema operativo associato all'immagine di origine. Questo può essere Windows o Linux.

Di seguito è riportato un output di esempio:

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:\Users\azcli> $imageName = "myhci-storacctimage"
PS C:\Users\azcli> $imageSourcePath = 'https://vmimagevhdsa1.blob.core.windows.net/vhdcontainer/Windows_InsiderPreview_ServerStandard_en-us_VHDX_25131.vhdx?sp=r"&"st=2022-08-05T18:41:41Z"&"se=2022-08-06T02:41:41Z"&"spr=https"&"sv=2021-06-08"&"sr=b"&"sig=X7A98cQm%2FmNRaHmTbs9b4OWVv%2F9Q%2FJkWDBHVPyAc8jo%3D'

Creare un'immagine della macchina virtuale dall'immagine nell'account di archiviazione di Azure

  1. Selezionare un percorso personalizzato per distribuire l'immagine della macchina virtuale. La posizione personalizzata deve corrispondere alla posizione personalizzata per il cluster Azure Stack HCI. Ottenere l'ID percorso personalizzato per il cluster Azure Stack HCI. Eseguire il comando seguente:

    $customLocationID=(az customlocation show --resource-group $resource_group --name "<custom location name for HCI cluster>" --query id -o tsv)
    
  2. Creare l'immagine della macchina virtuale a partire da un'immagine del marketplace specificata. Assicurarsi di specificare l'offerta, l'editore, lo sku e la versione per l'immagine del marketplace.

    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 --storage-path-id $storagepathid
    

    Viene avviato un processo di distribuzione per l'immagine della macchina virtuale.

    In questo esempio, il percorso di archiviazione è stato specificato usando il --storage-path-id flag e che ha garantito che i dati del carico di lavoro (inclusa la macchina virtuale, l'immagine della macchina virtuale, il disco dati non del sistema operativo) vengano inseriti nel percorso di archiviazione specificato.

    Se il flag non è specificato, i dati del carico di lavoro vengono inseriti automaticamente in un percorso di archiviazione a disponibilità elevata.

La distribuzione dell'immagine richiede alcuni minuti per completare. Il tempo necessario per scaricare l'immagine dipende dalle dimensioni dell'immagine nell'account di archiviazione di Azure e dalla larghezza di banda di rete disponibile per il download.

Di seguito è riportato un output di esempio:

PS > $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 --name $imageName --os-type $osType --image-path $imageSourcePath --storage-path-id $storagepathid
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-storacctimage",
  "location": "eastus",
  "name": "windos",
  "properties": {
    "identifier": null,
    "imagePath": null,
    "osType": "Windows",
    "provisioningState": "Succeeded",
    "status": {
      "downloadStatus": {
        "downloadSizeInMB": 7876
      },
        "progressPercentage": 100,
      "provisioningStatus": {
        "operationId": "cdc9c9a8-03a1-4fb6-8738-7a8550c87fd1*31CE1EA001C4B3E38EE29B78ED1FD47CCCECF78B4CEA9E9A85C0BAEA5F6D80CA",
        "status": "Succeeded"
      }
    },
    "storagepathId": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/storagecontainers/myhci-storagepath",
    "version": null
  },
  "resourceGroup": "myhci-rg",
  "systemData": {
    "createdAt": "2023-11-03T20:17:10.971662+00:00",
    "createdBy": "guspinto@contoso.com",
    "createdByType": "User",
    "lastModifiedAt": "2023-11-03T21:08:01.190475+00:00",
    "lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05",
    "lastModifiedByType": "Application"
  },
  "tags": null,
  "type": "microsoft.azurestackhci/galleryimages"
}
PS C:\Users\azcli>

Elencare le immagini delle macchine virtuali

È necessario visualizzare l'elenco delle immagini delle macchine virtuali per scegliere un'immagine da gestire.

Seguire questa procedura per elencare l'immagine della macchina virtuale usando l'interfaccia della riga di comando di Azure.

  1. Eseguire PowerShell come amministratore.

  2. Impostare alcuni parametri.

    $subscription = "<Subscription ID associated with your cluster>"
    $resource_group = "<Resource group name for your cluster>"
    
  3. Elencare tutte le immagini di macchina virtuale associate al cluster. Eseguire il comando seguente:

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

    A seconda del comando usato, viene elencato un set corrispondente di immagini associate al cluster Azure Stack HCI.

    • Se si specifica solo la sottoscrizione, il comando elenca tutte le immagini nella sottoscrizione.
    • Se si specificano sia la sottoscrizione che il gruppo di risorse, il comando elenca tutte le immagini nel gruppo di risorse.

    Queste immagini includono:

    • Immagini di macchine virtuali dalle immagini del marketplace.
    • Immagini personalizzate che risiedono nell'account di archiviazione di Azure o che si trovano in una condivisione locale nel cluster o in un client connesso al cluster.

Ecco un output di esempio.

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>

Visualizzare le proprietà dell'immagine della macchina virtuale

È consigliabile visualizzare le proprietà delle immagini di macchina virtuale prima di usare l'immagine per creare una macchina virtuale. Seguire questa procedura per visualizzare le proprietà dell'immagine:

Seguire questa procedura per usare l'interfaccia della riga di comando di Azure per visualizzare le proprietà di un'immagine:

  1. Eseguire PowerShell come amministratore.

  2. Impostare i parametri seguenti.

    $subscription = "<Subscription ID>"
    $resource_group = "<Cluster resource group>"
    $mktplaceImage = "<Marketplace image name>"
    
  3. È possibile visualizzare le proprietà delle immagini in due modi diversi: specificare l'ID o specificare il nome e il gruppo di risorse. Per specificare l'ID immagine del Marketplace, seguire questa procedura:

    1. Impostare il parametro seguente.

      $mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/myhci-marketplaceimage"
      
    2. Eseguire il comando seguente per visualizzare le proprietà.

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

      Ecco un output di esempio per questo 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> 
      

Eliminare l'immagine della macchina virtuale

È possibile eliminare un'immagine di macchina virtuale se il download non riesce per qualche motivo o se l'immagine non è più necessaria. Seguire questa procedura per eliminare le immagini della macchina virtuale.

  1. Eseguire PowerShell come amministratore.

  2. Impostare i parametri seguenti.

    $subscription = "<Subscription ID>"
    $resource_group = "<Cluster resource group>"
    $galleryImageName = "<Gallery image name>"    
    
  3. Rimuovere un'immagine di macchina virtuale esistente. Eseguire il comando seguente:

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

È possibile eliminare l'immagine in due modi:

  • Specificare il nome e il gruppo di risorse.
  • Specificare l'ID.

Dopo aver eliminato un'immagine, è possibile verificare che l'immagine sia stata rimossa. Ecco un output di esempio quando l'immagine è stata eliminata specificando il nome e il gruppo di risorse.

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>

Passaggi successivi