Erstellen eines Azure Local-VM-Images mit Images in einer lokalen Freigabe

• Überprüfen Sie die Voraussetzungen und stellen Sie sicher, dass Sie sie erfüllen.

• Für benutzerdefinierte Images in einer lokalen Freigabe in Ihrer Azure Local-Instanz gelten die folgenden zusätzlichen Voraussetzungen:

  • Sie müssen eine VHD/VHDX-Datei in eine lokale Freigabe auf Ihrem System hochgeladen haben.
  • Das VHDX-Image muss vom Typ Gen 2 sein und sicheres Booten ermöglichen.
  • Das VHDX-Imagebetriebssystem muss aktiviert werden, einschließlich, jedoch nicht beschränkt auf KMS oder AVMA.
  • Das VHDX-Image muss mithilfe von sysprep /generalize /shutdown /oobe vorbereitet werden. Weitere Informationen finden Sie unter Sysprep Befehlszeilenoptionen.
  • Das Image sollte sich auf einem gemeinsam genutzten Cluster-Volume befinden, das allen Rechnern der Instanz zur Verfügung steht. Sowohl das Windows- als auch das Linux-Betriebssystem werden unterstützt.

• Wenn Sie einen Client verwenden, um sich mit Ihrer Azure Local-Instanz zu verbinden, lesen Sie Verbinden Sie sich mit Azure Local über den Azure CLI-Client.

• Überprüfen Sie die Voraussetzungen und stellen Sie sicher, dass Sie sie erfüllen.

• Für benutzerdefinierte Images in einer lokalen Freigabe in Ihrer Azure Local-Instanz gelten die folgenden zusätzlichen Voraussetzungen:

  • Sie müssen eine VHD/VHDX-Datei in eine lokale Freigabe auf Ihrem System hochgeladen haben.
  • Das VHDX-Image muss vom Typ Gen 2 sein und sicheres Booten ermöglichen.
  • Das VHDX-Imagebetriebssystem muss aktiviert werden, einschließlich, jedoch nicht beschränkt auf KMS oder AVMA.
  • Das VHDX-Image muss mithilfe von sysprep /generalize /shutdown /oobe vorbereitet werden. Weitere Informationen finden Sie unter Sysprep Befehlszeilenoptionen.
  • Das Image sollte sich auf einem gemeinsam genutzten Cluster-Volume befinden, das allen Rechnern der Instanz zur Verfügung steht. Sowohl das Windows- als auch das Linux-Betriebssystem werden unterstützt.

Folgen Sie diesen Schritten, um ein VM-Image mit der Azure CLI zu erstellen.

Anmelden und Festlegen eines Abonnements

1. Stellen Sie eine Verbindung mit einem Computer auf Ihrer Azure Local-Instanz her.

2. Melden Sie sich an. Typ:

   az login --use-device-code
   

3. Legen Sie Ihr Abonnement fest.

   az account set --subscription <Subscription ID>
   

Festlegen einiger Parameter

1. Legen Sie Ihr Abonnement, die Ressourcengruppe, den Standort und den Betriebssystemtyp für das Bild fest. Ersetzen Sie die Parameter in < > durch die entsprechenden Werte.

   $subscription = "<Subscription ID>"
   $resourceGroup = "<Resource group>"
   $customLocationID = "<Custom or extended location of your Azure Local instance>"
   $location = "<Location for your Azure Local>"
   $imageSourcePath = '"<Path to the source image in local share>"'
   $imageName = "<VM image name>"
   $osType = "<OS of source image>"
   $storagePathID = "/subscriptions/<Subscription ID>/resourceGroups/local-rg/providers/Microsoft.AzureStackHCI/storagecontainers/local-sp"
   

   Die Parameter werden in der folgenden Tabelle beschrieben:

   Parameter (CLI-Flag)	Variablenname	Beschreibung
   subscription	$subscription	Abonnementgruppe für Azure Local, die Sie mit diesem Bild verknüpfen.
   resource-group	$resourceGroup	Ressourcengruppe für Azure Local, die Sie mit diesem Bild verknüpfen.
   custom-location	$customLocationID	ARM-ID des benutzerdefinierten oder erweiterten Speicherorts Ihrer lokalen Azure-Instanz.
   location	$location	Lokation für Ihre lokale Azure-Instanz. Beispiel: eastus.
   image-path	$imageSourcePath	Pfad zum Quell-Galeriebild (nur VHDX) in der lokalen Freigabe. Beispiel: C:\OSImages\winos.vhdx. Sehen Sie sich die Voraussetzungen für das Quell-Image an.
   name	$imageName	Der Name des erstellten VM-Images beginnt mit dem Image in Ihrer lokalen Freigabe. Anmerkung: Azure lehnt alle Namen ab, die das Schlüsselwort Windows enthalten.
   os-type	$osType	Betriebssystem, das mit dem Quell-Image verbunden ist. Beispielsweise Windows oder Linux.
   storage-path-id	$storagePathID	Der zugeordnete Speicherpfad, in dem die VM-Konfiguration und die Daten gespeichert werden.

   Hier ist eine Beispielausgabe:

   PS C:\Users\azcli> $subscription = "<Subscription ID>"
   PS C:\Users\azcli> $resourceGroup = "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"
   

Hinzufügen eines VM-Images aus einem Image in der lokalen Freigabe

1. Wählen Sie einen benutzerdefinierten Ort für die Bereitstellung Ihres VM-Images. Der benutzerdefinierte Speicherort sollte dem benutzerdefinierten Speicherort für Ihr Azure Local entsprechen. Rufen Sie die ID des benutzerdefinierten Standorts für Ihre Azure Local-Instanz ab. Führen Sie den folgenden Befehl aus:

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

2. Erstellen Sie das VM-Image ausgehend von einem bestimmten Image in einer lokalen Freigabe in Ihrer Azure Local-Instanz.

   az stack-hci-vm image create --subscription $subscription --resource-group $resourceGroup --custom-location $customLocationID --location $location --image-path $imageSourcePath --name $imageName --os-type $osType --storage-path-id $storagePathID
   

   Ein Bereitstellungsauftrag wird für das VM-Image gestartet.

In diesem Beispiel wurde der Speicherpfad mithilfe des --storage-path-id Flags angegeben. Mit diesem Kennzeichen wird sichergestellt, dass die Workloaddaten (einschließlich vm, VM-Image und Datenträger ohne Betriebssystem) im angegebenen Speicherpfad platziert werden.

Wenn das Kennzeichen nicht angegeben ist, werden die Workloaddaten automatisch in einem Speicherpfad mit hoher Verfügbarkeit platziert.

Die Bereitstellung des Images dauert einige Minuten. Die Zeit, die für den Download des Bildes benötigt wird, hängt von der Größe des Bildes in der lokalen Freigabe und der für den Download verfügbaren Netzwerkbandbreite ab.

Hier ist eine Beispielausgabe:

PS C:\Users\azcli> $customLocationID=(az customlocation show --resource-group $resourceGroup --name "myhci-cl" --query id -o tsv)
PS C:\Users\azcli> az stack-hci-vm image create --subscription $subscription --resource-group $resourceGroup --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"
}    

Sie können ein VM-Image erstellen, indem Sie ein Image herunterladen, das sich in einer lokalen Freigabe auf Ihrem Azure Local befindet, und dieses VM-Image dann zur Bereitstellung einer virtuellen Maschine verwenden.

Führen Sie im Azure-Portal für Ihre Azure Local-Ressource die folgenden Schritte aus:

1. Gehen Sie zu Ressourcen>VM-Bilder.

2. Wählen Sie +VM-Image hinzufügen, und wählen Sie in der Dropdownliste VM-Image aus einer lokalen Freigabe hinzufügen aus.

   

3. Geben Sie auf der Registerkarte "Grundlagen" auf der Seite "Bild erstellen" die folgenden Informationen ein:

   1. Abonnement: Wählen Sie ein Abonnement aus, das Ihrem VM-Image zugeordnet werden soll.

   2. Ressourcengruppe: Erstellen Sie eine neue oder wählen Sie eine vorhandene Ressourcengruppe aus, die Sie dem VM-Image zuordnen.

   3. Bild speichern unter: Geben Sie einen Namen für Ihr VM-Image ein.

   4. Benutzerdefinierter Speicherort: Wählen Sie einen benutzerdefinierten Speicherort aus, um Ihr VM-Image bereitzustellen. Der benutzerdefinierte Speicherort sollte dem benutzerdefinierten Speicherort für Ihr Azure Local entsprechen.

   5. Betriebssystemtyp: Wählen Sie das Betriebssystem des Images als Windows oder Linux aus. Dieses Betriebssystem ist dem Image in Ihrem Speicherkonto zugeordnet.

   6. VM-Generation: Wählen Sie die Generierung für Ihr Image aus.

   7. Quelle: Die Quelle des Bilds sollte die Lokale Dateifreigabe sein und wird automatisch ausgefüllt.

   8. Lokaler Dateifreigabepfad: Geben Sie den lokalen Freigabepfad für das Quellimage auf Ihrem System an.

   9. Speicherpfad: Wählen Sie den Speicherpfad für Ihr VM-Image aus. Wählen Sie Automatisch auswählen , um einen Speicherpfad mit hoher Verfügbarkeit automatisch auszuwählen. Wählen Sie Manuell auswählen , um einen Speicherpfad zum Speichern von VM-Images und Konfigurationsdateien auf der Azure Local-Instanz anzugeben. Stellen Sie in diesem Fall sicher, dass der angegebene Speicherpfad über ausreichend Speicherplatz verfügt.

4. Wählen Sie Überprüfen + Erstellen , um Ihr VM-Image zu erstellen.

   

5. Die Eingabeparameter werden validiert. Wenn die Überprüfungen erfolgreich waren, können Sie die Details des VM-Images überprüfen und Erstellenwählen.

   

   Ein Azure Resource Manager-Vorlagen-Bereitstellungsauftrag für das VM-Image wird gestartet. Die Bereitstellung des Images dauert einige Minuten. Die Zeit, die für den Download des Bildes benötigt wird, hängt von der Größe des benutzerdefinierten Bildes und der für den Download verfügbaren Netzwerkbandbreite ab.

   Sie können die Bereitstellung des Images im VM-Image-Raster verfolgen. Sie können die Liste der VM-Images sehen, die bereits heruntergeladen wurden und die, die gerade auf das System heruntergeladen werden.

6. Wenn der Download des Images abgeschlossen ist, erscheint das VM-Image in der Liste der Images und der Status wird als Verfügbarangezeigt. Um weitere Details zu einem Image anzuzeigen, wählen Sie den Namen des VM-Images in der Liste der VM-Images.