feat: resolve Runtime Blueprint and add Fedora backend for kickstart generation
30_runtime_blueprint.sh calls POST /templates/{id}/resolve with the
device_id from the server handshake and the template_id from the
Bereitstellungsvorlage selection, storing the resulting Runtime
Blueprint under /run/tuxflotte/runtime/.
40_backend.sh dispatches to backends/${backend_id}/backend.sh based on
the resolved backend_id and drives the backend_init/validate/
generate_config/launch/postinstall lifecycle from 06-backend-api.md.
backends/fedora/backend.sh implements that lifecycle for Fedora:
backend_generate_config() renders kickstart.tpl via envsubst using the
Runtime Blueprint's installation_directives and the device hostname,
embedding the resolved Merkmal blueprints as JSON for the (not yet
implemented) Provisioning Agent to apply later. Replaces the old
git-clone-based %post bootstrap. backend_launch()/backend_postinstall()
are Phase 1 stubs pending the live-ISO boot integration (see
platform-docs ADR-0003).
This commit is contained in:
parent
3a7549adf1
commit
086917deec
133
backends/fedora/backend.sh
Normal file
133
backends/fedora/backend.sh
Normal file
@ -0,0 +1,133 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
set -Eeuo pipefail
|
||||||
|
|
||||||
|
# Dieses Skript wird von einem Orchestrator-Modul (z.B. 40_backend.sh) per
|
||||||
|
# `source` in dessen Shell geladen. Variablen bleiben deshalb bewusst nicht
|
||||||
|
# readonly, um Namenskollisionen mit dem ladenden Modul zu vermeiden.
|
||||||
|
BACKEND_KEY="fedora"
|
||||||
|
|
||||||
|
BACKEND_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
KICKSTART_TEMPLATE="${BACKEND_DIR}/kickstart.tpl"
|
||||||
|
|
||||||
|
RUNTIME_BLUEPRINT_FILE="/run/tuxflotte/runtime/runtime_blueprint.json"
|
||||||
|
SERVER_RESPONSE_FILE="/run/tuxflotte/server/response.json"
|
||||||
|
|
||||||
|
RUNTIME_DIR="/run/tuxflotte/backend"
|
||||||
|
CONFIG_FILE="${RUNTIME_DIR}/config"
|
||||||
|
|
||||||
|
backend_log() {
|
||||||
|
printf '[backend:%s] %s\n' "${BACKEND_KEY}" "$*" >&2
|
||||||
|
}
|
||||||
|
|
||||||
|
backend_fatal() {
|
||||||
|
printf '[backend:%s] FEHLER: %s\n' "${BACKEND_KEY}" "$*" >&2
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
backend_init() {
|
||||||
|
for cmd in jq envsubst; do
|
||||||
|
command -v "${cmd}" >/dev/null 2>&1 ||
|
||||||
|
{ backend_fatal "Benötigtes Werkzeug fehlt: ${cmd}"; return 1; }
|
||||||
|
done
|
||||||
|
|
||||||
|
[[ -r "${KICKSTART_TEMPLATE}" ]] ||
|
||||||
|
{ backend_fatal "Kickstart-Template nicht gefunden: ${KICKSTART_TEMPLATE}"; return 1; }
|
||||||
|
|
||||||
|
install -d \
|
||||||
|
--mode=0700 \
|
||||||
|
--owner=root \
|
||||||
|
--group=root \
|
||||||
|
"${RUNTIME_DIR}"
|
||||||
|
|
||||||
|
rm -f -- "${CONFIG_FILE}"
|
||||||
|
|
||||||
|
backend_log "Initialisiert."
|
||||||
|
}
|
||||||
|
|
||||||
|
backend_validate() {
|
||||||
|
[[ -r "${RUNTIME_BLUEPRINT_FILE}" ]] ||
|
||||||
|
{ backend_fatal "Runtime Blueprint nicht gefunden: ${RUNTIME_BLUEPRINT_FILE}"; return 1; }
|
||||||
|
|
||||||
|
jq --exit-status \
|
||||||
|
--arg backend_key "${BACKEND_KEY}" \
|
||||||
|
'.runtime_blueprint.backend_id == $backend_key' \
|
||||||
|
"${RUNTIME_BLUEPRINT_FILE}" >/dev/null ||
|
||||||
|
{ backend_fatal "Runtime Blueprint ist nicht für Backend '${BACKEND_KEY}' aufgelöst."; return 1; }
|
||||||
|
|
||||||
|
jq --exit-status '
|
||||||
|
.runtime_blueprint.installation_directives
|
||||||
|
| (.disk_encryption | type == "boolean")
|
||||||
|
and (.partitioning | type == "string")
|
||||||
|
and (.secure_boot_required | type == "boolean")
|
||||||
|
' "${RUNTIME_BLUEPRINT_FILE}" >/dev/null ||
|
||||||
|
{ backend_fatal "Installationszeitliche Vorgaben fehlen oder sind ungültig."; return 1; }
|
||||||
|
|
||||||
|
backend_log "Runtime Blueprint ist gültig für Backend '${BACKEND_KEY}'."
|
||||||
|
}
|
||||||
|
|
||||||
|
backend_generate_config() {
|
||||||
|
local hostname
|
||||||
|
local disk_encryption
|
||||||
|
local partitioning
|
||||||
|
local secure_boot_required
|
||||||
|
local partitioning_command
|
||||||
|
local blueprints_json
|
||||||
|
|
||||||
|
[[ -r "${SERVER_RESPONSE_FILE}" ]] ||
|
||||||
|
{ backend_fatal "Serverantwort nicht gefunden: ${SERVER_RESPONSE_FILE}"; return 1; }
|
||||||
|
|
||||||
|
hostname="$(jq --raw-output '.device.hostname // empty' "${SERVER_RESPONSE_FILE}")"
|
||||||
|
[[ -n "${hostname}" ]] ||
|
||||||
|
{ backend_fatal "Kein Hostname in der Serverantwort gefunden."; return 1; }
|
||||||
|
|
||||||
|
disk_encryption="$(jq --raw-output '.runtime_blueprint.installation_directives.disk_encryption' "${RUNTIME_BLUEPRINT_FILE}")"
|
||||||
|
partitioning="$(jq --raw-output '.runtime_blueprint.installation_directives.partitioning' "${RUNTIME_BLUEPRINT_FILE}")"
|
||||||
|
secure_boot_required="$(jq --raw-output '.runtime_blueprint.installation_directives.secure_boot_required' "${RUNTIME_BLUEPRINT_FILE}")"
|
||||||
|
|
||||||
|
case "${partitioning}" in
|
||||||
|
default)
|
||||||
|
if [[ "${disk_encryption}" == "true" ]]; then
|
||||||
|
partitioning_command="autopart --encrypted"
|
||||||
|
else
|
||||||
|
partitioning_command="autopart"
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
backend_fatal "Nicht unterstützte Partitionierungsvorgabe: ${partitioning}"
|
||||||
|
return 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
if [[ "${secure_boot_required}" == "true" ]]; then
|
||||||
|
backend_log "Hinweis: secure_boot_required=true wird derzeit nicht in der Kickstart-Konfiguration durchgesetzt (Phase 1)."
|
||||||
|
fi
|
||||||
|
|
||||||
|
blueprints_json="$(jq --compact-output '.runtime_blueprint.blueprints' "${RUNTIME_BLUEPRINT_FILE}")"
|
||||||
|
|
||||||
|
TUXFLOTTE_HOSTNAME="${hostname}" \
|
||||||
|
TUXFLOTTE_PARTITIONING_COMMAND="${partitioning_command}" \
|
||||||
|
TUXFLOTTE_BLUEPRINTS_JSON="${blueprints_json}" \
|
||||||
|
envsubst '${TUXFLOTTE_HOSTNAME} ${TUXFLOTTE_PARTITIONING_COMMAND} ${TUXFLOTTE_BLUEPRINTS_JSON}' \
|
||||||
|
<"${KICKSTART_TEMPLATE}" >"${CONFIG_FILE}"
|
||||||
|
|
||||||
|
chmod 0600 "${CONFIG_FILE}"
|
||||||
|
|
||||||
|
[[ -s "${CONFIG_FILE}" ]] ||
|
||||||
|
{ backend_fatal "Erzeugte Konfigurationsdatei ist leer: ${CONFIG_FILE}"; return 1; }
|
||||||
|
|
||||||
|
if grep -q '\${TUXFLOTTE_' "${CONFIG_FILE}"; then
|
||||||
|
backend_fatal "Erzeugte Konfigurationsdatei enthält nicht aufgelöste Platzhalter."
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
backend_log "Konfiguration erzeugt: ${CONFIG_FILE}"
|
||||||
|
}
|
||||||
|
|
||||||
|
backend_launch() {
|
||||||
|
backend_log "Phase 1: Start des nativen Installers ist noch nicht aktiv."
|
||||||
|
backend_log "Erzeugte Konfiguration liegt bereit unter: ${CONFIG_FILE}"
|
||||||
|
}
|
||||||
|
|
||||||
|
backend_postinstall() {
|
||||||
|
backend_log "Phase 1: Vorbereitung des Provisioning-Agent erfolgt bereits im %post-Abschnitt der Kickstart-Konfiguration."
|
||||||
|
}
|
||||||
55
backends/fedora/kickstart.tpl
Normal file
55
backends/fedora/kickstart.tpl
Normal file
@ -0,0 +1,55 @@
|
|||||||
|
#version=DEVEL
|
||||||
|
|
||||||
|
text
|
||||||
|
reboot
|
||||||
|
|
||||||
|
lang de_DE.UTF-8
|
||||||
|
keyboard de
|
||||||
|
timezone Europe/Berlin --utc
|
||||||
|
|
||||||
|
# Lab-Bootstrap-Zugangsdaten. Ersetzt ein noch fehlendes Secret-Reference-Modell
|
||||||
|
# (siehe 09-data-model-v1.md) und darf nicht als Produktionsmechanismus gelten.
|
||||||
|
rootpw --plaintext test123
|
||||||
|
user --name=tuxflotte --groups=wheel --password=test123
|
||||||
|
|
||||||
|
network --bootproto=dhcp --activate --hostname=${TUXFLOTTE_HOSTNAME}
|
||||||
|
|
||||||
|
zerombr
|
||||||
|
clearpart --all --initlabel
|
||||||
|
${TUXFLOTTE_PARTITIONING_COMMAND}
|
||||||
|
|
||||||
|
firewall --enabled
|
||||||
|
selinux --enforcing
|
||||||
|
|
||||||
|
bootloader --location=mbr
|
||||||
|
|
||||||
|
%packages
|
||||||
|
@core
|
||||||
|
vim
|
||||||
|
curl
|
||||||
|
git
|
||||||
|
ansible-core
|
||||||
|
%end
|
||||||
|
|
||||||
|
%post
|
||||||
|
cat > /etc/motd <<'EOF'
|
||||||
|
Provisioned by tuxflotte
|
||||||
|
|
||||||
|
https://tuxflotte.de
|
||||||
|
EOF
|
||||||
|
|
||||||
|
localectl set-locale LANG=de_DE.UTF-8
|
||||||
|
localectl set-keymap de
|
||||||
|
localectl set-x11-keymap de
|
||||||
|
|
||||||
|
mkdir -p /etc/tuxflotte
|
||||||
|
|
||||||
|
cat > /etc/tuxflotte/runtime_blueprint.json <<'RUNTIME_BLUEPRINT_EOF'
|
||||||
|
${TUXFLOTTE_BLUEPRINTS_JSON}
|
||||||
|
RUNTIME_BLUEPRINT_EOF
|
||||||
|
|
||||||
|
# Der Provisioning Agent existiert noch nicht als Build-Artefakt.
|
||||||
|
# Anwendung der obigen Blueprints per Ansible-Pull erfolgt erst nach dessen Implementierung.
|
||||||
|
echo "tuxflotte: Runtime Blueprint unter /etc/tuxflotte/runtime_blueprint.json hinterlegt." >> /var/log/tuxflotte-postinstall.log
|
||||||
|
echo "tuxflotte: Provisioning-Agent-Installation ist noch nicht implementiert (Phase 1)." >> /var/log/tuxflotte-postinstall.log
|
||||||
|
%end
|
||||||
@ -76,6 +76,8 @@ case "${TUXFLOTTE_INSTALLATION_CONFIRMED:-}" in
|
|||||||
;;
|
;;
|
||||||
esac
|
esac
|
||||||
|
|
||||||
|
run_module "$SCRIPT_DIR/modules/30_runtime_blueprint.sh" "always"
|
||||||
|
run_module "$SCRIPT_DIR/modules/40_backend.sh" "always"
|
||||||
run_module "$SCRIPT_DIR/modules/20_storage.sh" "dry-run-safe"
|
run_module "$SCRIPT_DIR/modules/20_storage.sh" "dry-run-safe"
|
||||||
run_module "$SCRIPT_DIR/modules/99_finish.sh" "always"
|
run_module "$SCRIPT_DIR/modules/99_finish.sh" "always"
|
||||||
|
|
||||||
|
|||||||
119
scripts/modules/30_runtime_blueprint.sh
Normal file
119
scripts/modules/30_runtime_blueprint.sh
Normal file
@ -0,0 +1,119 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
set -Eeuo pipefail
|
||||||
|
|
||||||
|
SCRIPT_NAME="$(basename "${BASH_SOURCE[0]}")"
|
||||||
|
readonly SCRIPT_NAME
|
||||||
|
|
||||||
|
readonly NETWORK_STATE="/run/tuxflotte/network/state.env"
|
||||||
|
readonly SERVER_RESPONSE_FILE="/run/tuxflotte/server/response.json"
|
||||||
|
readonly TEMPLATE_FILE="/run/tuxflotte/assignment/template.json"
|
||||||
|
|
||||||
|
readonly RUNTIME_DIR="/run/tuxflotte/runtime"
|
||||||
|
readonly RESOLVE_REQUEST_FILE="${RUNTIME_DIR}/resolve_request.json"
|
||||||
|
readonly BLUEPRINT_FILE="${RUNTIME_DIR}/runtime_blueprint.json"
|
||||||
|
|
||||||
|
log() {
|
||||||
|
printf '[%s] %s\n' "${SCRIPT_NAME}" "$*" >&2
|
||||||
|
}
|
||||||
|
|
||||||
|
fatal() {
|
||||||
|
printf '[%s] FEHLER: %s\n' "${SCRIPT_NAME}" "$*" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
|
require_root() {
|
||||||
|
if [[ "${EUID}" -ne 0 ]]; then
|
||||||
|
fatal "Das Runtime-Blueprint-Modul muss als root ausgeführt werden."
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
prepare_runtime_directory() {
|
||||||
|
install -d \
|
||||||
|
--mode=0700 \
|
||||||
|
--owner=root \
|
||||||
|
--group=root \
|
||||||
|
"${RUNTIME_DIR}"
|
||||||
|
|
||||||
|
rm -f -- "${RESOLVE_REQUEST_FILE}" "${BLUEPRINT_FILE}"
|
||||||
|
}
|
||||||
|
|
||||||
|
validate_inputs() {
|
||||||
|
[[ -r "${NETWORK_STATE}" ]] ||
|
||||||
|
fatal "Netzwerkstatus nicht gefunden: ${NETWORK_STATE}"
|
||||||
|
|
||||||
|
[[ -r "${SERVER_RESPONSE_FILE}" ]] ||
|
||||||
|
fatal "Serverantwort nicht gefunden: ${SERVER_RESPONSE_FILE}"
|
||||||
|
|
||||||
|
jq --exit-status '.device.id | type == "string" and length > 0' \
|
||||||
|
"${SERVER_RESPONSE_FILE}" >/dev/null ||
|
||||||
|
fatal "Serverantwort enthält keine gültige Geräte-ID."
|
||||||
|
|
||||||
|
[[ -r "${TEMPLATE_FILE}" ]] ||
|
||||||
|
fatal "Bereitstellungsvorlage nicht gefunden: ${TEMPLATE_FILE}"
|
||||||
|
|
||||||
|
jq --exit-status '.template.id | type == "string" and length > 0' \
|
||||||
|
"${TEMPLATE_FILE}" >/dev/null ||
|
||||||
|
fatal "Bereitstellungsvorlage enthält keine gültige ID."
|
||||||
|
}
|
||||||
|
|
||||||
|
build_resolve_request() {
|
||||||
|
jq \
|
||||||
|
--null-input \
|
||||||
|
--slurpfile response "${SERVER_RESPONSE_FILE}" \
|
||||||
|
'{ device_id: $response[0].device.id }' \
|
||||||
|
>"${RESOLVE_REQUEST_FILE}"
|
||||||
|
|
||||||
|
chmod 0600 "${RESOLVE_REQUEST_FILE}"
|
||||||
|
}
|
||||||
|
|
||||||
|
send_resolve_request() {
|
||||||
|
local server_url
|
||||||
|
local template_id
|
||||||
|
|
||||||
|
# shellcheck disable=SC1090
|
||||||
|
source "${NETWORK_STATE}"
|
||||||
|
|
||||||
|
server_url="${TUXFLOTTE_SERVER_URL%/health}"
|
||||||
|
template_id="$(jq --raw-output '.template.id' "${TEMPLATE_FILE}")"
|
||||||
|
|
||||||
|
curl \
|
||||||
|
--silent \
|
||||||
|
--show-error \
|
||||||
|
--fail \
|
||||||
|
--location \
|
||||||
|
--header 'Content-Type: application/json' \
|
||||||
|
--data-binary "@${RESOLVE_REQUEST_FILE}" \
|
||||||
|
--output "${BLUEPRINT_FILE}" \
|
||||||
|
"${server_url}/api/v1/templates/${template_id}/resolve" ||
|
||||||
|
fatal "Runtime Blueprint konnte nicht aufgelöst werden."
|
||||||
|
|
||||||
|
chmod 0600 "${BLUEPRINT_FILE}"
|
||||||
|
|
||||||
|
jq --exit-status . "${BLUEPRINT_FILE}" >/dev/null ||
|
||||||
|
fatal "Antwort auf die Runtime-Blueprint-Anfrage enthält kein gültiges JSON."
|
||||||
|
|
||||||
|
jq --exit-status '.success == true' "${BLUEPRINT_FILE}" >/dev/null ||
|
||||||
|
fatal "$(jq -r '.message // "Provisioning-Server hat die Auflösung abgelehnt."' "${BLUEPRINT_FILE}")"
|
||||||
|
|
||||||
|
jq --exit-status '
|
||||||
|
.runtime_blueprint
|
||||||
|
| (.workspace_id | type == "string")
|
||||||
|
and (.backend_id | type == "string")
|
||||||
|
and (.blueprints | type == "array")
|
||||||
|
and (.installation_directives | type == "object")
|
||||||
|
' "${BLUEPRINT_FILE}" >/dev/null ||
|
||||||
|
fatal "Runtime Blueprint enthält keine gültige Zielbeschreibung."
|
||||||
|
|
||||||
|
log "Runtime Blueprint für Backend $(jq -r '.runtime_blueprint.backend_id' "${BLUEPRINT_FILE}") erzeugt."
|
||||||
|
log "Runtime Blueprint wurde unter ${BLUEPRINT_FILE} gespeichert."
|
||||||
|
}
|
||||||
|
|
||||||
|
main() {
|
||||||
|
require_root
|
||||||
|
prepare_runtime_directory
|
||||||
|
validate_inputs
|
||||||
|
build_resolve_request
|
||||||
|
send_resolve_request
|
||||||
|
}
|
||||||
|
|
||||||
|
main "$@"
|
||||||
70
scripts/modules/40_backend.sh
Normal file
70
scripts/modules/40_backend.sh
Normal file
@ -0,0 +1,70 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
set -Eeuo pipefail
|
||||||
|
|
||||||
|
SCRIPT_NAME="$(basename "${BASH_SOURCE[0]}")"
|
||||||
|
readonly SCRIPT_NAME
|
||||||
|
|
||||||
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
readonly SCRIPT_DIR
|
||||||
|
BACKENDS_DIR="$(cd "${SCRIPT_DIR}/../../backends" && pwd)"
|
||||||
|
readonly BACKENDS_DIR
|
||||||
|
|
||||||
|
readonly ORCHESTRATOR_BLUEPRINT_FILE="/run/tuxflotte/runtime/runtime_blueprint.json"
|
||||||
|
|
||||||
|
log() {
|
||||||
|
printf '[%s] %s\n' "${SCRIPT_NAME}" "$*" >&2
|
||||||
|
}
|
||||||
|
|
||||||
|
fatal() {
|
||||||
|
printf '[%s] FEHLER: %s\n' "${SCRIPT_NAME}" "$*" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
|
require_root() {
|
||||||
|
if [[ "${EUID}" -ne 0 ]]; then
|
||||||
|
fatal "Das Backend-Modul muss als root ausgeführt werden."
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
load_backend() {
|
||||||
|
local backend_id
|
||||||
|
local backend_script
|
||||||
|
|
||||||
|
[[ -r "${ORCHESTRATOR_BLUEPRINT_FILE}" ]] ||
|
||||||
|
fatal "Runtime Blueprint nicht gefunden: ${ORCHESTRATOR_BLUEPRINT_FILE}"
|
||||||
|
|
||||||
|
backend_id="$(jq --raw-output '.runtime_blueprint.backend_id // empty' "${ORCHESTRATOR_BLUEPRINT_FILE}")"
|
||||||
|
[[ -n "${backend_id}" ]] ||
|
||||||
|
fatal "Runtime Blueprint enthält keine gültige Backend-ID."
|
||||||
|
|
||||||
|
backend_script="${BACKENDS_DIR}/${backend_id}/backend.sh"
|
||||||
|
[[ -r "${backend_script}" ]] ||
|
||||||
|
fatal "Kein Backend für '${backend_id}' gefunden: ${backend_script}"
|
||||||
|
|
||||||
|
log "Lade Backend '${backend_id}' aus ${backend_script}"
|
||||||
|
|
||||||
|
# shellcheck disable=SC1090
|
||||||
|
source "${backend_script}"
|
||||||
|
}
|
||||||
|
|
||||||
|
run_lifecycle() {
|
||||||
|
local step
|
||||||
|
|
||||||
|
for step in backend_init backend_validate backend_generate_config backend_launch backend_postinstall; do
|
||||||
|
declare -f "${step}" >/dev/null ||
|
||||||
|
fatal "Backend implementiert erforderliche Funktion nicht: ${step}"
|
||||||
|
|
||||||
|
log "Führe ${step}() aus."
|
||||||
|
|
||||||
|
"${step}" ||
|
||||||
|
fatal "${step}() ist fehlgeschlagen."
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
main() {
|
||||||
|
require_root
|
||||||
|
load_backend
|
||||||
|
run_lifecycle
|
||||||
|
}
|
||||||
|
|
||||||
|
main "$@"
|
||||||
Loading…
x
Reference in New Issue
Block a user