Как превратить ВМ в образ

Когда использовать

Когда настроенную машину нужно тиражировать: превратить её в образ ОС и создавать из него новые ВМ с тем же содержимым диска.

Это конверсия, а не копия. Загрузочный диск ВМ становится образом каталога, а сама ВМ и все её снимки удаляются. Диск не копируется, поэтому образ готов быстро — за время, которое уходит на переименование тома, а не на перенос гигабайт. Обратного пути нет: превратить образ обратно в ВМ нельзя.

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

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

Предусловия

• Права. Нужны обе привилегии: Create Image From VM и Remove VM, каждая — глобально или в ВЦОД (виртуальном центре обработки данных) этой ВМ. Права из разных ВЦОД не складываются. Чтобы пункт появился в меню и ход был виден в «Image library», нужна ещё View Image Catalog. Образ, общий для всего кластера, создаёт только роль Cluster master: для него обе привилегии нужны глобально.
• ВМ остановлена. Работающую машину конверсия не принимает.
• ВМ не занята другой операцией или миграцией.
• У ВМ только загрузочный диск. Диски данных отсоедините или удалите.
• Из ВМ не склонированы другие машины. Сначала удалите эти клоны.
• Сама ВМ — не тонкий клон другой ВМ. Машину, созданную клонированием другой машины, превратить в образ нельзя. Машина, созданная из образа каталога, подходит.
• ВМ не служебная. Служебные машины кластера, например edge-маршрутизаторы, в образ не превращаются.
• Гостевая ОС подготовлена. Иначе новые машины из образа унаследуют идентичность исходной и не пройдут первичную настройку. Как это сделать — для Windows и для Linux.

Шаги

1. Подготовьте гостевую ОС и остановите ВМ — по инструкции для Windows или Linux.

2. Откройте карточку ВМ, нажмите «Actions» и в подменю «Additional actions» выберите «Convert to image». Пока ВМ работает, пункт неактивен с подсказкой «Stop the VM first», у тонкого клона другой ВМ — с подсказкой «A clone of another VM cannot be converted to an image», во время миграции — без подсказки. Без любой из привилегий Create Image From VM, Remove VM, View Image Catalog и у служебной ВМ пункта нет.

   

3. Заполните форму.

   Поле	Что ввести
   «Image name»	до 64 символов: строчные латинские буквы, цифры, точка, дефис, подчёркивание. Имя может совпадать с именем другого образа: образы различаются идентификатором
   «Description»	необязательно, до 64 символов

   Имя ВМ, которое уже подходит под эти правила, форма подставляет сама.

4. Выберите, где будет доступен образ. Роль Cluster master видит выбор «Where the image will be available»:

   • «Only data center «‹имя ВЦОД›»» — образ принадлежит ВЦОД исходной ВМ, его видят только этот ВЦОД и Cluster master. Этот вариант выбран по умолчанию;
   • «Whole cluster» — образ общий для кластера. Форма предупреждает: «Keys, passwords and other data inside the VM become available to every data center». Всё, что осталось внутри гостевой ОС, станет доступно каждому ВЦОД, который создаст ВМ из этого образа.

   

   

   Администратор ВЦОД выбора не видит: его образ всегда остаётся в ВЦОД исходной ВМ, о чём форма пишет «Available in this VM's data center».

5. Подтвердите. Форма предупреждает: «VM ‹имя› and all its snapshots will be deleted. This cannot be undone». Нажмите «Convert». Кнопка «Cancel» оставляет ВМ без изменений.

6. Дождитесь исхода. После приёма появляется уведомление «Conversion of VM ‹имя› has started», и открывается раздел «Image library» с выделенным новым образом. Пока идёт конверсия, образ в состоянии «Importing» — без шкалы копирования, потому что копировать нечего. Затем образ переходит в состояние «Available», а ВМ исчезает из списка машин.

Проверка результата

Что смотреть	Ожидаемое
Образ в «Image library»	состояние «Available», образ лежит на пуле исходной ВМ
Исходная ВМ	исчезла из списка машин вместе со снимками
Журнал безопасности	события config.image_from_vm_initiated, vm.converted_to_image, vm.deleted и config.image_from_vm_done

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

Если не получилось

Конверсия не началась

Отказ приходит до любых изменений: ВМ, её диски и снимки остаются как были.

Код	Что означает	Что сделать
-48014	ВМ не остановлена	остановить ВМ и повторить
-48015	ВМ занята другой операцией или её уже превращают в образ	дождаться окончания операции; повторно не отправлять
-1611	по ВМ идёт миграция	дождаться окончания миграции
-48017	у ВМ есть диски данных; интерфейс перечисляет их: «Detach or delete the data disks and retry»	отсоединить или удалить эти диски
-48018	из ВМ склонированы другие машины; интерфейс перечисляет их: «Delete the VMs cloned from this one first»	удалить клоны
-48023	ВМ — тонкий клон другой ВМ	превратить в образ нельзя; взять машину, созданную из образа каталога
-48016	ВМ служебная	превратить в образ нельзя
-48013	ВМ не найдена или не видна вызывающему	сверить ВМ и область доступа
-48021	ВМ сменила ВЦОД во время операции	повторить
-403	не хватает прав; интерфейс пишет «You need both permissions: create images and delete this VM»	получить обе привилегии в ВЦОД ВМ или глобально; для «Whole cluster» — обе глобально
-503	журнал безопасности не принял запись о намерении	восстановить доступность журнала и повторить
-32602	описание длиннее 64 символов или имя не по правилам	исправить поля формы

Конверсия не удалась после приёма

Образ переходит в состояние «Failure», у него видна причина. Во всех случаях ВМ и её загрузочный диск целы, ВМ остановлена и разблокирована, но снимки ВМ могли быть уже удалены.

Причина (fail_reason)	Что произошло	Что сделать
snapshot_held	снимок ВМ удерживает резервное копирование; интерфейс пишет «A backup holds a VM snapshot…»	дождаться окончания резервного копирования и повторить
hygiene_failed	не удалось удалить снимки ВМ	повторить; если сбой повторяется — обратиться в поддержку
rename_refused	узел хранения отказался переименовать том — например, агент хранения на узле пула не поддерживает переименование	проверить версию агента хранения на узле пула и повторить; если отказ повторяется — обратиться в поддержку
conversion_interrupted	диспетчер кластера перезапустился до переименования тома	повторить

Для последних трёх интерфейс пишет «Conversion failed. The VM and its disk are intact; its snapshots may be deleted». Строку неудавшегося образа можно удалить как обычный образ.

ВМ и образ зависли

Если узел отказал так, что операция требует ручного разбора, образ остаётся в состоянии «Importing», а ВМ — под блокировкой. Через час статус ВМ становится «Delete failed». Обратитесь в поддержку.

Ответ не пришёл

Если ответ потерялся по дороге (таймаут шлюза -10500, обрыв связи), не повторяйте запрос и не нажимайте «Convert» в оставшейся открытой форме. Пока конверсия идёт, повтор получит отказ «ВМ не остановлена» или «ВМ занята», а после неудачной конверсии запустит новую. Закройте форму и найдите в «Image library» новую строку с этим именем — по ней виден ход конверсии.

Образ нельзя удалить

ВМ, созданная из образа каталога, связана с ним: её диск — клон этого образа. После конверсии связь переворачивается. Новый образ становится корнем цепочки, а исходный образ каталога — его зависимым. Поэтому новый образ нельзя удалить, пока существует исходный. При удалении интерфейс называет видимые образы-держатели в списке «Dependent images», а если они не видны — пишет «Another image depends on this one».

См. также

• Библиотека образов ОС — модель каталога, владение и видимость образов.
• Как подготовить Windows-ВМ к превращению в образ.
• Как подготовить Linux-ВМ к превращению в образ.
• Как удалить образ ОС — зависимости и удаление.
• Как делать снимки ВМ и откатываться к ним.

Методы API

Операции этой страницы в API: os-image-from-vm, golden-images-list, golden-image-clones, golden-image-remove, security-event-list — см. Справочник API.