Skapa en virtuell Azure Stack HCI-avbildning med hjälp av avbildningar i en lokal resurs

Gäller för: Azure Stack HCI, version 23H2

Den här artikeln beskriver hur du skapar avbildningar av virtuella datorer (VM) för din Azure Stack HCI med källavbildningar från en lokal resurs i klustret. Du kan skapa VM-avbildningar med hjälp av Azure Portal eller Azure CLI och sedan använda dessa VM-avbildningar för att skapa virtuella Arc-datorer på din Azure Stack HCI.

Förutsättningar

Innan du börjar kontrollerar du att följande krav är uppfyllda.

  • Se till att granska och slutföra förutsättningarna.

  • Du har åtkomst till ett Azure Stack HCI-system som distribueras, har en Arc Resource Bridge och en anpassad plats.

    • Gå till sidan Översiktsserver > i Azure Stack HCI-systemresursen. Kontrollera att Azure Arc visas som Ansluten. Du bör också se en anpassad plats och en Arc Resource Bridge för klustret.

      Skärmbild av sidan Översikt i Azure Stack HCI-klusterresursen som visar Azure Arc som ansluten.

  • För anpassade avbildningar i en lokal resurs på din Azure Stack HCI har du följande extra krav:

    • Du bör ha en VHD/VHDX uppladdad till en lokal resurs i ditt Azure Stack HCI-kluster.
    • VHDX-avbildningen måste vara av gen 2-typ och säker start aktiverad.
    • VHDX-avbildningen måste förberedas med .sysprep /generalize /shutdown /oobe Mer information finns i Sysprep-kommandoradsalternativ.
    • Avbildningen ska finnas på en klusterdelad volym som är tillgänglig för alla servrar i klustret. Både Windows- och Linux-operativsystem stöds.

Lägg till VM-avbildning från avbildning i lokal resurs

Du skapar en VM-avbildning från en avbildning i en lokal resurs i klustret och använder sedan den här avbildningen för att distribuera virtuella datorer i ditt Azure Stack HCI-kluster.

Följ de här stegen för att skapa en VM-avbildning med hjälp av Azure CLI.

Logga in och ange prenumeration

  1. Anslut till en server i ditt Azure Stack HCI-system.

  2. Logga in. Ange:

    az login --use-device-code
    
  3. Ange din prenumeration.

    az account set --subscription <Subscription ID>
    

Ange några parametrar

  1. Ange din prenumeration, resursgrupp, plats, OS-typ för avbildningen. Ersätt parametrarna i < > med lämpliga värden.

    $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>"
    

    Parametrarna beskrivs i följande tabell:

    Parameter Beskrivning
    subscription Resursgrupp för Azure Stack HCI-kluster som du associerar med den här avbildningen.
    resource_group Resursgrupp för Azure Stack HCI-kluster som du associerar med den här avbildningen.
    location Plats för ditt Azure Stack HCI-kluster. Det kan till exempel vara eastus.
    image-path Namnet på den virtuella datoravbildning som skapats med början i avbildningen i din lokala resurs.
    Obs! Azure avvisar alla namn som innehåller nyckelordet Windows.
    name Sökväg till källgalleriavbildningen (endast VHDX) i klustret. Till exempel C:\OSImages\winos.vhdx. Se förutsättningarna för källbilden.
    os-type Operativsystem som är associerat med källavbildningen. Detta kan vara Windows eller Linux.

    Här är exempel på utdata:

    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"
    

Skapa vm-avbildning från avbildning i lokal resurs

  1. Välj en anpassad plats för att distribuera vm-avbildningen. Den anpassade platsen ska motsvara den anpassade platsen för ditt Azure Stack HCI-kluster. Hämta det anpassade plats-ID:t för ditt Azure Stack HCI-kluster. Kör följande kommando:

    $customLocationID=(az customlocation show --resource-group $resource_group --name "<custom location name for HCI cluster>" --query id -o tsv)
    
  2. Skapa den virtuella datoravbildningen som börjar med en angiven avbildning i en lokal resurs i ditt Azure Stack HCI-kluster.

    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
    
    

    Ett distributionsjobb startar för VM-avbildningen.

    I det här exemplet angavs lagringssökvägen med hjälp av --storage-path-id flaggan och som säkerställde att arbetsbelastningsdata (inklusive den virtuella datorn, VM-avbildningen och icke-OS-datadisken) placeras i den angivna lagringssökvägen.

    Om flaggan inte anges placeras arbetsbelastningsdata automatiskt i en lagringssökväg med hög tillgänglighet.

Avbildningsdistributionen tar några minuter att slutföra. Den tid det tar att ladda ned avbildningen beror på storleken på avbildningen i den lokala resursen och nätverksbandbredden som är tillgänglig för nedladdningen.

Här är exempel på utdata:

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>

Lista VM-avbildningar

Du måste visa listan över VM-avbildningar för att välja en avbildning att hantera.

Följ dessa steg om du vill visa vm-avbildningar med Hjälp av Azure CLI.

  1. Kör PowerShell som administratör.

  2. Ange några parametrar.

    $subscription = "<Subscription ID associated with your cluster>"
    $resource_group = "<Resource group name for your cluster>"
    
  3. Visa en lista över alla VM-avbildningar som är associerade med klustret. Kör följande kommando:

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

    Beroende på vilket kommando som används visas en motsvarande uppsättning avbildningar som är associerade med Azure Stack HCI-klustret.

    • Om du bara anger prenumerationen visar kommandot alla avbildningar i prenumerationen.
    • Om du anger både prenumerationen och resursgruppen visar kommandot alla avbildningar i resursgruppen.

    Dessa avbildningar omfattar:

    • VM-avbildningar från Marketplace-avbildningar.
    • Anpassade avbildningar som finns i ditt Azure Storage-konto eller finns i en lokal resurs i klustret eller en klient som är ansluten till klustret.

Här är ett exempel på utdata.

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>

Visa egenskaper för VM-avbildning

Du kanske vill visa egenskaperna för VM-avbildningar innan du använder avbildningen för att skapa en virtuell dator. Följ dessa steg för att visa bildegenskaperna:

Följ dessa steg om du vill använda Azure CLI för att visa egenskaper för en avbildning:

  1. Kör PowerShell som administratör.

  2. Ange följande parametrar.

    $subscription = "<Subscription ID>"
    $resource_group = "<Cluster resource group>"
    $mktplaceImage = "<Marketplace image name>"
    
  3. Du kan visa bildegenskaper på två olika sätt: ange ID eller ange namn och resursgrupp. Utför följande steg när du anger Avbildnings-ID för Marketplace:

    1. Ange följande parameter.

      $mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/myhci-marketplaceimage"
      
    2. Kör följande kommando för att visa egenskaperna.

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

      Här är ett exempel på utdata för det här kommandot:

      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> 
      

Ta bort VM-avbildning

Du kanske vill ta bort en VM-avbildning om nedladdningen misslyckas av någon anledning eller om avbildningen inte längre behövs. Följ de här stegen för att ta bort VM-avbildningarna.

  1. Kör PowerShell som administratör.

  2. Ange följande parametrar.

    $subscription = "<Subscription ID>"
    $resource_group = "<Cluster resource group>"
    $galleryImageName = "<Gallery image name>"    
    
  3. Ta bort en befintlig VM-avbildning. Kör följande kommando:

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

Du kan ta bort bilden på två sätt:

  • Ange namn och resursgrupp.
  • Ange ID.

När du har tagit bort en avbildning kan du kontrollera att avbildningen har tagits bort. Här är ett exempel på utdata när bilden togs bort genom att ange namnet och resursgruppen.

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>

Nästa steg