ansible-content/README.md
Thomas Stallinger a998949081 feat: initial ansible-content repo with placeholder roles for agent verification
Ein Platzhalter je Merkmal aus der Schulcomputer-Bereitstellungsvorlage (guest-session, brave-fedora, onlyoffice-fedora), zum Beweis der ansible-pull-Pipeline des Provisioning Agent.
2026-08-01 15:35:21 +02:00

22 lines
986 B
Markdown

# ansible-content
Ansible-Rollen, die der Tuxflotte Provisioning Agent per `ansible-pull` gegen installierte Geräte anwendet.
Rollennamen entsprechen 1:1 der Spalte `ansible_role` in der `blueprints`-Tabelle des Provisioning-Servers (siehe `provisioning-server/migrations/0005_seed_workspace_backend_blueprint_data.sql`).
`site.yml` bindet jede Rolle unter einem zu ihrem Namen passenden Tag ein. Der Agent ruft sie über:
```
ansible-pull -U <repo-url> --tags <rolle1>,<rolle2>,... -i localhost, site.yml
```
## Aktueller Stand
Alle Rollen sind Platzhalter — sie hinterlegen nur eine Marker-Datei unter `/run/tuxflotte/agent/applied/<rolle>.marker`, um die End-to-End-Pipeline (Server → Agent → ansible-pull → Rolle) nachzuweisen. Echte Rolleninhalte folgen später.
## Neue Rolle hinzufügen
1. `roles/<name>/tasks/main.yml` anlegen
2. Eintrag in `site.yml` mit `tags: <name>` ergänzen
3. Entsprechenden `ansible_role`-Wert in der `blueprints`-Tabelle referenzieren