Wie bilde ich den Ablauf einer Provisionierung als Workflow ab?

Ab Tarif Elite

Kurzantwort

Auf dem Reiter Workflows des Bereichs Provisionierung dokumentierst du den Ablauf einer Bereitstellung: Name, Typ (Provisionierung oder Deprovisionierung), die Schritte in Reihenfolge und optional der Skript-Ablageort des zugehörigen Automatisierungs-Skripts. So ist für das ganze Team nachvollziehbar, wie ein System aufgesetzt und wieder abgebaut wird.

Voraussetzungen

Die Provisionierung ist ab Tarif Elite verfügbar.

Reiter „Workflows” öffnen. Wähle Provisionierung und wechsle auf den Reiter Workflows. Die Tabelle zeigt vorhandene Workflows mit Name, Typ und Skript-Ablageort.

Screenshot ausstehend provisioning-ablauf-01 Reiter Workflows im Bereich Provisionierung mit dem Dialog 'Workflow hinzufügen'

Ein Workflow mit Schritten und Skript-Ablageort.
Workflow anlegen. Klicke „Workflow hinzufügen” und fülle den Dialog:
- Name (Pflicht): z. B. „Neuer Webserver (Standard)”.
- Typ (Pflicht): Provisionierung oder Deprovisionierung.
- Schritte: der Ablauf in Reihenfolge, ein Schritt pro Zeile, z. B.:
  Beispiel-Schritte
```
1. VM aus Basis-Image klonen
2. IP aus dem Netzwerk-Modul reservieren
3. Vorlage 'Nginx vHost Standard' rendern und ausrollen
4. System ins Monitoring aufnehmen
5. Asset in Notory anlegen und verknüpfen
```
- Skript-Ablageort (optional): Pfad/Repo des Automatisierungs-Skripts, z. B. ansible/playbooks/webserver.yml.
- Beschreibung (optional).
Speichern. Der Workflow erscheint in der Liste und dient ab jetzt als verbindliche Ablaufdokumentation.

Workflow anlegen ist ein POST auf /api/v1/provisioning/workflows (Scope write):

curl -X POST https://demo.notory.io/api/v1/provisioning/workflows \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Neuer Webserver (Standard)",
    "workflow_type": "provisioning",
    "steps": "1. VM klonen\n2. IP reservieren\n3. Vorlage rendern\n4. Monitoring aufnehmen\n5. Asset anlegen",
    "script_path": "ansible/playbooks/webserver.yml",
    "description": "Standardablauf für neue Webserver"
  }'

{
  "id": "wf_2b3c…",
  "tenant_id": "3d9b0c12-…",
  "name": "Neuer Webserver (Standard)",
  "workflow_type": "provisioning",
  "steps": "1. VM klonen\n2. IP reservieren\n3. Vorlage rendern\n4. Monitoring aufnehmen\n5. Asset anlegen",
  "script_path": "ansible/playbooks/webserver.yml",
  "description": "Standardablauf für neue Webserver",
  "created_at": "2026-07-08T11:30:00Z",
  "updated_at": "2026-07-08T11:30:00Z"
}

Auflisten mit GET /api/v1/provisioning/workflows, Ändern per PUT, Löschen per DELETE (nur Administratoren).

Mögliche Fehler: 401, 403 (Provisionierung nicht im Tarif oder kein Schreibrecht), 404 (Workflow nicht gefunden), 422 (Validierung).

Was passiert dabei?

Dokumentation, keine Ausführung: Notory führt Workflows nicht aus. Sie sind die verbindliche, versionierte Beschreibung des Ablaufs. Das referenzierte Skript (Skript-Ablageort) läuft in deiner eigenen Automatisierung (z. B. Ansible, CI).
Zusammenspiel der Module: Ein typischer Ablauf verweist auf Vorlagen (Konfiguration erzeugen), das Netzwerk-Modul (IP reservieren), das Monitoring (System aufnehmen) und die Assets (Bestand pflegen).
Mandanten-Isolation & Audit: Workflows gehören deinem Mandanten; jede Änderung wird protokolliert.