Files

T

DerLinkman 30f3e9a4c6 rename dmc12 inventory to cloudlorean and vault admin_password

- replace inventory/dmc12.yml with cloudlorean.yml (+ group_vars) and update
  all README/AGENTS call examples and the inventory table
- move admin_password hash into encrypted vault.yml; remove plaintext copies
  from roles/bootstrap/defaults and group_vars/external.yml
- bootstrap.yml loads vault.yml via vars_files (same pattern as monitoring)
- monitoring: PSK config/registration updates, docker role defaults,
  os-updates logging/reboot refinements, ansible.cfg/execute.sh tweaks
- add .project-wiki knowledge base and .github agent instructions

2026-09-09 14:14:18 +02:00

3.7 KiB

Raw Blame History

Rolle `hawser`

Aktualisiert den Hawser Docker-Compose-Stack auf den Ziel-Hosts. Hawser ist ein Docker-Management-Agent, der das Docker- Socket nach außen freigibt. Die Rolle deployt die Compose-Datei aus einem Template und zieht stets die neuesten Images (pull: always).

Siehe auch das Playbook playbooks/upgrade-hawser.yml sowie die Repo-README.

Voraussetzungen

Debian-Ziel-Host mit installierter Docker Engine (Rolle docker)
Bereits vorhandene Hawser-Installation (/opt/hawser/docker-compose.yml muss existieren)
community.docker Collection

Einbindung

- hosts: all
  become: true
  user: admin
  roles:
    - role: hawser

ansible-playbook -i inventory/cloudlorean.yml playbooks/upgrade-hawser.yml

Funktionsweise

tasks/main.yml importiert tasks/update-stack.yml:

Docker-Host-Info sammeln – prüft, ob Docker erreichbar ist (community.docker.docker_host_info). Bei Fehler werden nachfolgende Tasks übersprungen.
Compose-Datei prüfen – stat auf <hawser_compose_dir>/docker-compose.yml. Fehlt die Datei, wird kein Update durchgeführt (Bestandsschutz).
Compose-Datei ausliefern – Template docker-compose.yml.j2 wird nur geschrieben, wenn Docker erreichbar UND bereits eine Compose-Datei vorhanden ist.
Stack aktualisieren – community.docker.docker_compose_v2 mit pull: always und state: present zieht die neuesten Images und erneuert die Container.

Variablen

Variable	Typ	Default	Beschreibung
`hawser_project_name`	string	`hawser`	Name des Docker-Compose-Projekts
`hawser_compose_dir`	string	`/opt/hawser`	Verzeichnis der Compose-Datei auf dem Zielhost
`hawser_port`	string	`2376`	Freigegebener Port des Hawser-Agents (Host-Port)
`hawser_stacks_volume`	string	`hawser_stacks`	Name des externen Docker-Volumes für Stack-Dateien
`hawser_allow_insecure_no_auth`	bool	`true`	`ALLOW_INSECURE_NO_AUTH` – Standard-Mode ohne Token

Achtung: hawser_allow_insecure_no_auth: true erlaubt den Betrieb ohne Token-Authentifizierung auch auf Nicht-Loopback-Adressen. Nur setzen, wenn das Netzwerk durch andere Maßnahmen (Firewall, VPN) abgesichert ist.

Templates

Template	Ziel
`docker-compose.yml.j2`	`<hawser_compose_dir>/docker-compose.yml`

Das Template konfiguriert den Hawser-Container mit Socket-Mount, externem Volume, Port-Mapping, Environment-Variablen, image: ghcr.io/finsys/hawser:latest und restart: always.

Handler

Keine Handler erforderlich – docker compose up -d ersetzt laufende Container eigenständig.

Abhängigkeiten

community.docker Collection (docker_host_info, docker_compose_v2)
Vorherige Installation der docker-Rolle

Hinweise

Die Rolle erzeugt keine Neuinstallation – die Compose-Datei wird nur geschrieben, wenn bereits eine existiert. So wird verhindert, dass Hawser versehentlich auf Hosts ausgebracht wird, auf denen es nicht vorgesehen ist.
Das externe Volume hawser_stacks muss vor dem ersten Start manuell erstellt werden (docker volume create hawser_stacks).
pull: always sorgt für aktuelle Images, erfordert aber Internetzugang zum ghcr.io-Registry.

3.7 KiB Raw Blame History Unescape Escape

Rolle hawser