Конфигурирование образа

Данный способ следует использовать только если Вам действительно необходимо общесистемное изменение образа, так как он затратный по времени и использует ресурсы ПК для пересборки.

Состав локального образа описывается декларативно в файле /etc/apm/image.yml. Его можно создать вручную или он будет создан автоматически: после первого apm system install <pkg> и следующего apm system image apply в файле появятся установленный пакет и текущий базовый образ.

Чтобы изменить систему — отредактируйте файл и примените изменения:

sudo apm system image apply

apply соберёт новый локальный образ на основе вашего конфига и переключит на него систему через bootc. Для вступления изменений в силу нужна перезагрузка.

Декларативность

Сборка образа всегда выполняется с нуля: состояние хоста не запоминается. Поэтому все нужные изменения (пакеты, сервисы, файлы) должны быть описаны в image.yml — иначе после очередного apply они пропадут.

Поле image

Обязательное поле — ссылка на базовый OCI-образ, поверх которого собирается ваш локальный образ. Обычно указывают текущий образ системы, его можно посмотреть через apm system image status. Без этого поля apply завершится ошибкой.

Пример: установка пакетов

Чтобы добавить пакеты в образ, опишите их в модуле packages:

image: altlinux.space/alt-atomic/onyx/stable:latest
modules:
  - name: My custom packages
    type: packages
    body:
      install:
        - hello
        - tmux

Альтернативный способ — быстрая установка через apm system install <pkg>: пакет сразу появится в системе, а следующий вызов apm system image apply добавит его в image.yml и пересоберёт образ.

Пример: смена ядра

Чтобы перейти на ядро 6.18 и подключить модуль drm, добавьте модуль kernel:

image: altlinux.space/alt-atomic/onyx/stable:latest
modules:
  - name: Update kernel
    type: kernel
    body:
      kernel-info:
        flavour: 6.18
        modules:
          - drm
      initrd:
        method: dracut

Примените:

sudo apm system image apply
sudo reboot

После перезагрузки система будет работать на новом ядре. Предыдущая версия образа остаётся доступной в меню GRUB для отката.

Больше модулей и полей

Полный список доступных модулей, их полей и переменных окружения — в статье «Конфигурирование образа».