Creare un'immagine di macchina virtuale Azure Stack HCI usando immagini in una condivisione locale

Si applica a: Azure Stack HCI, versione 23H2

Questo articolo descrive come creare immagini di macchine virtuali per Azure Stack HCI usando immagini di origine da una condivisione locale nel cluster. È possibile creare immagini di macchine virtuali usando il portale di Azure o l'interfaccia della riga di comando di Azure e quindi usare queste immagini di macchina virtuale per creare macchine virtuali Arc in Azure Stack HCI.

Prerequisiti

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

Interfaccia della riga di comando di Azure

• Assicurarsi di esaminare e completare i prerequisiti.

• Si ha accesso a un sistema Azure Stack HCI distribuito, ha un Arc Resource Bridge e una posizione personalizzata.

  • Passare alla pagina Panoramica > server nella risorsa di sistema Azure Stack HCI. Verificare che Azure Arc sia visualizzato come Connesso. Dovrebbe essere visualizzata anche una posizione personalizzata e un Arc Resource Bridge per il cluster.

    

• Per le immagini personalizzate in una condivisione locale in Azure Stack HCI, sono disponibili i prerequisiti aggiuntivi seguenti:

  • È necessario caricare un VHD/VHDX in una condivisione locale nel cluster Azure Stack HCI.
  • L'immagine VHDX deve essere di tipo Gen 2 e l'avvio protetto abilitato.
  • L'immagine VHDX deve essere preparata usando sysprep /generalize /shutdown /oobe. Per altre informazioni, vedere Opzioni della riga di comando sysprep.
  • L'immagine deve risiedere in un volume condiviso cluster disponibile per tutti i server del cluster. Sono supportati sia i sistemi operativi Windows che Linux.

• Se si usa un client per connettersi al cluster Azure Stack HCI, vedere Connettersi ad Azure Stack HCI tramite il client dell'interfaccia della riga di comando di Azure.

Azure portal

• Assicurarsi di esaminare e completare i prerequisiti.

• Si ha accesso a un sistema Azure Stack HCI distribuito, ha un Arc Resource Bridge e una posizione personalizzata.

  • Passare alla pagina Panoramica > server nella risorsa di sistema Azure Stack HCI. Verificare che Azure Arc sia visualizzato come Connesso. Dovrebbe essere visualizzata anche una posizione personalizzata e un Arc Resource Bridge per il cluster.

    

• Per le immagini personalizzate in una condivisione locale in Azure Stack HCI, sono disponibili i prerequisiti aggiuntivi seguenti:

  • È necessario caricare un VHD/VHDX in una condivisione locale nel cluster Azure Stack HCI.
  • L'immagine VHDX deve essere di tipo Gen 2 e l'avvio protetto abilitato.
  • L'immagine VHDX deve essere preparata usando sysprep /generalize /shutdown /oobe. Per altre informazioni, vedere Opzioni della riga di comando sysprep.
  • L'immagine deve risiedere in un volume condiviso cluster disponibile per tutti i server del cluster. Sono supportati sia i sistemi operativi Windows che Linux.

Aggiungere un'immagine di macchina virtuale dall'immagine nella condivisione locale

Si crea un'immagine di macchina virtuale a partire da un'immagine in una condivisione locale del cluster e quindi si usa questa immagine per distribuire le macchine virtuali nel cluster Azure Stack HCI.

Interfaccia della riga di comando di Azure

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 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>"
   $imageName = <VM image name>
   $imageSourcePath = <path to the source image>
   $osType = "<OS of source image>"
   

   I parametri vengono descritti nella tabella seguente:

   Parametro	Descrizione
   subscription	Gruppo di risorse per il cluster Azure Stack HCI associato a questa immagine.
   resource_group	Gruppo di risorse per il cluster Azure Stack HCI associato a questa immagine.
   location	Percorso del cluster Azure Stack HCI. Ad esempio, potrebbe trattarsi di eastus.
   image-path	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.
   name	Percorso dell'immagine della raccolta di origine (solo VHDX) nel cluster. Ad esempio, C:\OSImages\winos.vhdx. Vedere i prerequisiti dell'immagine di origine.
   os-type	Sistema operativo associato all'immagine di origine. Può trattarsi di 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:\ClusterStorage\Volume1> $imageName = "myhci-localimage"
   PS C:\ClusterStorage\Volume1> $imageSourcePath = "C:\ClusterStorage\Volume1\Windows_K8s_17763.2928.220505-1621_202205101158.vhdx"
   

Creare un'immagine di macchina virtuale dall'immagine nella condivisione locale

1. Selezionare un percorso personalizzato per distribuire l'immagine della macchina virtuale. Il percorso personalizzato 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 specificata in una condivisione locale nel cluster 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
   
   

   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 viene specificato, i dati del carico di lavoro vengono inseriti automaticamente in un percorso di archiviazione a disponibilità elevata.

Il completamento della distribuzione delle immagini richiede alcuni minuti. Il tempo impiegato per scaricare l'immagine dipende dalle dimensioni dell'immagine nella condivisione locale e dalla larghezza di banda di rete disponibile per il download.

Di seguito è riportato un output di esempio:

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>

Azure portal

È possibile creare un'immagine di macchina virtuale scaricando un'immagine che si trova in una condivisione locale nel cluster Azure Stack HCI e quindi usando tale immagine di macchina virtuale per distribuire una macchina virtuale.

Nella portale di Azure della risorsa cluster Azure Stack HCI seguire questa procedura:

1. Passare a Risorse immagini>vm.

2. Selezionare + Aggiungi immagine macchina virtuale e nell'elenco a discesa selezionare Aggiungi immagine macchina virtuale da una condivisione locale.

   

3. Nella pagina Crea un'immagine immettere le informazioni seguenti nella scheda Informazioni di base :

   1. Sottoscrizione. Selezionare una sottoscrizione da associare all'immagine della macchina virtuale.

   2. Gruppo di risorse. Creare un nuovo gruppo di risorse o selezionare un gruppo di risorse esistente associato all'immagine della macchina virtuale.

   3. Salvare l'immagine con nome. Immettere un nome per l'immagine della macchina virtuale.

   4. Posizione personalizzata. Selezionare un percorso personalizzato per distribuire l'immagine della macchina virtuale. Il percorso personalizzato deve corrispondere alla posizione personalizzata per il cluster Azure Stack HCI.

   5. Tipo di sistema operativo. Selezionare il sistema operativo dell'immagine come Windows o Linux. Si tratta del sistema operativo associato all'immagine nell'account di archiviazione.

   6. Generazione di macchine virtuali. Selezionare la generazione per l'immagine.

   7. Origine. L'origine dell'immagine deve essere Condivisione file locale e viene popolata automaticamente.

   8. Percorso condivisione file locale. Specificare il percorso di condivisione locale per l'immagine di origine nel cluster HCI.

   9. Percorso di archiviazione. Selezionare il percorso di archiviazione per l'immagine della macchina virtuale. Selezionare Scegli automaticamente per avere un percorso di archiviazione con disponibilità elevata selezionato automaticamente. Selezionare Scegliere manualmente per specificare un percorso di archiviazione per archiviare immagini e file di configurazione delle macchine virtuali nel cluster Azure Stack HCI. In questo caso, assicurarsi che il percorso di archiviazione specificato disponga di spazio di archiviazione sufficiente.

4. Selezionare Rivedi e crea per creare l'immagine della macchina virtuale.

   

5. I parametri di input vengono convalidati. Se le convalide hanno esito positivo, è possibile esaminare i dettagli dell'immagine della macchina virtuale e selezionare Crea.

   

   Viene avviato un processo di distribuzione del modello Resource Manager di Azure per l'immagine della macchina virtuale. Il completamento della distribuzione delle immagini richiede alcuni minuti. Il tempo impiegato per scaricare l'immagine dipende dalle dimensioni dell'immagine personalizzata e dalla larghezza di banda di rete disponibile per il download.

   È possibile tenere traccia della distribuzione dell'immagine nella griglia delle immagini della macchina virtuale. È possibile visualizzare l'elenco delle immagini di macchina virtuale già scaricate e quelle scaricate nel cluster.

6. Al termine del download dell'immagine, l'immagine della macchina virtuale viene visualizzata nell'elenco delle immagini e lo stato viene visualizzato come Disponibile. Per visualizzare altri dettagli di qualsiasi immagine, selezionare il nome dell'immagine della macchina virtuale nell'elenco delle immagini di macchina virtuale.

Elencare le immagini delle macchine virtuali

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

Interfaccia della riga di comando di Azure

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>

Azure portal

Nella portale di Azure della risorsa cluster Azure Stack HCI è possibile tenere traccia della distribuzione dell'immagine della macchina virtuale nella griglia delle immagini della macchina virtuale. È possibile visualizzare l'elenco delle immagini di macchina virtuale già scaricate e quelle scaricate nel cluster.

Seguire questa procedura per visualizzare l'elenco delle immagini delle macchine virtuali in portale di Azure.

1. Nella portale di Azure passare alla risorsa cluster Azure Stack HCI.

2. Passare a Risorse immagini > vm.

3. Nel riquadro destro è possibile visualizzare l'elenco delle immagini della macchina virtuale.

   

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:

Interfaccia della riga di comando di Azure

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> 
      

Azure portal

Nella portale di Azure della risorsa cluster Azure Stack HCI seguire questa procedura:

1. Passare a Risorse (anteprima)>Immagini vm. Nel riquadro destro viene visualizzato un elenco di immagini di macchine virtuali.

   

2. Selezionare il nome dell'immagine della macchina virtuale per visualizzare le proprietà.

   

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.

Interfaccia della riga di comando di Azure

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>

Azure portal

Nella portale di Azure della risorsa cluster Azure Stack HCI seguire questa procedura:

1. Passare a Risorse (anteprima)>Immagini vm.

2. Nell'elenco delle immagini vm visualizzate nel riquadro destro selezionare l'icona del cestino accanto all'immagine della macchina virtuale da eliminare.

   

3. Quando viene richiesto di confermare l'eliminazione, selezionare Sì.

   

Dopo l'eliminazione dell'immagine della macchina virtuale, l'elenco delle immagini della macchina virtuale viene aggiornato in modo da riflettere l'immagine eliminata.

Passaggi successivi

• Creare reti logiche