Создание образа виртуальной машины Azure Stack HCI с помощью образов в локальной общей папке

Область применения: Azure Stack HCI версии 23H2

В этой статье описывается создание образов виртуальной машины для Azure Stack HCI с использованием исходных образов из локальной общей папки в кластере. Вы можете создавать образы виртуальных машин с помощью портал Azure или Azure CLI, а затем использовать эти образы виртуальных машин для создания виртуальных машин Arc в Azure Stack HCI.

Необходимые компоненты

Перед началом работы убедитесь, что выполнены следующие предварительные требования.

Azure CLI

• Обязательно просмотрите и завершите предварительные требования.

• Для пользовательских образов в локальной общей папке в Azure Stack HCI вам потребуется следующее дополнительное требование:

  • У вас должен быть VHD/VHDX, отправленный в локальную общую папку в кластере Azure Stack HCI.
  • Образ VHDX должен быть типом 2-го поколения и безопасной загрузкой.
  • Образ VHDX должен быть подготовлен с помощью sysprep /generalize /shutdown /oobe. Дополнительные сведения см. в разделе "Параметры командной строки Sysprep".
  • Образ должен находиться на общем томе кластера, доступном всем серверам в кластере. Поддерживаются операционные системы Windows и Linux.

• При использовании клиента для подключения к кластеру Azure Stack HCI см. статью "Подключение к Azure Stack HCI" через клиент Azure CLI.

Портал Azure

• Обязательно просмотрите и завершите предварительные требования.

• Для пользовательских образов в локальной общей папке в Azure Stack HCI вам потребуется следующее дополнительное требование:

  • У вас должен быть VHD/VHDX, отправленный в локальную общую папку в кластере Azure Stack HCI.
  • Образ VHDX должен быть типом 2-го поколения и безопасной загрузкой.
  • Образ VHDX должен быть подготовлен с помощью sysprep /generalize /shutdown /oobe. Дополнительные сведения см. в разделе "Параметры командной строки Sysprep".
  • Образ должен находиться на общем томе кластера, доступном всем серверам в кластере. Поддерживаются операционные системы Windows и Linux.

Добавление образа виртуальной машины из образа в локальной общей папке

Вы создаете образ виртуальной машины, начиная с образа в локальной общей папке кластера, а затем используете этот образ для развертывания виртуальных машин в кластере Azure Stack HCI.

Azure CLI

Выполните следующие действия, чтобы создать образ виртуальной машины с помощью Azure CLI.

Вход и установка подписки

1. Подключитесь к серверу в системе Azure Stack HCI.

2. Вход. Тип:

   az login --use-device-code
   

3. Задайте подписку.

   az account set --subscription <Subscription ID>
   

Задайте некоторые параметры.

1. Задайте подписку, группу ресурсов, расположение, тип ОС для образа. Замените параметры соответствующими < > значениями.

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

   Параметры описаны в следующей таблице.

   Параметр	Описание
   subscription	Группа ресурсов для кластера Azure Stack HCI, которую вы связываете с этим изображением.
   resource_group	Группа ресурсов для кластера Azure Stack HCI, которую вы связываете с этим изображением.
   location	Расположение для кластера Azure Stack HCI. Например, это может быть eastus.
   image-path	Имя образа виртуальной машины, созданного начиная с образа в локальной общей папке. Примечание. Azure отклоняет все имена, содержащие ключевое слово Windows.
   name	Путь к исходному образу коллекции (только VHDX) в кластере. Например, C:\OSImages\winos.vhdx. Ознакомьтесь с предварительными условиями исходного образа.
   os-type	Операционная система, связанная с исходным образом. Это может быть Windows или Linux.

   Ниже приведен пример выходных данных.

   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"
   

Создание образа виртуальной машины из образа в локальной общей папке

1. Выберите настраиваемое расположение для развертывания образа виртуальной машины. Пользовательское расположение должно соответствовать пользовательскому расположению для кластера Azure Stack HCI. Получите идентификатор пользовательского расположения для кластера Azure Stack HCI. Выполните следующую команду:

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

2. Создайте образ виртуальной машины, начиная с указанного образа в локальной общей папке в кластере 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
   
   

   Задание развертывания запускается для образа виртуальной машины.

   В этом примере путь к хранилищу был указан с помощью --storage-path-id флага и убедитесь, что данные рабочей нагрузки (включая виртуальную машину, образ виртуальной машины, диск данных, отличные от ОС), помещаются в указанный путь к хранилищу.

   Если флаг не указан, данные рабочей нагрузки автоматически помещаются в путь хранилища высокого уровня доступности.

Развертывание образа занимает несколько минут. Время загрузки образа зависит от размера образа в локальной общей папке и пропускной способности сети, доступной для скачивания.

Ниже приведен пример выходных данных.

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

Вы можете создать образ виртуальной машины, скачав образ, который находится в локальной общей папке в кластере Azure Stack HCI, а затем используйте этот образ виртуальной машины для развертывания виртуальной машины.

В портал Azure ресурса кластера Azure Stack HCI выполните следующие действия.

1. Перейдите к образам виртуальных машин ресурсов>.

2. Выберите +Добавить образ виртуальной машины и в раскрывающемся списке выберите " Добавить образ виртуальной машины" из локальной общей папки.

   

3. На вкладке "Основные сведения" на вкладке "Создание изображения" введите следующие сведения:

   1. Подписка. Выберите подписку, связанную с образом виртуальной машины.

   2. Группа ресурсов. Создайте новую или выберите существующую группу ресурсов, связанную с образом виртуальной машины.

   3. Сохраните изображение как. Введите имя образа виртуальной машины.

   4. Пользовательское расположение. Выберите настраиваемое расположение для развертывания образа виртуальной машины. Пользовательское расположение должно соответствовать пользовательскому расположению для кластера Azure Stack HCI.

   5. Тип ОС. Выберите ОС образа как Windows или Linux. Это ОС, связанная с изображением в учетной записи хранения.

   6. Создание виртуальной машины. Выберите поколение для образа.

   7. Источник. Источник изображения должен быть локальным файловый ресурс и автоматически заполняется.

   8. Путь к локальной общей папке. Укажите локальный путь к общей папке для исходного образа в кластере HCI.

   9. Путь к хранилищу. Выберите путь к хранилищу образа виртуальной машины. Выберите "Выбрать автоматически ", чтобы путь к хранилищу с высоким уровнем доступности был выбран автоматически. Выберите "Выбрать вручную ", чтобы указать путь к хранилищу образов виртуальных машин и файлов конфигурации в кластере Azure Stack HCI. В этом случае убедитесь, что указанный путь к хранилищу имеет достаточно места для хранения.

4. Нажмите кнопку "Проверить и создать", чтобы создать образ виртуальной машины.

   

5. Входные параметры проверяются. Если проверка выполнена успешно, можно просмотреть сведения о образе виртуальной машины и выбрать команду "Создать".

   

   Задание развертывания шаблона Azure Resource Manager начинается для образа виртуальной машины. Развертывание образа занимает несколько минут. Время загрузки образа зависит от размера пользовательского образа и пропускной способности сети, доступной для скачивания.

   Развертывание образа можно отслеживать в сетке образов виртуальной машины. Список образов виртуальных машин, которые уже загружены и которые загружаются в кластере.

6. Когда скачивание образа завершится, образ виртуальной машины отображается в списке образов, а состояние отображается как доступное. Чтобы просмотреть дополнительные сведения о любом образе, выберите имя образа виртуальной машины из списка образов виртуальных машин.

Вывод списка образов виртуальных машин

Чтобы выбрать образ для управления, необходимо просмотреть список образов виртуальных машин.

Azure CLI

Выполните следующие действия, чтобы перечислить образ виртуальной машины с помощью Azure CLI.

1. Запустите PowerShell с правами администратора.

2. Задайте некоторые параметры.

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

3. Список всех образов виртуальных машин, связанных с кластером. Выполните следующую команду:

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

   В зависимости от используемой команды перечислены соответствующие наборы образов, связанных с кластером Azure Stack HCI.

   • Если указать только подписку, команда перечисляет все изображения в подписке.
   • Если указать подписку и группу ресурсов, команда выводит список всех образов в группе ресурсов.

   К этим изображениям относятся:

   • Образы виртуальных машин из образов Marketplace.
   • Пользовательские образы, которые находятся в учетной записи служба хранилища Azure или находятся в локальной общей папке в кластере или клиенте, подключенном к кластеру.

Ниже приведен пример выходных данных.

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>

Дополнительные сведения об этой команде CLI см. в списке образов az stack-hci-vm.

Портал Azure

В портал Azure ресурса кластера Azure Stack HCI можно отслеживать развертывание образа виртуальной машины в сетке образов виртуальной машины. Список образов виртуальных машин, которые уже загружены и которые загружаются в кластере.

Выполните следующие действия, чтобы просмотреть список образов виртуальных машин в портал Azure.

1. В портал Azure перейдите к ресурсу кластера Azure Stack HCI.

2. Перейдите к образам виртуальных машин ресурсов>.

3. В правой области можно просмотреть список образов виртуальных машин.

   

Просмотр свойств образа виртуальной машины

Вам может потребоваться просмотреть свойства образов виртуальных машин, прежде чем использовать образ для создания виртуальной машины. Выполните следующие действия, чтобы просмотреть свойства изображения:

Azure CLI

Выполните следующие действия, чтобы использовать Azure CLI для просмотра свойств изображения:

1. Запустите PowerShell с правами администратора.

2. Задайте следующие параметры.

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

3. Свойства изображения можно просматривать двумя способами: указать идентификатор или указать имя и группу ресурсов. При указании идентификатора образа Marketplace выполните следующие действия.

   1. Задайте следующий параметр.

      $mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/myhci-marketplaceimage"
      

   2. Выполните следующую команду, чтобы просмотреть свойства.

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

      Ниже приведен пример выходных данных для этой команды:

      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

В портал Azure ресурса кластера Azure Stack HCI выполните следующие действия.

1. Перейдите к образам виртуальных машин ресурсов>. В правой области отображается список образов виртуальных машин.

   

2. Выберите имя образа виртуальной машины, чтобы просмотреть свойства.

   

Удаление образа виртуальной машины

Может потребоваться удалить образ виртуальной машины, если скачивание завершается сбоем по какой-либо причине или если образ больше не нужен. Выполните следующие действия, чтобы удалить образы виртуальных машин.

Azure CLI

1. Запустите PowerShell с правами администратора.

2. Настройте следующие параметры:

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

3. Удалите существующий образ виртуальной машины. Выполните следующую команду:

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

Вы можете удалить изображение двумя способами:

• Укажите имя и группу ресурсов.
• Укажите идентификатор.

После удаления образа можно убедиться, что изображение удалено. Ниже приведен пример выходных данных при удалении образа, указав имя и группу ресурсов.

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

В портал Azure ресурса кластера Azure Stack HCI выполните следующие действия.

1. Перейдите к образам виртуальных машин ресурсов>.

2. В списке образов виртуальных машин, отображаемых в правой области, выберите значок корзины рядом с образом виртуальной машины, который требуется удалить.

   

3. При появлении запроса на подтверждение удаления нажмите кнопку "Да".

   

После удаления образа виртуальной машины список образов виртуальных машин обновляется, чтобы отразить удаленный образ.

Следующие шаги

• Создание логических сетей