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

Применимо к: Azure Stack HCI версии 23H2

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

Предварительные требования

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

Azure CLI

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

• У вас есть доступ к развернутой системе Azure Stack HCI, у вас есть мост ресурсов Arc и настраиваемое расположение.

  • Перейдите на страницу Обзор > сервера в системном ресурсе Azure Stack HCI. Убедитесь, что в Azure Arc отображается значение Подключено. Вы также должны увидеть пользовательское расположение и мост ресурсов Arc для кластера.

    

• Для пользовательских образов в локальной общей папке в 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, у вас есть мост ресурсов Arc и настраиваемое расположение.

  • Перейдите на страницу Обзор > сервера в системном ресурсе Azure Stack HCI. Убедитесь, что в Azure Arc отображается значение Подключено. Вы также должны увидеть пользовательское расположение и мост ресурсов Arc для кластера.

    

• Для пользовательских образов в локальной общей папке в 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. Входные параметры проверяются. Если проверка прошла успешно, можно просмотреть сведения об образе виртуальной машины и нажать кнопку Создать.

   

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

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

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>

Портал 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>"
   $galleryImageName = "<Gallery 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. При появлении запроса на подтверждение удаления выберите Да.

   

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

Дальнейшие действия

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