# provisioning-agent

Der Tuxflotte Provisioning Agent läuft auf installierten Geräten, meldet sich in regelmäßigen Abständen bei `anode` und wendet die ihm zugewiesenen Ansible-Rollen per `ansible-pull` an (siehe `ansible-content/`).

**Stand:** Kernschleife (Check-in → ansible-pull) sowie Auftragskatalog (present/absent, Ergebnis-Report) laufen. Die Einrichtung vor dem ersten Reboot ist über `backend_postinstall()` im Fedora-Backend angebunden (`tuxflotte-installer/backends/fedora/kickstart.tpl`), ruft dabei denselben `POST /api/v1/agent/bootstrap`-Endpoint auf, der hier für die manuelle Testgerät-Einrichtung beschrieben ist.

## Auftragskatalog (ADR-0010)

Neben den additiv über den Workspace zugewiesenen Blueprints liefert der Check-in zusätzlich `auftraege`: den vollständigen present/absent-Zustand aller katalogfähigen Merkmale für das Gerät. Der Agent führt beide Listen in einem gemeinsamen `ansible-pull`-Lauf aus (`--tags` = Vereinigung aller Rollennamen, `--extra-vars` reicht `tuxflotte_auftrag_states` als Rolle→Zustand-Dict durch, siehe `ansible-content/README.md`) und meldet danach das Ergebnis je Auftragskatalog-Eintrag per `POST /api/v1/agent/report` zurück (`applied`/`apply_failed`/`removed`/`remove_failed`). Das Ergebnis ist grob granular — ein `ansible-pull`-Lauf hat einen einzigen Exit-Code für alle enthaltenen Rollen, es gibt noch keine Rolle-für-Rolle-Auswertung.

## Manuelle Installation (Testgerät)

Voraussetzung: `ansible-core` ist installiert (`ansible-pull` im PATH).

1. Gerät aktivieren und Bereitstellungsvorlage zuweisen (bestehender Provisioning-Flow, siehe `provisioning-server`)
2. Agent-Secret erzeugen:

   ```
   curl -X POST https://anode.tuxflotte.de/api/v1/agent/bootstrap \
        -H "Content-Type: application/json" \
        -d '{"device_id": "<device-uuid>"}'
   ```

3. Credentials ablegen:

   ```
   install -d -m 0700 /etc/tuxflotte
   cat > /etc/tuxflotte/agent.credentials <<EOF
   {"device_id": "<device-uuid>", "agent_secret": "<agent-secret aus Schritt 2>"}
   EOF
   chmod 0600 /etc/tuxflotte/agent.credentials
   ```

4. Agent-Code ablegen und Dienst einrichten:

   ```
   install -d /opt/tuxflotte/agent
   cp agent.py /opt/tuxflotte/agent/
   cp tuxflotte-agent.service /etc/systemd/system/
   systemctl daemon-reload
   systemctl enable --now tuxflotte-agent
   ```

5. Prüfen:

   ```
   journalctl -u tuxflotte-agent -f
   ls /run/tuxflotte/agent/applied/
   ```

## Konfiguration

| Umgebungsvariable | Zweck | Default |
|---|---|---|
| `TUXFLOTTE_ANODE_URL` | Basis-URL des Provisioning-Servers | `https://anode.tuxflotte.de` |
| `TUXFLOTTE_AGENT_CREDENTIALS` | Pfad zur Credentials-Datei | `/etc/tuxflotte/agent.credentials` |