Управление машиной

Команды machine управляют жизненным циклом самой ОС: обновления, откаты, перезагрузки и информация о системе.

Команды

machine info

Выводит информацию о системе: ресурсы, версии, состояние образа.

ssh server machine info

---

machine logs

Выводит системный журнал. Можно фильтровать по конкретному сервису и ограничивать количество строк.

ssh server machine logs [<service>]

Пример:

# Последние 100 строк общего журнала
ssh server machine logs

# Логи конкретного сервиса
ssh server machine logs selenite-controller

# Следить за логами сервиса
ssh server machine logs -f selenite-controller

# Вывести всё, что есть
ssh server machine logs -n -1 selenite-controller

---

machine dmesg

Выводит сообщения из кольцевого буфера ядра (dmesg).

ssh server machine dmesg [flags]

Флаги:

Флаг	Описание
-T, --ctime	Печатать человекочитаемые таймстампы
-l, --level	Ограничить вывод заданными уровнями (например, err,warn)
-w, --follow	Ожидать новые сообщения

Примеры:

ssh server machine dmesg

ssh server machine dmesg --ctime

ssh server machine dmesg --level err,warn

ssh server machine dmesg --follow

---

machine reboot

Перезагружает машину.

ssh server machine reboot

Пример:

ssh server machine reboot

WARNING

Соединение будет разорвано сразу после отправки команды. Все запущенные стеки будут остановлены и автоматически подняты после перезагрузки (если настроен restart: unless-stopped или always).

---

machine upgrade

Обновляет образ ОС до последней версии через bootc. После обновления требуется перезагрузка для применения нового образа.

ssh server machine upgrade

Пример:

# Обновить образ
ssh server machine upgrade

# Обновить и сразу перезагрузить
ssh server machine upgrade && ssh server machine reboot

Процесс обновления:

1. bootc скачивает новый образ из registry
2. Образ записывается в неактивный раздел
3. После machine reboot система загружается с нового образа

TIP

Обновление не влияет на работающие стеки до перезагрузки.

---

machine rollback

Откатывает ОС к предыдущей версии образа. Как и upgrade, требует перезагрузки.

ssh server machine rollback

Пример:

# Откатиться к предыдущему образу
ssh server machine rollback
ssh server machine reboot

bootc хранит ровно одну предыдущую версию образа, поэтому откат возможен только на один шаг назад.

---

machine switch

Переключает машину на другой образ ОС (другой registry или тег). Полезно для смены канала обновлений или миграции на другой образ.

ssh server machine switch <image>

Пример:

# Переключиться на другой тег
ssh server machine switch ghcr.io/alt-atomic/selenite:stable

# Переключиться на другой образ
ssh server machine switch registry.example.com/my-selenite:latest

После switch нужна перезагрузка для применения изменений.

---

machine config apply

Применяет конфигурацию машины из YAML, переданного через stdin. Подробнее о формате — в разделе Конфигурация.

ssh server machine config apply [--reboot]

Флаги:

Флаг	Описание
--reboot	Перезагрузить машину после применения конфига

Примеры:

# Применить конфиг
ssh server machine config apply < config.yml

# Применить конфиг и перезагрузить
ssh server machine config apply --reboot < config.yml

Типичные сценарии

Плановое обновление

# Скачать новый образ (без прерывания сервисов)
ssh server machine upgrade

# В удобное время — перезагрузить
ssh server machine reboot

Откат после проблемного обновления

# Откатиться к предыдущему образу
ssh server machine rollback

# Перезагрузиться
ssh server machine reboot

Обновление конфигурации с перезагрузкой

ssh server machine config apply --reboot < config.yml