78.2. Инструмент командной строки kopidel

⁠78.2. Инструмент командной строки kopidel

Создать разливочный образ можно и в командной строке.

Синтаксис команды kopidel:

# kopidel [опции] workdir
# kopidel [опции] /dev/external_drive

где:

workdir — путь к рабочему каталогу (например, /alterator-kopidel-workdir);
/dev/external_drive — устройство, на которое будет записан образ.

Доступные опции:

-X, --ignored-from — путь к файлу со списком игнорируемых файлов (по умолчанию используется файл /usr/share/alterator-kopidel/default-ignored-files.txt);
--xz — сжать скопированную файловую систему с помощью xz;
-O, --oem-mode — включить режим OEM;
-s, --step — запустить отдельный шаг процесса;
--list-workdirs — показать список возможных рабочих каталогов;
--list-exdrives — показать список возможных внешних накопителей;
--grub-efi-removable — установить GRUB с флагом --removable;
-v, --version — показать версию и выйти;
-h, --help — показать справку и выйти.

Примечание

Возможные шаги при создании загрузочного образа:

prepare_workdir — подготовка рабочего каталога;
create_copied_fs — копирование файловой системы;
create_disk_partition_info — создание информации о разбивке диска (alterator-kopidel-workdir/image/Metadata/vm-profile.scm;
create_install_scripts — создание установочных скриптов (alterator-kopidel-workdir/image/Metadata/install-scripts.tar);
create_razlivochniy_mountpoint — создание разделов и точек монтирования;
save_ready_to_use_image — перемещение готовых к использованию файлов в образ;
use_ready_to_use_image — перемещение готовых к использованию файлов в примонтированный образ;
install_grub — установка GRUB;
umount_razlivochniy — размонтирование образа.

Примеры использования:

просмотр возможных рабочих каталогов:

# kopidel --list-workdirs

Используется стандартный список игнорируемых файлов.
Список возможных рабочих каталогов:
/alterator-kopidel-workdir /dev/sda3

просмотр возможных внешних накопителей:

# kopidel --list-exdrives

Используется стандартный список игнорируемых файлов.
Нет доступных внешних накопителей с достаточным количеством места. Требуемое место: 12Gi.

создание образа в каталоге /alterator-kopidel-workdir:

# kopidel /alterator-kopidel-workdir

Используется стандартный список игнорируемых файлов.
[Ср 03 сен 2025 12:06:28 EET] Шаг 1/9: Подготовка рабочего каталога.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 12:10:09 EET] Шаг 2/9: Копирование файловой системы.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 13:44:17 EET] Шаг 3/9: Создание информации о разбивке диска.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 13:44:26 EET] Шаг 4/9: Создание установочных скриптов.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 13:44:26 EET] Шаг 5/9: Перемещение готовых к использованию файлов в образ.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 13:44:26 EET] Шаг 6/9: Создание разделов и точек монтирования.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 13:45:04 EET] Шаг 7/9: Перемещение готовых к использованию файлов в образ.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 13:46:14 EET] Шаг 8/9: Установка GRUB.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 13:46:18 EET] Шаг 9/9: Размонтирование образа.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 13:46:18 EET] Создание разливочного образа успешно завершено.

выполнение отдельного шага (например, создание информации о разметке):

# kopidel -s create_disk_partition_info /alterator-kopidel-workdir

Используется стандартный список игнорируемых файлов.
[Ср 03 сен 2025 11:48:41 EET] Шаг 1/1: Создание информации о разбивке диска.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 11:48:47 EET] Шаг был успешно выполнен

Результат (файл vm-profile.scm):

# cat /alterator-kopidel-workdir/image/Metadata/vm-profile.scm
((workstation
  (title . "Setup for workstation")
  (action . trivial)
  (actiondata
               ("swap" (size 262144 . 262144 ) (fsim . "SWAPFS") (methods plain) )
               ("/boot/efi" (size 1046528 . 1046528 ) (fsim . "FAT32") (methods plain) )
               ("" (size 66865468 . 166455296 ) (fsim . "BtrFS") (methods plain) (subvols ("@" . "/") ("@home" . "/home")))
               )))

запись образа на внешний накопитель:

# kopidel /dev/sdb

Используется стандартный список игнорируемых файлов.
[Ср 03 сен 2025 16:48:56 EET] Шаг 1/7: Создание разделов и точек монтирования.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 16:48:57 EET] Шаг 2/7: Подготовка рабочего каталога.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 16:52:16 EET] Шаг 3/7: Копирование файловой системы.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 16:55:12 EET] Шаг 4/7: Создание информации о разбивке диска.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 16:55:17 EET] Шаг 5/7: Создание установочных скриптов.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 16:55:17 EET] Шаг 6/7: Установка GRUB.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 16:55:18 EET] Шаг 7/7: Размонтирование образа.
█████████████████████████████████████████████████████████████████████████████████████████████████ 100%
[Ср 03 сен 2025 16:55:18 EET] Создание разливочного образа успешно завершено.

создать разливочный образ в каталоге /home/alterator-kopidel-workdir, использовать OEM-режим, установить загрузчик в специальный раздел «EFI» (для режима EFI):
```
# kopidel -O -g efi /home/alterator-kopidel-workdir
```