Просмотр кода страницы Alt-packer

{{Stub}}

Alt packer содержит определения Packer для создания образов для загрузки ALT Linux в виртуальных средах, таких как KVM, VirtualBox и т. д.

Alt packer позволяет подготовить базовый («золотой») образ ВМ для OpenUDS, который содержит предустановленную операционную систему, OpenUDS actor, зарегистрированный на сервере OpenUDS, необходимые приложения и настройки. 

== Подготовка машины сборки ==

Предварительная настройка:
# Обновить ядро:
#: <syntaxhighlight lang="bash"># update-kernel</syntaxhighlight>
#: И перезагрузить компьютер, чтобы воспользоваться новыми пакетами ядра.
# Установить следующие пакеты и их зависимости:
#* {{pkgL|make}}
#* {{pkgL|jq}}
#* {{pkgL|curl}}
#* {{pkgL|wget}}
#* {{pkgL|qemu-kvm}}
#* {{pkgL|packer}}
#: <syntaxhighlight lang="bash"># apt-get install make jq curl wget qemu-kvm packer</syntaxhighlight>
# Добавить необходимый модуль ядра в список модулей для загрузки:
#*для Intel:
#*:<syntaxhighlight lang="bash"># echo kvm_intel >> /etc/modules-load.d/kvm.conf</syntaxhighlight>
#*для AMD:
#*:<syntaxhighlight lang="bash"># echo kvm_amd >> /etc/modules/kvm.conf</syntaxhighlight>
# Добавить пользователя в группу vmusers для QEMU:
#:<syntaxhighlight lang="bash"># gpasswd -a <имя пользователя> vmusers</syntaxhighlight>
# Перезагрузить машину.

Склонировать ветку cloud из репозитория  https://github.com/alt-cloud/alt-packer.git:
<syntaxhighlight lang="bash">$ git clone --branch=cloud  https://github.com/alt-cloud/alt-packer.git</syntaxhighlight>
Перейти в каталог {{path|alt-packer}}:
<syntaxhighlight lang="bash">$ cd alt-packer</syntaxhighlight>
Создать каталог {{path|packer_cache}} (или символическую ссылку на него) и загрузить в него необходимые ISO.
<syntaxhighlight lang="bash">$ mkdir packer_cache
$ wget -P packer_cache/ http://ftp.altlinux.org/pub/distributions/ALTLinux/p10/images/server/x86_64/alt-server-10.2-x86_64.iso</syntaxhighlight>

{{Note|Если в каталоге {{path|packer_cache}} нет нужного ISO-образа, он будет туда скачан при создании образа.}}

== Сборка образа для OpenUDS ==

Команда создания образа для OpenUDS:

<syntaxhighlight lang="bash">$ make image target=<дистрибутив> BASE_VERSION=<версия> TARGET_VERSION=<версия> VM_TYPE=openuds-actor OPENUDS_HOST=<IP-адрес></syntaxhighlight>

Допустимые параметры:
* target — целевой дистрибутив (возможные значения: alt-server, alt-workstation, alt-kworkstation)
* VM_TYPE — тип образа (по умолчанию qemu);
* BASE_VERSION — версия исходного образа;
* TARGET_VERSION — версия целевого образа;
* OPENUDS_ACTOR_SSL_VALIDATION — уровень безопасности для связи с сервером OpenUDS (по умолчанию no);
* OPENUDS_HOST — IP-адрес сервера OpenUDS;
* OPENUDS_AUTHENTICATOR — аутентификатор, которому принадлежит пользователь-администратор (по умолчанию admin);
* OPENUDS_USERNAME — имя пользователя, имеющего права администратора в среде OpenUDS (по умолчанию root);
* OPENUDS_PASSWORD — пароль пользователя (по умолчанию udsmam0);
* OPENUDS_ACTOR_LOG_LEVEL — уровень журналирования (по умолчанию error).

Пример команды для создания образа:
<syntaxhighlight lang="bash">$ make image target=alt-workstation BASE_VERSION=10.2 TARGET_VERSION=10.2 VM_TYPE=openuds-actor OPENUDS_HOST=192.168.0.53</syntaxhighlight>

В данном примере при создании образа будет использоваться ISO-образ alt-workstation-10.2-x86_64.iso и будут выполнены следующие настройки:
* OpenUDS Actor будет установлен и зарегистрирован на сервере OpenUDS (192.168.0.53);
* создан пользователь test с паролем 123;
* настроен сервер XRDP;
* для пользователя root установлен пароль 123;
* отключен SSH-доступ по паролю.

=== Добавление дополнительных шагов ===

{{Note| Если вы решили каким-либо образом дополнить существующий шаблон виртуальной машины, то вам следует выполнить деперсонализацию еще раз.}}

Для добавления дополнительных шагов при создании образа можно воспользоваться одним из двух вариантов:

# Добавить дополнительные действия в скрипт {{path|scripts/steps/setup_openuds_actor}}.
# Создать дополнительный скрипт в каталоге {{path|scripts/steps/}}, затем добавить его в {{path|scripts/vm_setup}}.

Пример скрипта, который добавляет установку веб-браузера {{pkgL|chromium}}:
# Создать файл {{path|scripts/steps/setup_chromium}}:
#:<syntaxhighlight lang="bash">
#! /bin/sh
set -euo pipefail
echo "Install Chromium"
apt-get -y install chromium
</syntaxhighlight>
# Добавить права на запуск скрипта:
#:<syntaxhighlight lang="bash"># chmod +x scripts/steps/setup_chromium</syntaxhighlight>
# Добавить созданный скрипт в список шагов для openuds-actor (файл {{path|scripts/vm_setup}}):
#:<syntaxhighlight lang="bash">
if test "${VM_TYPE}" == "openuds-actor"; then
	${STEP_DIR}/setup_remove_cdroms_repos
	${STEP_DIR}/setup_apt
	if test "${CLOUDINIT}" == "1"; then
		${STEP_DIR}/setup_cloudinit
	fi
	${STEP_DIR}/setup_agent
	${STEP_DIR}/setup_network
	${STEP_DIR}/setup_root
	${STEP_DIR}/setup_test_user
	${STEP_DIR}/setup_restore_sshd_config
	${STEP_DIR}/setup_ssh
	${STEP_DIR}/setup_prepare_new_instance
	${STEP_DIR}/setup_ansible
	${STEP_DIR}/setup_chromium
	${STEP_DIR}/setup_openuds_actor
fi
</syntaxhighlight>

Пример скрипта, который устанавливает и настраивает сервер X2GO:
# Создать файл {{path|scripts/steps/setup_x2go}}:
#:<syntaxhighlight lang="bash">
#! /bin/sh
set -euo pipefail
echo "Install x2goserver" 
apt-get -y install x2goserver
systemctl enable --now x2goserver
# echo "Enabled sshd-password"
control sshd-password-auth enabled
</syntaxhighlight>
# Добавить права на запуск скрипта:
#:<syntaxhighlight lang="bash"># chmod +x scripts/steps/setup_x2go</syntaxhighlight>
# Добавить созданный скрипт в список шагов для openuds-actor (файл {{path|scripts/vm_setup}}):
#:<syntaxhighlight lang="bash">
if test "${VM_TYPE}" == "openuds-actor"; then
	${STEP_DIR}/setup_remove_cdroms_repos
	${STEP_DIR}/setup_apt
	if test "${CLOUDINIT}" == "1"; then
		${STEP_DIR}/setup_cloudinit
	fi
	${STEP_DIR}/setup_agent
	${STEP_DIR}/setup_network
	${STEP_DIR}/setup_root
	${STEP_DIR}/setup_test_user
	${STEP_DIR}/setup_restore_sshd_config
	${STEP_DIR}/setup_ssh
	${STEP_DIR}/setup_prepare_new_instance
	${STEP_DIR}/setup_ansible
	${STEP_DIR}/setup_x2go
	${STEP_DIR}/setup_openuds_actor
fi
</syntaxhighlight>  

== Расположение и наименование образов ==
Все созданные образы находятся в каталоге {{path|./images}}. По умолчанию к имени образа добавляются текущая дата и тег git. Если тега нет, добавляется хеш текущего коммита, например:
<syntaxhighlight lang="bash">alt-workstation-10.2-openuds-actor-20250203-4f20feb-x86_64.qcow2</syntaxhighlight>

При необходимости тег, хеш и дату можно переопределить с помощью переменных среды GIT_TAG, GIT_HASH, GIT_DATE:

<syntaxhighlight lang="bash">$ make image target=alt-server BASE_VERSION=10 TARGET_VERSION=10 VM_TYPE=cloud GIT_TAG=1.0.1 GIT_DATE=20250123</syntaxhighlight>

== Разворачивание образа в PVE ==

Процедура разворачивания образа:
# Скопировать образ на машину PVE.
# На машине PVE импортировать образ. Команда импорта:
#:<syntaxhighlight lang="bash"> qm importdisk <vmid> <source> <storage> [OPTIONS]</syntaxhighlight>
#:Импорт диска в хранилище local, для ВМ с ID 207:
#:<syntaxhighlight lang="bash"># qm importdisk 207 /home/user/alt-workstation-10.2-openuds-actor-20250203-4f20feb-x86_64.qcow2 local --format qcow2
…
Successfully imported disk as 'unused0:local:207/vm-207-disk-0.qcow2'</syntaxhighlight>
# Привязать диск к ВМ:
#:<syntaxhighlight lang="bash"># qm set 207 --scsi0 local:207/vm-207-disk-0.qcow2</syntaxhighlight>

=== Загрузка образа с помощью NBD ===
Загрузить образ можно также с помощью NBD.

На машине сборки:
# Установить пакет {{pkgL|nbd-server}}:
#:<syntaxhighlight lang="bash"># apt-get install nbd-server</syntaxhighlight>
# Экспортировать образ QCOW2 с помощью NBD (на порту 12345):
#:<syntaxhighlight lang="bash">$ nbd-server 12345 /home/user/alt-packer/images/alt-server-10.2-openuds-actor-20250203-4f20feb-x86_64.qcow2

На клиенте:
# Установить пакет {{pkgL|nbd-client}}:
#:<syntaxhighlight lang="bash"># apt-get install nbd-client</syntaxhighlight>
# Загрузить драйвер для NBD:
#:<syntaxhighlight lang="bash"># modprobe nbd</syntaxhighlight>
# Выполнить команду для подключения к серверу NBD (предполагается, что IP-адрес сервера 192.168.0.175):
#:<syntaxhighlight lang="bash"># nbd-client 192.168.0.175 12345</syntaxhighlight>
# Проверить, что образ QCOW2 смонтирован, с помощью этих команд:
#:<syntaxhighlight lang="bash"># file -s /dev/nbd0
/dev/nbd0: QEMU QCOW Image (v3), 5368709120 bytes (v3), 5368709120 bytes</syntaxhighlight>
#:или:
#:<syntaxhighlight lang="bash"># qemu-img info /dev/nbd0
image: /dev/nbd0
file format: qcow2
virtual size: 5 GiB (5368709120 bytes)
disk size: 0 B
cluster_size: 65536
Format specific information:
    compat: 1.1
    compression type: zlib
    lazy refcounts: false
    refcount bits: 16
    corrupt: false
    extended l2: false</syntaxhighlight>
# Перенести образ на блочное устройство:
#:<syntaxhighlight lang="bash"># qemu-img dd bs=1M if=/dev/nbd0 of=/var/lib/vz/images/208/vm-208-disk-0.qcow2</syntaxhighlight>
#: Это может занять довольно много времени из-за передачи большого файла.
# Отключить клиент:
#:<syntaxhighlight lang="bash"># nbd-client -d /dev/nbd0</syntaxhighlight>
# Привязать диск к ВМ:
#:<syntaxhighlight lang="bash"># qm set 208 --scsi0 local:208/vm-208-disk-0.qcow2</syntaxhighlight>

Остановить NBD-сервер:
<syntaxhighlight lang="bash">$ pkill nbd-server</syntaxhighlight>
Убедиться, что порт освободился:
<syntaxhighlight lang="bash">$ ss -ntlup |grep 12345</syntaxhighlight>

== Устранение неполадок ==
В случае проблем с автоустановщиком добавьте параметр ''instdebug'' в параметры загрузки ядра.

В случае ошибок типа '''No space left on device''' при использовании каталога {{path|/tmp}} — следует установить переменную TMPDIR на другой каталог.