Создать образ из диска
Чтобы создать образ из диска:
Примечание
С помощью консоли управления вы можете создать образы из сетевых SSD- и HDD-дисков. Чтобы создать образ из нереплицируемого SSD-диска или сверхбыстрого сетевого хранилища с тремя репликами (SSD), используйте интерфейсы CLI, Terraform или API.
-
В консоли управления
выберите каталог, в котором нужно создать образ. -
В списке сервисов выберите Compute Cloud.
-
На панели слева выберите
Диски. -
В строке с нужным диском нажмите значок
и выберите Создать образ. -
Введите имя образа. Требования к имени:
- длина — от 2 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
-
При необходимости укажите произвольное текстовое описание образа.
-
Разверните блок Дополнительно.
-
(Опционально) В поле Поколение оборудования выберите нужное поколение виртуализированного оборудования, которое будет закреплено за создаваемым образом:
Gen 1.2 (MBR, BIOS)
— поколениеGen 1.2
.Gen 1.1 (MBR, BIOS)
— поколениеGen 1.1
.
Если вы не зададите поколение оборудования, по умолчанию за создаваемым образом будет закреплено то же поколение, что и за диском-источником.
-
(Опционально) Чтобы создать оптимизированный образ, включите опцию Оптимизация.
-
Нажмите Создать.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>
. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name
или --folder-id
.
-
Посмотрите описание команды CLI для создания образа:
yc compute image create --help
-
Получите список дисков в каталоге по умолчанию:
yc compute disk list
Результат:
+----------------------+--------------+-------------+-------------------+--------+----------------------+-----------------+-------------+ | ID | NAME | SIZE | ZONE | STATUS | INSTANCE IDS | PLACEMENT GROUP | DESCRIPTION | +----------------------+--------------+-------------+-------------------+--------+----------------------+-----------------+-------------+ | a7lqgbt0bb9s******** | first-disk | 20401094656 | ru-central1-a | READY | a7lcvu28njbh******** | | | | a7lv5j5hm1p1******** | second-disk | 21474836480 | ru-central1-a | READY | | | | +----------------------+--------------+-------------+-------------------+--------+----------------------+-----------------+-------------+
-
Выберите идентификатор (
ID
) или имя (NAME
) нужного диска. -
Создайте образ в каталоге по умолчанию:
yc compute image create \ --name <имя_создаваемого_образа> \ --source-disk-name <имя_диска-источника> \ --pooled \ --hardware-generation-id <поколение_оборудования> \ --hardware-features pci_topology=<топология_PCI>
Где:
-
--name
— имя создаваемого образа. Требования к имени:- длина — от 2 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
-
--source-disk-name
— имя диска-источника. Вместо имени вы можете передать в команду идентификатор диска-источника в параметре--source-disk-id
. -
--pooled
— параметр, позволяющий создать оптимизированный образ. Необязательный параметр. -
--hardware-generation-id
— поколение виртуализированного оборудования, закрепляемое за образом. Необязательный параметр. Возможные значения:legacy
— поколениеGen 1
. При выборе этого поколения вы также можете задать топологию PCI в параметре--hardware-features
.
Если параметр не задан, за созданным образом будет закреплено то же поколение оборудования, которое закреплено за диском-источником.
-
--hardware-features
— дополнительные настройки для поколенияGen 1
. Необязательный параметр. Возможные значения:pci_topology=v1
— выбор топологииPCI_TOPOLOGY_V1
.pci_topology=v2
— выбор топологииPCI_TOPOLOGY_V2
.
Если за диском-источником закреплено поколение
Gen 1
, по умолчанию у создаваемого образа для параметра--hardware-features
будет задано то же значение, что и у диска-источника.
Результат:
done (33s) id: fd8ar40hlfbk******** folder_id: b1gt6g8ht345******** created_at: "2025-06-23T18:53:39Z" name: my-first-image storage_size: "3116367872" min_disk_size: "21474836480" product_ids: - f2evcrm9ti79******** status: READY os: type: LINUX hardware_generation: legacy_features: pci_topology: PCI_TOPOLOGY_V1
-
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
-
Опишите в конфигурационном файле параметры ресурса
yandex_compute_image
.Пример структуры конфигурационного файла:
resource "yandex_compute_image" "image-1" { name = "<имя_образа>" source_disk = "<идентификатор_диска-источника>" hardware_generation { legacy_features { pci_topology = "<топология_PCI>" } } }
Где:
-
name
— имя создаваемого образа. Требования к имени:- длина — от 2 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
-
source_disk
— идентификатор диска-источника. -
hardware_generation
— блок настроек с описанием поколения виртуализированного оборудования, закрепляемого за образом. Необязательный параметр. Включает в себя следующие блоки настроек:-
legacy_features
— блок настроек с описанием параметров при выборе поколенияGen 1
:-
pci_topology
— выбор топологии PCI. Возможные значения:PCI_TOPOLOGY_V1
— выбор топологииPCI_TOPOLOGY_V1
.PCI_TOPOLOGY_V2
— выбор топологииPCI_TOPOLOGY_V2
.
Использование блока
legacy_features
делает невозможным использование блокаgeneration2_features
. -
Примечание
Если блок
hardware_generation
не задан, за созданным образом будет закреплено то же поколение оборудования, которое закреплено за диском-источником. -
Более подробную информацию о ресурсе
yandex_compute_image
см. в документации провайдера . -
-
Проверьте корректность конфигурационных файлов.
-
В командной строке перейдите в папку, где вы создали конфигурационный файл.
-
Выполните проверку с помощью команды:
terraform plan
Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.
-
-
Разверните облачные ресурсы.
-
Выполните команду:
terraform apply
-
Подтвердите создание ресурсов.
После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления
. -
- Получите список дисков с помощью метода REST API list для ресурса Disk или вызова gRPC API DiskService/List.
- Создайте образ с помощью метода REST API create для ресурса Image или вызова gRPC API ImageService/Create. В запросе укажите идентификатор диска-источника, а также при необходимости задайте нужное поколение виртуализированного оборудования в объекте
hardwareGeneration
(hardware_generation
при использовании gRPC API).
После создания образ перейдет в статус CREATING
. Дождитесь, когда образ перейдет в статус READY
, прежде чем его использовать.