Server Bootstrap

Zweck: Initiale Einrichtung eines Servers; Vorbereitung für die Ferrosoft Plattform Zielgruppe: Administrator mit SSH-Zugang auf den Root-Account Geschätzter Gesamtaufwand: 5 Minuten Wiederholungen: Keine — nur einmal nach Servererstellung ausführen

Der Bootstrap-Vorgang vereinheitlicht die Serverumgebung und wird genau einmal nach der Erstellung des Servers ausgeführt.

Vorbedingungen

  • Das Infrastruktur-Repository ist lokal eingerichtet.
  • SSH-Zugriff per Public-Key auf den root-Benutzer ist vorhanden.
  • Der Server läuft mit Debian (getestet mit Version 13 "Trixie").

Schritte

1. Variablen konfigurieren

Siehe Konfigurationsmanagement. In der Regel ist dieser Schritt nicht notwendig, da die Standardkonfiguration bereits passt.

2. Pflicht-Playbooks ausführen

Ziel: Serverumgebung vereinheitlichen, Updates einspielen, kontrollierten Reboot durchführen.

  1. Ins Ansible-Verzeichnis wechseln: cd ansible.

  2. Playbooks ausführen — siehe auch die Playbook-Beschreibungen:

    uv run ./ansible-playbook --host "xxx" playbooks/{bootstrap,update-os,reboot}.yml

3. Optionale Playbooks ausführen

Ziel: Zusätzliche Komponenten installieren und einrichten.

  1. Ins Ansible-Verzeichnis wechseln: cd ansible.

  2. Benötigte Playbooks ausführen, z.B. für die Docker Container Engine:

    uv run ./ansible-playbook --host "xxx" playbooks/docker-ce.yml