Thomas Stallinger 15965551ec feat: Mint-Backend fuer den Installer (backend.sh + preseed.tpl)
Fehlte bisher komplett - backends/mint/ enthielt nur handgepatchte
WLAN-Test-Artefakte, kein backend.sh, sodass 40_backend.sh mit
"Kein Backend für 'mint' gefunden" abbrach.

Baut auf dem bereits real erprobten wlan-test.seed-Muster auf (Ubiquity/
Preseed, nicht Subiquity/Autoinstall - siehe ADR-0009), generalisiert zu
einem echten Template mit denselben Platzhaltern wie Fedoras kickstart.tpl:

- backends/mint/backend.sh: 5-Funktionen-Contract 1:1 wie Fedora
  (backend_init/validate/generate_config/launch/postinstall),
  backend_launch() bewusst als Stub (echte Parität mit Fedoras
  heutigem Stand, kein Vorgriff auf das noch nicht entschiedene
  Self-Service-Portal-Modell).
- backends/mint/preseed.tpl + postinstall.sh: echter Agent-Bootstrap
  (curl agent.py, Bootstrap-POST, Credentials, systemd enable) im
  ubiquity/success_command, zweistufig envsubst+base64 gerendert
  (Debconf-Fallstrick bei mehrzeiligen Preseed-Werten, real erprobt).
- scripts/build.sh: Backend-Argument (fedora|mint), Mint-Pfade real
  gegen die vorhandene Test-ISO verifiziert (/boot/grub/grub.cfg,
  /isolinux/live.cfg, /preseed/tuxflotte.seed - keine zweite ESP-Kopie
  wie bei Fedora), Test-Preseed-Bake mit Platzhalterwerten.
- profiles/mint-desktop/profile.json: installer.type von "autoinstall"
  auf "preseed" korrigiert (ADR-0009 hatte den alten Wert als vermutlich
  falsch benannt markiert - jetzt bestätigt und korrigiert).

End-to-end auf echter QEMU-Hardware verifiziert: automatisierte
Installation, Reboot, Agent-Bootstrap, Check-in, ansible-pull-Zyklus
(PLAY RECAP failed=0) - kompletter Kreislauf funktioniert. Dabei
gefunden und gefixt: d-i pkgsel/include string ansible-core git fehlte
(Pendant zu Fedoras kickstart.tpl %packages) - ohne das lief der
Agent-Dienst in einer Restart-Fehlerschleife.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-04 19:00:16 +02:00

228 lines
5.7 KiB
Bash
Executable File

#!/usr/bin/env bash
set -euo pipefail
SOURCE_ISO="${1:-}"
BACKEND="${2:-}"
REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
BASE_DIR="$(cd "$REPO_DIR/.." && pwd)"
BUILD_DIR="$BASE_DIR/build"
WORK_DIR="$BUILD_DIR/work"
OUTPUT_DIR="$BUILD_DIR/output"
# Test-Device fuer den in bake_test_preseed() eingebrannten, nicht
# personalisierten Test-Preseed (Mint) - dasselbe "Default Lab"-Testgeraet,
# das schon fuer die Fedora-Verifikation genutzt wurde. Echte Personalisierung
# pro Kunde ist nicht Teil dieses Build-Skripts (siehe ADR-0011-Kontext).
TEST_DEVICE_ID="a0238a0b-d2b5-4516-a6ce-da7170041d11"
TEST_HOSTNAME="tuxflotte-mint-test"
usage() {
echo "Usage: $0 /path/to/source.iso <fedora|mint>"
}
check_input() {
if [[ -z "$SOURCE_ISO" || -z "$BACKEND" ]]; then
usage
exit 1
fi
if [[ ! -f "$SOURCE_ISO" ]]; then
echo "Error: ISO not found: $SOURCE_ISO"
exit 1
fi
case "$BACKEND" in
fedora|mint) ;;
*)
echo "Error: unbekanntes Backend '$BACKEND' (erwartet: fedora oder mint)"
exit 1
;;
esac
}
check_dependencies() {
for cmd in xorriso; do
if ! command -v "$cmd" >/dev/null 2>&1; then
echo "Error: missing dependency: $cmd"
exit 1
fi
done
if [[ "$BACKEND" == "mint" ]]; then
for cmd in jq envsubst base64; do
if ! command -v "$cmd" >/dev/null 2>&1; then
echo "Error: missing dependency: $cmd"
exit 1
fi
done
fi
}
prepare_dirs() {
mkdir -p "$BUILD_DIR" "$OUTPUT_DIR"
rm -rf "$WORK_DIR"
mkdir -p "$WORK_DIR"
}
extract_iso() {
echo "Extracting ISO..."
xorriso -indev "$SOURCE_ISO" -osirrox on -extract / "$WORK_DIR" >/dev/null
}
patch_grub() {
echo "Installing Tuxflotte GRUB configuration..."
if [[ "$BACKEND" == "fedora" ]]; then
cp "$REPO_DIR/grub/EFI-BOOT-grub.cfg" \
"$WORK_DIR/EFI/BOOT/grub.cfg"
cp "$REPO_DIR/grub/boot-grub2-grub.cfg" \
"$WORK_DIR/boot/grub2/grub.cfg"
else
# Mint hat, anders als Fedora, keine zweite ESP/FAT-Kopie des GRUB-Menüs,
# die separat gepatcht werden müsste (real gegen die vorhandene
# tuxflotte-mint-test.iso verifiziert - x86_64-efi/grub.cfg ist nur ein
# Loader-Stub, der per `source /boot/grub/grub.cfg` zurückverweist).
cp "$REPO_DIR/grub/mint-boot-grub.cfg" \
"$WORK_DIR/boot/grub/grub.cfg"
cp "$REPO_DIR/grub/mint-isolinux-live.cfg" \
"$WORK_DIR/isolinux/live.cfg"
fi
}
verify_workdir() {
echo "Verifying workdir..."
if [[ "$BACKEND" == "fedora" ]]; then
grep -q "Tuxflotte" "$WORK_DIR/EFI/BOOT/grub.cfg"
grep -q "Tuxflotte" "$WORK_DIR/boot/grub2/grub.cfg"
else
grep -q "Tuxflotte" "$WORK_DIR/boot/grub/grub.cfg"
grep -q "Tuxflotte" "$WORK_DIR/isolinux/live.cfg"
fi
echo "GRUB verification passed."
}
bake_test_preseed() {
[[ "$BACKEND" == "mint" ]] || return 0
echo "Rendering test preseed (nicht personalisiert, siehe TEST_DEVICE_ID)..."
local preseed_dir="$WORK_DIR/preseed"
local runtime_blueprint_file="$WORK_DIR/runtime_blueprint.json"
local server_response_file="$WORK_DIR/response.json"
mkdir -p "$preseed_dir"
cat > "$runtime_blueprint_file" <<EOF
{
"runtime_blueprint": {
"backend_id": "mint",
"blueprints": [],
"installation_directives": {
"disk_encryption": false,
"partitioning": "default",
"secure_boot_required": false
}
}
}
EOF
cat > "$server_response_file" <<EOF
{
"device": {"hostname": "${TEST_HOSTNAME}", "id": "${TEST_DEVICE_ID}"}
}
EOF
# backend.sh direkt wiederverwenden statt die Templating-Logik hier zu
# duplizieren - Variablen sind bewusst nicht readonly (siehe backend.sh),
# backend_init() wird übersprungen (braucht root für --owner/--group,
# hier nicht nötig, mkdir reicht für den Build-Kontext).
# shellcheck disable=SC1091
source "$REPO_DIR/backends/mint/backend.sh"
RUNTIME_BLUEPRINT_FILE="$runtime_blueprint_file"
SERVER_RESPONSE_FILE="$server_response_file"
RUNTIME_DIR="$preseed_dir"
CONFIG_FILE="$preseed_dir/tuxflotte.seed"
backend_validate
backend_generate_config
echo "Test-Preseed erzeugt: $CONFIG_FILE"
}
prepare_updates() {
echo "Assembling live-updates payload..."
local updates_dir="$WORK_DIR/updates"
rm -rf "$updates_dir"
mkdir -p "$updates_dir/opt/tuxflotte"
cp -a "$REPO_DIR/live-updates/." "$updates_dir/"
cp -a "$REPO_DIR/scripts" "$updates_dir/opt/tuxflotte/"
cp -a "$REPO_DIR/backends" "$updates_dir/opt/tuxflotte/"
cp -a "$REPO_DIR/config" "$updates_dir/opt/tuxflotte/"
chmod 0440 "$updates_dir/etc/sudoers.d/90-tuxflotte"
}
create_iso() {
echo "Creating Tuxflotte ISO..."
local output_iso
local -a grub_map_args
if [[ "$BACKEND" == "fedora" ]]; then
output_iso="$OUTPUT_DIR/tuxflotte-provisioning-0.2.iso"
grub_map_args=(
-map "$REPO_DIR/grub/EFI-BOOT-grub.cfg" /EFI/BOOT/grub.cfg
-map "$REPO_DIR/grub/boot-grub2-grub.cfg" /boot/grub2/grub.cfg
)
else
output_iso="$OUTPUT_DIR/tuxflotte-mint-provisioning-0.1.iso"
grub_map_args=(
-map "$REPO_DIR/grub/mint-boot-grub.cfg" /boot/grub/grub.cfg
-map "$REPO_DIR/grub/mint-isolinux-live.cfg" /isolinux/live.cfg
-map "$WORK_DIR/preseed/tuxflotte.seed" /preseed/tuxflotte.seed
)
fi
rm -f "$output_iso"
xorriso \
-indev "$SOURCE_ISO" \
-outdev "$output_iso" \
-compliance no_emul_toc \
-volid TUXFLOTTE \
"${grub_map_args[@]}" \
-map "$WORK_DIR/updates" /updates \
-chown_r 0 /updates -- \
-chgrp_r 0 /updates -- \
-boot_image any replay
echo "ISO created: $output_iso"
}
main() {
check_input
check_dependencies
prepare_dirs
extract_iso
patch_grub
verify_workdir
bake_test_preseed
prepare_updates
create_iso
echo
echo "Build complete."
echo "Work dir: $WORK_DIR"
}
main "$@"