Создание определения образа и версии образа

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

Галерея вычислительных ресурсов Azure позволяет совместно использовать пользовательские образы виртуальных машин с другими пользователями в организации, в пределах или за пределами регионов, в пределах арендатора Microsoft Entra, или публично с помощью галереи сообщества. Выберите изображения, которые хотите поделиться, регионы, где они будут доступны, и с кем вы хотите их поделиться. Вы можете создать несколько коллекций, чтобы можно было логически группировать образы. Многие новые функции, такие как ARM64, ускоренная сеть и TrustedVM, поддерживаются только через коллекцию вычислений Azure и недоступны для управляемых образов.

Функция коллекции вычислений Azure имеет несколько типов ресурсов:

Ресурс	Описание
Источник образа	Это ресурс, который можно использовать для создания версии образа в коллекции. Источник образа может быть существующей виртуальной машиной Azure, которая либо унифицированная или специализированная, управляемым образом, снимком или версией образа в другой галерее.
Галерея	Как и Azure Marketplace, gallery — это репозиторий для управления изображениями и VM-приложений, но вы управляете доступом.
Определение образа	Определения образов создаются в галерее и содержат сведения об образе и требования для его внутреннего использования. В это входит информация о принадлежности образа к Windows или Linux, примечания к выпуску, а также минимальные и максимальные требования к памяти. Это определение типа образа.
Версия образа	Версия образа используется для создания виртуальной машины с помощью коллекции. В зависимости от требований для вашей среды, у вас может быть несколько версий образа. Так же как и управляемый образ при использовании версии образа для создания виртуальной машины, версия образа используется для создания новых дисков для виртуальной машины. Версии образов можно использовать несколько раз.

Необходимые условия

Чтобы завершить эту статью, необходимо иметь существующую галерею вычислительных ресурсов Azure и источник образа виртуальной машины, доступный в Azure. Источниками изображений могу быть:

• Виртуальная машина в вашей подписке. Вы можете создать снимок с помощью специализированных и обобщённых виртуальных машин.
• Управляемый образ.
• Управляемые диски ОС и данные.
• Диски ОС и данных в качестве виртуальных жестких дисков в учетной записи хранения.
• Другие версии изображений в этой или другой галерее в той же подписке.

Если образ содержит диск данных, то размер диска данных не должен превышать 1 ТБ.

В имени определения образа можно использовать прописные и строчные буквы, цифры, точки и дефисы. Дополнительные сведения о значениях, которые можно указать для определения образа, см. в разделе Определения образов.

Допустимыми символами для имени версии образа являются цифры и точки. Числа должны быть в диапазоне 32-битного целого числа. Формат: Мажорная версия.Минорная версия.Патч.

При работе со статьей по мере необходимости заменяйте имена ресурсов.

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

• Linux

  • Универсальные шаги
  • CentOS
  • Debian
  • Flatcar
  • FreeBSD
  • Oracle Linux
  • OpenBSD
  • Red Hat
  • SUSE
  • Ubuntu

• Windows

  Если вы планируете запустить Sysprep перед отправкой виртуального жесткого диска (VHD) в Azure в первый раз, убедитесь, что вы подготовьте виртуальную машину.

Галерея сообщества

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

Когда пользователи выполняют поиск образов из коллекции сообщества, отображается только последняя версия образа.

Внимание

Сведения из определений образов будут общедоступными, например данные, указанные в полях Издатель, Предложение и Номер SKU.

Создание образа

Выберите один из вариантов ниже для создания определения и версии образа.

Портал

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

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

1. Перейдите на портал Azure, а затем найдите и выберите коллекцию вычислений Azure.

2. Выберите в списке галерею, которую хотите использовать.

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

4. На странице Add new image definition to Azure Compute Gallery на вкладке Basics выберите Region.

5. В качестве Имени определения образа введите имя, например myImageDefinition.

6. В поле Операционная система выберите нужный вариант на основе источника.

7. В поле Поколение виртуальной машины выберите вариант на основе источника. Как правило, это Поколение 1. См. сведения о поддержке 2-го поколения виртуальных машин.

8. В поле Состояние операционной системы выберите вариант на основе источника. Дополнительные сведения см. в разделе Универсальные и специализированные.

9. Для Publisher введите уникальное имя, например myPublisher.

10. В поле Предложение введите уникальное имя, например myOffer.

11. Для SKU укажите уникальное имя, например mySKU.

12. В нижней части страницы выберите Просмотр + создать.

13. После того как определение образа пройдет проверку, нажмите кнопку Создать.

14. Когда развертывание будет завершено, выберите Перейти к ресурсу.

15. На странице определения образа на вкладке Начало работы выберите Создать версию.

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

17. В поле Номер версии введите номер, например 1.0.0. Имя версии образа должно соответствовать формату major.minor.patch с использованием целых чисел.

18. В поле Источник в раскрывающемся списке выберите тип файла, который используется для источника. Подробные сведения о каждом типе источника см. в таблице ниже.

    Источник	Другие поля
    Диски или моментальные снимки	— Для поля Диск ОС выберите диск или моментальный снимок из выпадающего списка. — Чтобы добавить диск данных, введите номер LUN, а затем выберите диск данных из раскрывающегося списка.
    Версия образа	— Выберите Галерею источников из раскрывающегося списка. — Выберите правильное определение образа из раскрывающегося списка. — Выберите из раскрывающегося списка существующую версию образа, которую необходимо использовать.
    Управляемый образ	— Выберите Источник образа из раскрывающегося списка. Управляемый образ должен находиться в том же регионе, который вы выбрали в Сведениях об экземпляре.
    VHD в учетной записи хранения	Щелкните Обзор, чтобы выбрать учетную запись хранения для VHD.

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

20. В поле Дата окончания жизненного цикла в календаре выберите дату прекращения использования этой версии.

21. На вкладке Репликация выберите тип хранилища из раскрывающегося списка.

22. Задайте Число реплик по умолчанию, параметр можно переопределить для каждого добавляемого региона.

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

24. Когда все будет готово, нажмите кнопку Просмотр и создание. Azure проверит конфигурацию.

25. После окончания проверки версии образа выберите Создать.

26. Когда развертывание будет завершено, выберите Перейти к ресурсу.

Копирование образа во все целевые регионы может занять некоторое время.

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

CLI

Чтобы создать изображение с помощью Azure CLI, сначала необходимо создать определение изображения. Образы можно объединять в логические группы с помощью определений образов. Они используются для управления сведениями о версиях образов, которые создаются в них.

Создайте в коллекции определение образа, используя команду az sig image-definition create. Убедитесь, что ваше определение образа соответствует нужному типу. Если вы обобщили виртуальную машину (используя waagent -deprovision для Linux или Sysprep для Windows), необходимо создать обобщённое определение образа с помощью --os-state generalized. Если вы хотите использовать виртуальную машину без удаления существующих учетных записей пользователей, создайте специализированное определение образа с помощью --os-state specialized.

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

В этом примере определение образа имеет имя myImageDefinition и предназначено для специализированного образа ОС Linux. Чтобы создать определение изображений с помощью ОС Windows, используйте --os-type Windows.

az sig image-definition create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --publisher myPublisher \
   --offer myOffer \
   --sku mySKU \
   --os-type Linux \
   --os-state specialized

Примечание.

Для определений образов, которые будут включать образы, производные от сторонних изображений с торговой площадки, сведения о плане должны строго точно соответствовать сведениям о плане стороннего изображения. Включите сведения о плане в определение образа, добавив --plan-name, --plan-product и --plan-publisher при создании определения образа.

Создайте версию образа

Создайте версию образа с помощью команды az sig image-version create.

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

Источник	Набор параметров
Диск ОС:
ВМ, использующая идентификатор ВМ	--managed-image <Resource ID of the VM>
Управляемый образ или альтернативная версия образа	--managed-image <Resource ID of the managed image or image version
Моментальный снимок или управляемый диск	--os-snapshot <Resource ID of the snapshot or managed disk>
VHD в учетной записи хранения	--os-vhd-uri <URI> --os-vhd-storage-account <storage account name>.
Диск данных:
Моментальный снимок или управляемый диск	--data-snapshots <Resource ID of the snapshot or managed disk> --data-snapshot-luns <LUN number>
VHD в учетной записи хранения	--data-vhds-sa <storageaccountname> --data-vhds-uris <URI> --data-vhds-luns <LUN number>

Для подробных примеров, как указать различные источники для вашего образа, см. примеры az sig image-version create.

В приведенном ниже примере мы создаем образ из виртуальной машины. Для образа указана версия 1.0.0, и мы собираемся создать 2 реплики в регионе центрально-западная часть США, 1 реплику в регионе центрально-южная часть США и 1 реплику в регионе восточная часть США 2, используя хранилище, избыточное между зонами. В числе регионов репликации должен быть регион, в котором находится исходная виртуальная машина.

Перед созданием образа рекомендуется остановить или освободить виртуальную машину.

Замените значение параметра --virtual-machine в этом примере на идентификатор вашей виртуальной машины.

az sig image-version create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --target-regions "westcentralus" "southcentralus=1" "eastus=1=standard_zrs" \
   --replica-count 2 \
   --virtual-machine "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Примечание.

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

Вы также можете сохранить образ в хранилище класса Premium, добавив --storage-account-type premium_lrs, или в зоне избыточного хранилища, добавив --storage-account-type standard_zrs при создании версии образа.

PowerShell

Чтобы создать образ с помощью PowerShell, сначала необходимо создать определение образа. Образы можно объединять в логические группы с помощью определений образов. При создании определения образа убедитесь, что все сведения там правильные. Если исходная виртуальная машина была сделана универсальной, создайте определение образа с помощью -OsState generalized. Если вы не сделали источник более общим, создайте описание образа с помощью -OsState specialized.

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

Создайте определение образа с помощью командлета New-AzGalleryImageDefinition.

В этом примере определение образа называется myImageDefinition и предназначено для специализированной виртуальной машины, работающей Windows. Чтобы создать определение для образов с помощью Linux, используйте -OsType Linux.

$imageDefinition = New-AzGalleryImageDefinition `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -Name 'myImageDefinition' `
   -OsState specialized `
   -OsType Windows `
   -Publisher 'myPublisher' `
   -Offer 'myOffer' `
   -Sku 'mySKU'

Примечание.

Для определений образов, которые будут содержать образы, производные от сторонних образов, сведения о плане должны точно соответствовать сведениям о плане из стороннего образа. Включите сведения о плане в определение образа, добавив -PurchasePlanName, -PurchasePlanProduct и -PurchasePlanPublisher при создании определения образа.

Создать версию изображения

Создайте версию образа, используя командлет New-AzGalleryImageVersion.

Синтаксис для создания образа будет зависеть от используемого источника.

Источник	Набор параметров
Диск ОС
Виртуальная машина, использующая идентификатор виртуальной машины	-SourceImageId <Resource ID of the VM>
Управляемый образ или другая версия образа	-SourceImageId <Resource ID of the managed image or image version
Моментальный снимок или управляемый диск	-OSDiskImage <Resource ID of the snapshot or managed disk>
Диск данных
Моментальный снимок или управляемый диск	-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }

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

В этом примере используется версия образа 1.0.0, которая реплицируется в центры обработки данных в регионах центрально-западная часть США и центрально-южная часть США. При выборе целевых регионов для репликации помните, что также необходимо включить исходный регион в качестве целевого объекта для репликации.

   $region1 = @{Name='South Central US';ReplicaCount=1}
   $region2 = @{Name='East US';ReplicaCount=2}
   $targetRegions = @($region1,$region2)

$job = $imageVersion = New-AzGalleryImageVersion `
   -GalleryImageDefinitionName $imageDefinition.Name`
   -GalleryImageVersionName '1.0.0' `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -TargetRegion $targetRegions  `
   -SourceImageId $sourceVm.Id.ToString() `
   -PublishingProfileEndOfLifeDate '2020-12-01' `  
   -asJob 

Репликация образа во все целевые регионы может занять некоторое время, поэтому мы создали задание, чтобы отслеживать ход выполнения. Чтобы просмотреть ход выполнения задания, введите $job.State.

$job.State

Примечание.

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

Вы также можете сохранить образ в хранилище уровня Premium, добавив -StorageAccountType Premium_LRS, или в избыточное хранилище по зонам, добавив -StorageAccountType Standard_ZRS при создании версии образа.

REST

Создайте определение образа с помощью REST API.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}?api-version=2019-12-01

{
    "location": "eastus",
    "properties": {
        "hyperVGeneration": "V1",
        "identifier": {
            "offer": "myOffer",
            "publisher": "myPublisher",
            "sku": "mySKU"
        },
        "osState": "Specialized",
        "osType": "Linux",
    },
}

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

# @name imageVersion
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}/versions/{galleryImageVersionName}?api-version=2019-12-01

{
    "location": "{region}",
    "properties": {
        "publishingProfile": {
            "endOfLifeDate": "2024-12-02T00:00:00+00:00",
            "replicaCount": 1,
            "storageAccountType": "Standard_ZRS",
            "targetRegions": [
                {
                    "name": "eastus",
                    "regionalReplicaCount": 2,
                    "storageAccountType": "Standard_LRS",
                },
                {
                    "name": "westus2",
                }
            ]
        },
        "storageProfile": {
            "source": {
                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}"
            }
        }
    }
}

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

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

Вам потребуется tenantID идентификатор версии исходного образа, идентификатор подписки subscriptionID, в которой будет храниться новая версия образа (целевая), а также resourceID версия исходного образа. Определение образа целевой галереи уже должно существовать перед созданием версии образа с az sig image-version create или New-AzGalleryImageVersion. Кроме того, убедитесь, что регион или реплика исходного образа и целевой регион совпадают.

CLI

Используйте Azure CLI для создания версии образа в одном клиенте с помощью исходной версии образа в другом клиенте.

# Set some variables
tenantID="<tenant ID for the source image version>"
subID="<subscription ID where the image version will be created>"
sourceImageVersionID="<resource ID of the source image version>"

# Sign in to the subscription where the new image version will be created
az login

# Sign in to the tenant where the source image version is available
az login --tenant $tenantID

# Sign back in to the subscription where the image version will be created and ensure subscription context is set
az login
az account set --subscription $subID

# Create the image version from the source image version
az sig image-version create \
   --gallery-image-definition myImageDef \
   --gallery-image-version 1.0.0 \
   --gallery-name myGallery \
   --resource-group myResourceGroup \
   --image-version $sourceImageVersionID \
   --location myLocation

PowerShell

Используйте PowerShell для создания версии образа в одном клиенте с помощью исходной версии образа в другом клиенте.

# Set variables
$targetSubID = "<subscription ID for the target>"
$sourceTenantID = "<tenant ID for the source image version>"
$sourceImageVersionID = "<resource ID of the source image version>"

# Sign in to the tenant where the source image version is published
Connect-AzAccount -Tenant $sourceTenantID -UseDeviceAuthentication

# Sign in to the subscription where the new image version will be created and set the context
Connect-AzAccount -UseDeviceAuthentication -Subscription $targetSubID
Set-AzContext -Subscription $targetSubID

# Create the image version from the source image version in a different tenant
New-AzGalleryImageVersion -ResourceGroupName myResourceGroup -GalleryName myGallery -GalleryImageDefinitionName myImageDef -Location "West US 2" -Name 1.0.0 -SourceImageId $sourceImageVersionID

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

Сведения о том, как предоставлять информацию о плане покупки, см. в разделе Предоставление сведений о плане покупки Azure Marketplace при создании изображений.