Product SiteDocumentation Site

⁠5.3. HTTP Frontend API

⁠5.3.1. Создание новой схемы образа

Конечная точка: 
POST /schematics
создает новую схему образа на основе предоставленной конфигурации.
Тело запроса должно содержать YAML- или JSON-конфигурацию с опциональными разделами, представленными в таблице Основные параметры (customization).
⁠

Таблица 5.2. Основные параметры (customization)

Параметр
Тип
Описание
extraKernelArgs
[]string
Дополнительные аргументы ядра (например, console=ttyS0,115200)
meta
[]Meta
Метаданные для инициализации ALT Orchestra (пары ключ-значение в hex-формате)
systemExtensions
object
Системные расширения, включаемые в образ
secureboot
object
Настройки Secure Boot (только для совместимых образов)
Пример запроса:
  1. Создать конфигурацию (файл custom.yaml): 
    customization:
    extraKernelArgs:
      - console=ttyS0,115200
    systemExtensions:
        officialExtensions:
            - alt-orchestra/intel-ucode
            - alt-orchestra/util-linux-tools

    Примечание

    Все поля опциональны. Пустой запрос ({}) создаст схему по умолчанию.
  2. Отправить запрос в Image Factory, чтобы получить ее идентификатор: 
    $ curl -X POST --data-binary @custom.yaml  \
 https://factory.altlinux.space/schematics
    Ответ: 
        {"id":"60686148f84df043380005f117452c396347e3405e856aa70ba02318a9ab2a99"}
    Возвращаемый id — уникальный хеш схемы, используемый для загрузки образов.
    Известные идентификаторы схем:
    • 376567988ad370138ad8b2698212367b8edcb69b5fd68c80be1f2ec7d603b4ba — схема по умолчанию (без кастомизации).