Creare un'immagine di macchina virtuale di Azure Stack HCI usando immagini di Azure Marketplace

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 Azure Marketplace. È possibile creare immagini di vm 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 i prerequisiti seguenti siano completati.

Interfaccia della riga di comando di Azure

• Assicurarsi di esaminare e completare i prerequisiti.

• Se si usa un client per connettersi al cluster Azure Stack HCI, vedere Connettersi al cluster in modalità remota.

Azure portal

Assicurarsi di esaminare e completare i prerequisiti.

Aggiungere un'immagine di macchina virtuale da Azure Marketplace

Si crea un'immagine di macchina virtuale a partire da un'immagine di Azure Marketplace 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. Accedi. Tipo:

   az login --use-device-code
   

3. Impostare la sottoscrizione.

   az account set --subscription <Subscription ID>
   

Impostare alcuni parametri

1. Impostare i parametri per la sottoscrizione, il gruppo di risorse, la posizione, il tipo di sistema operativo per l'immagine. Sostituire i parametri in < > con i valori appropriati.

   $subscription = "<Subscription ID>"
   $resource_group = "<Resource group>"
   $mktplaceImage = "<Marketplace image name>"
   $customLocationName = "<Custom location name>"
   $customLocationID = (az customlocation show --resource-group $resource_group --name "<custom_location_name_for_Azure_Stack_HCI_cluster>" --query id -o tsv)
   $location = "<Location for your Azure Stack HCI cluster>"
   $osType = "<OS of source image>"
   

   I parametri vengono descritti nella tabella seguente:

   Parametro	Descrizione
   subscription	Sottoscrizione associata al cluster Azure Stack HCI.
   resource-group	Gruppo di risorse per il cluster Azure Stack HCI associato a questa immagine.
   name	Nome dell'immagine del marketplace per il cluster Azure Stack HCI.
   customLocation	ID risorsa della posizione personalizzata per il cluster Azure Stack HCI.
   location	Percorso per il cluster Azure Stack HCI. Ad esempio, potrebbe essere eastus.
   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> $mktplaceImage= "myhci-marketplaceimage"
   PS C:\Users\azcli> $customLocationName = "myhci-cl"
   PS C:\Users\azcli> $customerLocationID /subscriptions$subscription/resourcegroups/$resource_group/providers/microsoft.extendedlocation/customlocations/$customLocationName
   PS C:\Users\azcli> $location = "eastus"
   PS C:\Users\azcli> $ostype = "Windows"
   

Creare un'immagine di macchina virtuale dall'immagine del marketplace

1. Impostare parametri aggiuntivi che specificano l'immagine di macchina virtuale desiderata da creare. Sarà necessario includere l'offerta, l'editore, lo SKU e la versione per l'immagine del marketplace. Sostituire i parametri in <> con i valori appropriati:

   $publisher = "<Publisher name>"
   $offer = "<OS offer>"
   $sku = "<Image SKU>"
   

   Usare la tabella seguente per trovare le immagini del Marketplace disponibili e i relativi valori di attributo:

   Nome	Autore	Offerta	SKU
   Windows 11 Enterprise multisessione + Microsoft 365	microsoftwindowsdesktop	office-365	win11-21h2-avd-m365 win11-23h2-avd-m365
   Windows 10 Enterprise multisessione + Microsoft 365	microsoftwindowsdesktop	office-365	win10-21h2-avd-m365 win10-22h2-avd-m365
   Windows 11 Pro	microsoftwindowsdesktop	windows-11	win11-21h2-pro win11-22h2-pro win11-23h2-pro
   Windows 11 Enterprise	microsoftwindowsdesktop	windows-11	win11-21h2-ent win11-22h2-ent win11-23h2-ent
   Windows 11 Enterprise multisessione	microsoftwindowsdesktop	windows-11	win11-21h2-avd win11-22h2-avd win11-23h2-avd
   Windows 10 Pro	microsoftwindowsdesktop	windows-10	win10-22h2-pro-g2
   Windows 10 Enterprise	microsoftwindowsdesktop	windows-10	win10-22h2-ent-g2
   Windows 10 Enterprise multisessione	microsoftwindowsdesktop	windows-10	win10-22h2-avd
   Windows Server 2022 Datacenter: Azure Edition	microsoftwindowsserver	windowsserver	2022-datacenter-azure-edition-hotpatch 2022-datacenter-azure-edition-core 2022-datacenter-azure-edition
   Windows Server 2019	microsoftwindowsserver	windowsserver	2019-datacenter-gensecond 2019-datacenter-core-g2
   SQL Server 2022 Enterprise in Windows Server 2022	microsoftsqlserver	sql2022-ws2022	enterprise-gen2 standard-gen2

   Se si vuole creare un'immagine di Windows Server 2019 Datacenter, sono disponibili i parametri seguenti:

   $publisher = "microsoftwindowsserver" 
   $offer = "windowsserver" 
   $sku = "2019-datacenter-gensecond"
   

2. Creare l'immagine della macchina virtuale a partire da un'immagine del marketplace specificata:

   az stack-hci-vm image create --resource-group $resource_group --custom-location $customLocationID --name $mktplaceImage --os-type $ostype --offer $offer --publisher $publisher --sku $sku 
   

Di seguito è riportato un output di esempio:

PS C:\Users\azcli> az stack-hci-vm image create --custom-location $cl --name $mktplaceImage --os-type $ostype --resource-group $rg --publisher $publisher --offer $offer --sku $sku 
{ 
  "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/myhci-marketplaceimage", 
\ 
  "location": "eastus", 
  "name": "myhci-marketplaceimage", 
  "properties": { 
    "cloudInitDataSource": null, 
    "containerId": null, 
    "hyperVGeneration": null, 
    "identifier": { 
      "offer": "windowsserver", 
      "publisher": "microsoftwindowsserver", 
      "sku": "2019-datacenter-gensecond" 
    }, 
    "osType": "Windows", 
    "provisioningState": "Succeeded", 
    "status": { 
      "downloadStatus": { 
        "downloadSizeInMb": 10832 
      }, 
      "errorCode": "", 
      "errorMessage": "", 
      "progressPercentage": 100, 
      "provisioningStatus": { 
        "operationId": "13efc468-7473-429f-911b-858c1e6fc1d5*B11A62EE76B08EF194F8293CDD40F7BC71BFB93255D5A99DD11B4167690752D9", 
        "status": "Succeeded" 
      } 
    }, 
    "version": { 
      "name": "17763.6293.240905", 
      "properties": { 
        "storageProfile": { 
          "osDiskImage": { 
            "sizeInMb": 130050 
          } 
        } 
      } 

    } 
  }, 
  "resourceGroup": "myhci-rg", 
  "systemData": { 
    "createdAt": "2024-09-23T18:53:13.734389+00:00", 
    "createdBy": "guspinto@contoso.com", 
    "createdByType": "User", 
    "lastModifiedAt": "2024-09-23T19:06:07.532276+00:00", 
    "lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05", 
    "lastModifiedByType": "Application" 
  }, 

  "tags": null, 
  "type": "microsoft.azurestackhci/marketplacegalleryimages" 
} 

Per altre informazioni su questo comando dell'interfaccia della riga di comando, vedere az stack-hci-vm image.

Azure portal

Seguire questa procedura per creare un'immagine di macchina virtuale usando il portale di Azure. Nella portale di Azure della risorsa cluster Azure Stack HCI seguire questa procedura:

1. Passare a Risorse immagini>di macchine virtuali.

2. Selezionare + Aggiungi immagine macchina virtuale e nell'elenco a discesa selezionare Aggiungi immagine macchina virtuale da Azure Marketplace.

   

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 gruppo di risorse nuovo o selezionare un gruppo di risorse esistente associato all'immagine della macchina virtuale.

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

   4. Immagine da scaricare. Selezionare un'immagine di macchina virtuale dall'elenco di immagini in Azure Marketplace. L'elenco a discesa mostra tutte le immagini di Azure Marketplace compatibili con il cluster Azure Stack HCI.

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

   6. Percorso di archiviazione. Selezionare il percorso di archiviazione per l'immagine della macchina virtuale. Selezionare Scegli automaticamente per selezionare automaticamente un percorso di archiviazione con disponibilità elevata. 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.

   

6. Viene avviato un processo di distribuzione del modello di Azure Resource Manager per l'immagine della macchina virtuale. Il completamento della distribuzione delle immagini richiede alcuni minuti. Il tempo necessario per scaricare l'immagine dipende dalle dimensioni dell'immagine del Marketplace 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 che vengono scaricate nel cluster.

   Per visualizzare altri dettagli di qualsiasi immagine, selezionare il nome dell'immagine della macchina virtuale dall'elenco di immagini di macchina virtuale.

7. Al termine del download dell'immagine, l'immagine della macchina virtuale viene visualizzata nell'elenco delle immagini e lo stato viene visualizzato come Disponibile.

   

   Se il download dell'immagine della macchina virtuale ha esito negativo, i dettagli dell'errore vengono visualizzati nel pannello del portale.

   

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. Esegui 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. Esegui questo comando:

   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 Archiviazione di Azure o che si trovano in una condivisione locale nel cluster o in un client connesso al cluster.

Di seguito è riportato 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>

Per altre informazioni su questo comando dell'interfaccia della riga di comando, vedere az stack-hci-vm image list.

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 che vengono 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 del cluster Azure Stack HCI.

2. Passare a Risorse immagini > di macchine virtuali.

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. Esegui 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 immagini>di macchine virtuali. 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à.

   

Aggiornare l'immagine della macchina virtuale

Quando è disponibile una nuova immagine aggiornata in Azure Marketplace, le immagini delle macchine virtuali nel cluster Azure Stack HCI diventano non aggiornate e devono essere aggiornate. L'operazione di aggiornamento non è un aggiornamento sul posto dell'immagine. È invece possibile visualizzare le immagini di macchina virtuale disponibili per un'immagine aggiornata e selezionare le immagini da aggiornare. Dopo l'aggiornamento, l'operazione di creazione dell'immagine della macchina virtuale usa la nuova immagine aggiornata.

Per aggiornare un'immagine di macchina virtuale, seguire questa procedura in portale di Azure.

1. Per verificare se è disponibile un aggiornamento, selezionare un'immagine di macchina virtuale nella visualizzazione elenco.

   

   Nel pannello Panoramica viene visualizzato un banner che mostra la nuova immagine della macchina virtuale disponibile per il download, se disponibile. Per eseguire l'aggiornamento alla nuova immagine, selezionare l'icona a forma di freccia.

   

2. Esaminare i dettagli dell'immagine e quindi selezionare Rivedi e crea. Per impostazione predefinita, la nuova immagine usa lo stesso gruppo di risorse e i dettagli dell'istanza dell'immagine precedente.

   Il nome della nuova immagine viene incrementato in base al nome dell'immagine precedente. Ad esempio, un'immagine esistente denominata winServer2022-01 avrà un'immagine aggiornata denominata winServer2022-02.

   

3. Per completare l'operazione, selezionare Crea.

   

   Dopo aver creato la nuova immagine della macchina virtuale, creare una macchina virtuale usando la nuova immagine e verificare che la macchina virtuale funzioni correttamente. Dopo la verifica, è possibile eliminare l'immagine precedente della macchina virtuale.

   Nota

   In questa versione non è possibile eliminare un'immagine di macchina virtuale se la macchina virtuale associata a tale immagine è in esecuzione. Arrestare la macchina virtuale e quindi eliminare l'immagine della macchina virtuale.

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. Esegui PowerShell come amministratore.

2. Imposta i parametri seguenti:

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

3. Rimuovere un'immagine di macchina virtuale esistente. Esegui questo comando:

   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 immagini>di macchine virtuali.

2. Nell'elenco di immagini di macchine virtuali visualizzate nel riquadro destro selezionare l'icona del cestino accanto all'immagine della macchina virtuale che si vuole 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 per riflettere l'immagine eliminata.

Passaggi successivi

• Creare reti logiche