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

Si applica a: Locale di Azure, versione 23H2

Questo articolo descrive come creare immagini di macchine virtuali per Azure Local usando immagini di origine da una condivisione locale. È 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 Locale di Azure.

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.

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

  • Nel sistema deve essere caricato un VHD/VHDX in una condivisione locale.
  • 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 del cluster disponibile per tutti i computer nell'istanza. Sono supportati sia i sistemi operativi Windows che Linux.

• Se si usa un client per connettersi all'istanza locale di Azure, vedere Connettersi ad Azure locale tramite il client dell'interfaccia della riga di comando di Azure.

Azure portal

• Assicurarsi di esaminare e completare i prerequisiti.

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

  • Nel sistema deve essere caricato un VHD/VHDX in una condivisione locale.
  • 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 del cluster disponibile per tutti i computer nell'istanza. 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 sistema e quindi si usa questa immagine per distribuire le macchine virtuali nell'istanza locale di Azure.

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 computer in Locale di Azure.

2. Accedi. Tipo:

   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, 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>"
   $location = "<Location for your Azure Local>"
   $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 sottoscrizioni per Locale di Azure associato a questa immagine.
   resource_group	Gruppo di risorse per Azure Locale associato a questa immagine.
   location	Località per l'istanza locale di Azure. Ad esempio, potrebbe essere 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 sistema. 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 = "mylocalrg"
   PS C:\Users\azcli> $location = "eastus"
   PS C:\Users\azcli> $osType = "Windows"
   PS C:\ClusterStorage\Volume1> $imageName = "mylocal-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. La posizione personalizzata deve corrispondere alla posizione personalizzata per l'istanza locale di Azure. Ottenere l'ID percorso personalizzato per l'istanza locale di Azure. Esegui questo comando:

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

2. Creare l'immagine della macchina virtuale a partire da un'immagine specificata in una condivisione locale nell'istanza locale di Azure.

   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 verificato 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 necessario 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/mylocal-rg/providers/Microsoft.ExtendedLocation/customLocations/mylocal-cl",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/<Subscription ID>/resourceGroups/mylocal-rg/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-localimage",
  "location": "eastus",
  "name": "mylocal-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 nell'istanza locale di Azure e quindi usando l'immagine di macchina virtuale per distribuire una macchina virtuale.

In portale di Azure per la risorsa locale di Azure 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 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 gruppo di risorse nuovo 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. Percorso personalizzato. Selezionare un percorso personalizzato per distribuire l'immagine della macchina virtuale. La posizione personalizzata deve corrispondere alla posizione personalizzata per l'istanza locale di Azure.

   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 sistema.

   9. 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 nell'istanza locale di Azure. 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 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 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 sistema.

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 dall'elenco di 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. Esegui PowerShell come amministratore.

2. Impostare alcuni parametri.

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

3. Elencare tutte le immagini di macchina virtuale associate all'istanza locale di Azure. 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 all'istanza locale di Azure.

   • 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 sistema o in un client connesso al sistema.

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": "mylocal-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 locale di Azure è 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 sistema.

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

1. Nella portale di Azure passare alla risorsa locale di Azure.

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 = "<Azure Local 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/mylocal-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/mylocal-cl",
          "type": "CustomLocation"
        },
        "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-marketplaceimage",
        "location": "eastus",
        "name": "mylocal-marketplaceimage",
        "properties": {
          "containerName": null,
          "hyperVGeneration": null,
          "identifier": null,
          "imagePath": null,
          "osType": "Windows",
          "provisioningState": "Succeeded",
          "status": null,
          "version": null
        },
        "resourceGroup": "mylocal-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 locale di Azure 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à.

   

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 = "<Azure Local 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 = "mylocal-rg"
PS C:\Users\azcli> $mktplaceImage = "mymylocal-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 'mylocal-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 locale di Azure 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.