Загрузить собственный образ операционной системы

Вы можете добавить собственный образ операционной системы или программного продукта, чтобы иметь возможность самостоятельно установить его на сервер. Для этого нужно сначала загрузить файл образа в бакет сервиса Yandex Object Storage.

Загрузите файл образа в Object StorageЗагрузите файл образа в Object Storage

Загрузите ISO-образ в Yandex Object Storage и получите ссылку на загруженный объект:

1. Создайте бакет Object Storage:

   Примечание

   Чтобы создать бакет, у вас должна быть минимальная роль storage.editor на каталог.

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

   Yandex Cloud CLI

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

   2. Перейдите в сервис Object Storage.

   3. Справа сверху нажмите Создать бакет.

   4. На странице создания бакета:

      1. Введите имя бакета в соответствии с правилами именования.
      2. При необходимости задайте ограничение на максимальный размер бакета или включите опцию Без ограничения.
      3. Значения остальных параметров оставьте без изменения и нажмите Создать бакет.

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

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

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

      yc storage bucket create --name <имя_бакета>
      

      Где --name — имя бакета. Обязательный параметр. Подробнее см. Правила именования бакетов.

      Результат:

      name: <имя_бакета>
      folder_id: b1gt6g8ht345********
      anonymous_access_flags: {}
      default_storage_class: STANDARD
      versioning: VERSIONING_DISABLED
      created_at: "2025-08-06T07:29:40.418079Z"
      resource_id: e3e9neva43dl********
      

      Подробнее о команде yc storage bucket create см. в Справочнике Yandex Cloud CLI.

2. Загрузите скачанный файл с образом в созданный бакет:

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

   Yandex Cloud CLI

   Примечание

   Через консоль управления нельзя загрузить объекты размером более 5 ГБ (см. Квоты и лимиты в Object Storage). Для загрузки больших объектов используйте другие инструменты.

   1. В консоли управления перейдите в сервис Object Storage и перейдите в бакет, в который нужно загрузить образ.
   2. На панели слева выберите Объекты и в правом верхнем углу экрана нажмите кнопку Загрузить.
   3. В открывшемся окне выберите файл с образом и нажмите Открыть.
   4. В окне загрузки объектов нажмите Загрузить и дождитесь завершения загрузки.
   5. Обновите страницу.

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

      yc storage s3api put-object \
        --body <путь_к_локальному_файлу> \
        --bucket <имя_бакета> \
        --key <путь_к_объекту>
      

      Где:

      • --body — путь к файлу, который нужно загрузить в бакет. Например: ./ubuntu.iso.
      • --bucket — имя вашего бакета.
      • --key — ключ, по которому объект будет храниться в бакете. Например: Ubuntu-2404.iso.

      Результат:

      etag: '"87740887a5159e2685500c02********"'
      request_id: 300dceee********
      

   Подробнее о команде yc storage s3api put-object см. в Справочнике Yandex Cloud CLI.

3. Получите ссылку на загруженный в бакет образ:

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

   1. В консоли управления выберите каталог.
   2. Перейдите в сервис Object Storage и выберите нужный бакет.
   3. Нажмите на имя объекта с загруженным ISO-образом.
   4. В правом верхнем углу экрана нажмите кнопку Получить ссылку.
   5. Нажмите Получить ссылку.
   6. Скопируйте полученную ссылку.

Создайте образ в BareMetalСоздайте образ в BareMetal

Создайте новый образ по ссылке, полученной в Object Storage:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <IAM-токен>" \
  -d '{
       "folderId": "b1g07hj5r6i4********",
       "name": "baremetal-ubuntu",
       "description": "New OS Baremetal Image",
       "uri": "https://storage.yandexcloud.net/bm-test-backet/new-server-amd64.iso",
       "labels": {
         "key": "ubuntu"
       }
      }' \
  "https://baremetal.api.cloud.yandex.net/baremetal/v1alpha/images"

{
"done": false,
"metadata": {
  "@type": "type.googleapis.com/yandex.cloud.baremetal.v1alpha.CreateImageMetadata",
  "imageId": "ly5kr5tjsple********"
},
"id": "ly5iwrc2uvuf********",
"description": "User image create",
"createdAt": "2025-12-07T20:31:52.845955Z",
"createdBy": "ajeb9l33h6mu********",
"modifiedAt": "2025-12-07T20:31:52.845955Z"
}

Удалите образ из Object StorageУдалите образ из Object Storage

После создания образа можно удалить файл образа из сервиса Object Storage. Также можно удалить бакет, если в нем не осталось объектов.