¶ Сборка слоёв с помощью Buildlayer
Вы можете начать создавать слои на любой рабочей машине с развёрнутой ОС Атлант. Это может быть как сервер управления, так и любая рабочая станция.
¶ Выбор релиза
Сборку слоя необходимо вести на том же релизе, для которого этот слой предназначен. Слой, собранный на Alcyone, не будет корректно работать в Giant, и наоборот: у релизов разные базовые системы и разные версии библиотек.
| Релиз | Базовая система | Репозиторий слоёв |
|---|---|---|
| Alcyone | Debian 10 | https://repo.applite.ru/layers/stack/ |
| Giant | Debian 12 | https://repo-giant.applite.ru/layers/stack/giant/ |
Утилита
buildlayer— одна и та же для обоих релизов: это статически слинкованный бинарный файл без внешних зависимостей. Различаются только базовые слои, которые вы кладёте в рабочую директорию.
Проверить, на каком релизе вы находитесь, можно так:
cat /etc/atlant-release
¶ Установка утилиты для сборки слоёв
Выполните в консоли от имени пользователя с правами администратора (root):
wget https://repo.applite.ru/packages/script/buildlayer -O /bin/buildlayer && chmod +x /bin/buildlayer
Убедитесь, что утилита установилась и запускается:
buildlayer version
Вывод должен содержать номер версии и правообладателя:
buildlayer v0.1.1 (commit e87dd6f, 2026-07-13T05:39:29Z)
Copyright (c) 2026 ООО «Атлант» (ГК Applite). Все права защищены.
Подробнее: buildlayer license
Проверка целостности (рекомендуется). Рядом с утилитой опубликован файл контрольных сумм. Сверьте скачанный бинарный файл с эталоном:
wget https://repo.applite.ru/packages/script/SHA256SUMS -O /tmp/SHA256SUMS cd /bin && sha256sum -c --ignore-missing /tmp/SHA256SUMSОжидаемый ответ —
buildlayer: OK.
¶ Инициализация рабочего пространства
Выполните в консоли следующую команду:
buildlayer init
Скрипт создаст структуру директорий в /au:
ready— сюда копируются готовые слои sfsresult— точка монтирования «пирога» aufsro— директория для точек монтирования RO-слоёв из файлов SFS, расположенных вsfsrw— здесь будут расположены файлы нового слояsfs— файлы (или симлинки на файлы) sfs, из которых будет создаваться «пирог» aufs
В случае использования слоистой корневой системы путь к рабочей директории — /Layer/rw/au. Утилита определяет это автоматически: если корневая ФС смонтирована как AUFS, она выбирает
/Layer/rw/au, иначе/au. Далее по тексту везде, где указан/au, для слоистой системы подразумевается/Layer/rw/au.
¶ Сборка новых слоёв
Данная операция требуется для сборки собственных слоёв с прикладным ПО или библиотеками.
¶ 1. Подготовьте базовые слои
Поместите в папку /au/sfs слои, относительно которых будет собираться новый слой. Скачивайте их из репозитория своего релиза:
Alcyone (Debian 10):
cd /au/sfs
wget https://repo.applite.ru/layers/stack/01.layer.base.sfs
Giant (Debian 12):
cd /au/sfs
wget https://repo-giant.applite.ru/layers/stack/giant/01.layer.base.sfs
Как правило, для сборки консольных приложений достаточно одного базового слоя. Для сборки слоя с графическими приложениями необходимо дополнительно разместить слой с X-сервером
xlibdm. Полный список актуальных слоёв смотрите в репозитории своего релиза (ссылки в таблице выше).
Слои монтируются в порядке сортировки по алфавиту — именно поэтому они пронумерованы (
01.,02., …). Не переименовывайте их произвольно: порядок влияет на итоговый «пирог».
¶ 2. Запустите сборку
Выполните в консоли от имени пользователя с правами администратора (root):
buildlayer
Команда выполняется без параметров. Утилита автоматически находит все слои в директории /au/sfs, монтирует их в порядке сортировки по алфавиту и собирает новую файловую систему для сборки слоя.
Перед монтированием происходит автоматическая очистка директории
/au/rw.
Файлы, необходимые для установки (пакеты, исходники и т. п.), должны копироваться или скачиваться посредствомwget/curlстрого ПОСЛЕ создания слоистой файловой системы, то есть уже внутри chroot.
Для работы с интернет-ресурсами внутри chroot необходимо указать адрес DNS-сервера — свой или общедоступный:
echo "nameserver 1.1.1.1" > /etc/resolv.conf
¶ 3. Установите ПО внутри chroot
После монтирования вы попадаете в изолированную среду chroot и можете устанавливать необходимое ПО из репозиториев, пакетов, бинарных файлов или исходных кодов — например, с помощью пакетного менеджера apt.
Chroot — это утилита в Linux и Unix-подобных системах, которая позволяет изменить корневой каталог диска для запущенного процесса и его дочерних процессов.
Программа, запущенная в таком окружении, не может получить доступ к файлам вне нового корневого каталога. В нашем случае chroot используется для создания изолированной среды: можно безопасно тестировать и готовить программное обеспечение, не рискуя повредить основную систему.
Важно отметить, что chroot следует использовать только опытным пользователям, так как при некорректной эксплуатации он потенциально может привести к нестабильности системы.
Например, для установки офисного пакета LibreOffice выполните:
apt update -y
apt install -y libreoffice
Состав репозиториев
aptвнутри chroot определяется базовым слоем: в Alcyone это репозитории Debian 10, в Giant — Debian 12. Проверить, где вы находитесь, можно всё той же командойcat /etc/debian_version— уже внутри chroot.
¶ 4. Упакуйте результат
По завершении установки выйдите из режима chroot командой exit. Утилита спросит: «Вы хотите указать имя файла слоя для упаковки результата?»
Для автоматической сборки слоя с ПО отвечайте y (yes) и укажите имя файла. Утилита создаст новый слой в директории /au/ready/.
Теперь слой готов для импорта в систему управления LayerPie — см. инструкцию по созданию слоёв.
¶ Обновление и правка базового слоя
Данная операция требуется, если в базовый слой нужно что-то добавить или убрать.
Базовый слой, скачанный из репозитория своего релиза, требуется поместить в /au/sfs.
Других слоёв в этой папке быть не должно. Команда
baseработает только тогда, когда в/au/sfsлежит ровно один файл.sfs.
Далее выполните команду:
buildlayer base
Команда распакует базовый слой и выполнит вход в изолированную среду chroot, после чего можно будет внести необходимые правки. Затем выйдите из chroot командой exit.
После выхода из chroot утилита автоматически соберёт новую версию слоя в директорию /au/ready/ под именем вида имя_файла_базового_слоя-текущая_дата.sfs.
¶ Справочник команд
Полный список команд и флагов доступен через встроенную справку:
buildlayer help
buildlayer help <команда>
| Команда | Назначение |
|---|---|
buildlayer init |
Инициализировать структуру рабочих директорий |
buildlayer |
Собрать новый слой (основной сценарий, без параметров) |
buildlayer base |
Изменить и переупаковать базовый слой (ровно 1 файл в /au/sfs) |
buildlayer rebuild <файл.sfs> |
Пересобрать указанный слой |
buildlayer pack |
Упаковать директорию слоя в .sfs |
buildlayer version |
Показать версию утилиты |
buildlayer license |
Показать текст лицензии |
Для удобства можно включить автодополнение команд:
buildlayer completion bash > /etc/bash_completion.d/buildlayer
¶ Требования
- ОС Атлант (Alcyone или Giant), ядро с поддержкой AUFS
- Права root
- Утилиты
mount,umount,unsquashfs,mksquashfs,chroot
Перед монтированием утилита пытается загрузить модуль AUFS (
modprobe aufs) и проверяет/proc/filesystems. Если AUFS недоступен, выполнение останавливается с понятным сообщением.