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

Статья
08/24/2024

Внимание

Эта статья ссылается на CentOS, дистрибутив Linux, который является состоянием "Конец жизни" (EOL). Обратите внимание на использование и план соответствующим образом. Дополнительные сведения см. в руководстве centOS End Of Life.

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

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

Возможность "Коллекция вычислений Azure" имеет несколько типов ресурсов.

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

Подготовка к работе

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

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

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

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

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

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

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

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

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

Коллекция сообщества

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

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

Внимание

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

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

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

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

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

Перейдите на портал Azure, а затем найдите и выберите службу Коллекция вычислений Azure.
Выберите в списке необходимую коллекцию.
На странице коллекции выберите Добавить в верхней части страницы, а затем в раскрывающемся списке выберите пункт Определение образа виртуальной машины.
На странице Add new image definition to Azure Compute Gallery (Добавление определения нового образа в Коллекцию вычислений Azure) выберите на вкладке Основные сведения значение в поле Регион.
В качестве Имени определения образа введите имя, например myImageDefinition.
В поле Операционная система выберите нужный вариант на основе источника.
В поле Поколение виртуальной машины выберите вариант на основе источника. Как правило, это Поколение 1. См. сведения о поддержке 2-го поколения виртуальных машин.
В поле Состояние операционной системы выберите вариант на основе источника. Дополнительные сведения см. в разделе Универсальные и специализированные.
В поле Издатель введите уникальное имя, например myPublisher.
В поле Предложение введите уникальное имя, например myOffer.
Для SKU укажите уникальное имя, например mySKU.
В нижней части страницы выберите Просмотр + создать (Review + create).
После того как определение образа пройдет проверку, нажмите кнопку Создать.
Когда развертывание будет завершено, выберите Перейти ресурсу.
На странице определения образа на вкладке Начало работы выберите Создать версию.
В поле Регион выберите регион, в котором требуется создать образ. В некоторых случаях требуется, чтобы источник находился в том же регионе, в котором создается образ. Если ваш источник отсутствует в последующих раскрывающихся списках, попробуйте изменить регион для образа. Вы сможете реплицировать образ в другие регионы позже.
В поле Номер версии введите номер, например 1.0.0. Имя версии образа должно соответствовать формату основная.дополнительная.исправление с использованием целых чисел.

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

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

В поле Исключить из последних оставьте значение по умолчанию Нет, если не хотите, чтобы для версии, применяемой при создании виртуальной машины, использовалось latest вместо номера версии.
В поле Дата окончания жизненного цикла в календаре выберите дату прекращения использования этой версии.
На вкладке Репликация выберите тип хранилища из раскрывающегося списка.
Задайте Число реплик по умолчанию, параметр можно переопределить для каждого добавляемого региона.
Необходимо выполнить репликацию в исходный регион, поэтому первая реплика в списке будет находиться в регионе, в котором вы создали образ. Чтобы добавить реплики, выберите регион из раскрывающегося списка и настройте число реплик по мере необходимости.
Когда все будет готово, нажмите кнопку Просмотр и создание. Azure проверит конфигурацию.
После окончания проверки версии образа выберите Создать.
Когда развертывание будет завершено, выберите Перейти ресурсу.

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

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

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

Создайте в коллекции определение образа, используя команду 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

Примечание.

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

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

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

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 \
   --managed-image "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Примечание.

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

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

Образы можно объединять в логические группы с помощью определений образов. При создании определения образа убедитесь, что все сведения там правильные. Если исходная виртуальная машина была сделана универсальной, создайте определение образа с помощью -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 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 исходный образ. Кроме того, необходимо убедиться, что регион исходного образа или реплика и целевой регион совпадают.

CLI
PowerShell

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

# Login to the subscription where the new image will be created
az login

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

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

# Create the image
az sig image-version create `
   --gallery-image-definition myImageDef `
   --gallery-image-version 1.0.0 `
   --gallery-name myGallery `
   --resource-group myResourceGroup `
   --image-version $sourceImageID
   --location myLocation

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

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

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

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

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

Подробнее о предоставлении сведений о плане покупки см. в разделе Предоставление сведений о плане покупки Azure Marketplace при создании образов.

Поделиться через

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

Подготовка к работе

Коллекция сообщества

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

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

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

Обратная связь

Дополнительные ресурсы