Создать образ из другого пользовательского образа

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

1. Посмотрите описание команды CLI для создания образа:

   yc compute image create --help
   

2. Получите список образов в каталоге по умолчанию:

   yc compute image list
   

   Результат:

   +----------------------+-------------+--------+-------------+--------+
   |          ID          |    NAME     | FAMILY | PRODUCT IDS | STATUS |
   +----------------------+-------------+--------+-------------+--------+
   | fd8n3spmksqm******** | first-image |        |             | READY  |
   +----------------------+-------------+--------+-------------+--------+
   

3. Выберите идентификатор (ID) или имя (NAME) нужного образа.

4. Создайте образ в каталоге по умолчанию:

   yc compute image create \
     --name <имя_создаваемого_образа> \
     --source-image-name <имя_образа-источника> \
     --pooled \
     --hardware-generation-id <поколение_оборудования> \
     --hardware-features pci_topology=<топология_PCI>
   

   Где:

   • --name — имя создаваемого образа. Требования к имени:

     • длина — от 2 до 63 символов;
     • может содержать строчные буквы латинского алфавита, цифры и дефисы;
     • первый символ — буква, последний — не дефис.

   • --source-image-name — имя образа-источника. Вместо имени вы можете передать в команду идентификатор образа-источника в параметре --source-image-id.

   • --pooled — параметр, позволяющий создать оптимизированный образ. Необязательный параметр.

   • --hardware-generation-id — поколение виртуализированного оборудования, закрепляемое за образом. Необязательный параметр. Возможные значения:

     • legacy — поколение Gen 1. При выборе этого поколения вы также можете задать топологию PCI в параметре --hardware-features.
     • generation2 — поколение Gen 2. При выборе этого поколения задавать параметр --hardware-features не нужно.

     Если параметр не задан, за созданным образом будет закреплено то же поколение оборудования, которое закреплено за образом-источником.

   • --hardware-features — дополнительные настройки для поколения Gen 1. Необязательный параметр. Возможные значения:

     • pci_topology=v1 — выбор топологии PCI_TOPOLOGY_V1.
     • pci_topology=v2 — выбор топологии PCI_TOPOLOGY_V2.

     Если за образом-источником закреплено поколение Gen 2, по умолчанию у создаваемого образа для параметра --hardware-features будет задано значение pci_topology=v1.

     Если за образом-источником закреплено поколение Gen 1, по умолчанию у создаваемого образа для параметра --hardware-features будет задано то же значение, что и у образа-источника.

   Результат:

   done (11s)
   id: fd8ggkhegumb********
   folder_id: b1gt6g8ht345********
   created_at: "2025-06-23T07:13:41Z"
   name: new-image
   storage_size: "9877585920"
   min_disk_size: "21474836480"
   product_ids:
     - f2ercusam4no********
   status: READY
   os:
     type: LINUX
   hardware_generation:
     legacy_features:
       pci_topology: PCI_TOPOLOGY_V2
   

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

1. Опишите в конфигурационном файле параметры ресурса yandex_compute_image.

   Пример структуры конфигурационного файла:

   resource "yandex_compute_image" "image-1" {
     name         = "<имя_образа>"
     source_image = "<идентификатор_образа-источника>"
     hardware_generation {
       legacy_features {
         pci_topology = "<топология_PCI>"
       }
     }
   }
   

   Где:

   • name — имя создаваемого образа. Требования к имени:

     • длина — от 2 до 63 символов;
     • может содержать строчные буквы латинского алфавита, цифры и дефисы;
     • первый символ — буква, последний — не дефис.

   • source_image — идентификатор образа-источника.

   • 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.

     • generation2_features — блок настроек для выбора поколения Gen 2. При выборе поколения Gen 2 задавать дополнительные настройки не требуется.

       Использование блока generation2_features делает невозможным использование блока legacy_features.

     Примечание

     Если блок hardware_generation не задан, за созданным образом будет закреплено то же поколение оборудования, которое закреплено за образом-источником.

   Более подробную информацию о ресурсе yandex_compute_image см. в документации провайдера.

2. Проверьте корректность конфигурационных файлов.

   1. В командной строке перейдите в папку, где вы создали конфигурационный файл.

   2. Выполните проверку с помощью команды:

      terraform plan
      

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

3. Разверните облачные ресурсы.

   1. Выполните команду:

      terraform apply
      

   2. Подтвердите создание ресурсов.

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

1. Получите список образов с помощью метода REST API list для ресурса Image или вызова gRPC API ImageService/List.
2. Создайте новый образ с помощью метода REST API create для ресурса Image или вызова gRPC API ImageService/Create. В запросе укажите идентификатор образа-источника, а также при необходимости задайте нужное поколение виртуализированного оборудования в объекте hardwareGeneration (hardware_generation при использовании gRPC API).