Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • AI Studio
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Compute Cloud
    • Все инструкции
      • Подготовить образ диска
      • Загрузить свой образ
      • Создать образ из диска
      • Создать образ из снимка диска
      • Создать образ из другого пользовательского образа
    • Посмотреть операции с ресурсами сервиса
  • Yandex Container Solution
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • История изменений
  • Обучающие курсы
  1. Пошаговые инструкции
  2. Создание образа
  3. Создать образ из диска

Создать образ из диска

Статья создана
Yandex Cloud
Улучшена
Обновлена 23 июля 2025 г.

Чтобы создать образ из диска:

Консоль управления
CLI
Terraform
API

Примечание

С помощью консоли управления вы можете создать образы из сетевых SSD- и HDD-дисков. Чтобы создать образ из нереплицируемого SSD-диска или сверхбыстрого сетевого хранилища с тремя репликами (SSD), используйте интерфейсы CLI, Terraform или API.

  1. В консоли управления выберите каталог, в котором нужно создать образ.

  2. В списке сервисов выберите Compute Cloud.

  3. На панели слева выберите Диски.

  4. В строке с нужным диском нажмите значок и выберите Создать образ.

  5. Введите имя образа. Требования к имени:

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

  7. Разверните блок Дополнительно.

  8. (Опционально) В поле Поколение оборудования выберите нужное поколение виртуализированного оборудования, которое будет закреплено за создаваемым образом:

    • Gen 1.2 (MBR, BIOS) — поколение Gen 1.2.
    • Gen 1.1 (MBR, BIOS) — поколение Gen 1.1.

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

  9. (Опционально) Чтобы создать оптимизированный образ, включите опцию Оптимизация.

  10. Нажмите Создать.

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

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

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

    yc compute image create --help
    
  2. Получите список дисков в каталоге по умолчанию:

    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  |                      |                 |             |
    +----------------------+--------------+-------------+-------------------+--------+----------------------+-----------------+-------------+
    
  3. Выберите идентификатор (ID) или имя (NAME) нужного диска.

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

    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.

  1. Опишите в конфигурационном файле параметры ресурса 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 см. в документации провайдера.

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

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

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

      terraform plan
      

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

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

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

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

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

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

После создания образ перейдет в статус CREATING. Дождитесь, когда образ перейдет в статус READY, прежде чем его использовать.

Была ли статья полезна?

Предыдущая
Загрузить свой образ
Следующая
Создать образ из снимка диска
Проект Яндекса
© 2025 ООО «Яндекс.Облако»