Skip to main content

​
Versionierung

Eine solide Versionierungsstrategie ist essentiell für die Wartbarkeit und Zuverlässigkeit Ihrer Automate-Workflows.

​
Warum Versionierung wichtig ist

Rückverfolgbarkeit

Sie können Änderungen nachverfolgen und bei Problemen zu früheren Versionen zurückkehren.

Teamarbeit

Teams können parallel arbeiten ohne sich gegenseitig zu überschreiben.

Rollback

Bei Problemen können Sie schnell zu einer funktionierenden Version zurückkehren.

Audit

Versionierung ermöglicht Compliance und Audit-Trails.

​
Automate-Versionierung

​
Workflow-Versionen

Automate speichert automatisch Versionen Ihrer Workflows:
Wie es funktioniert:
  • Jede Änderung erstellt eine neue Version
  • Versionen werden mit Timestamp gespeichert
  • Sie können zwischen Versionen wechseln
  • Alte Versionen bleiben verfügbar
Automate speichert die letzten 50 Versionen automatisch.
So sehen Sie Versionen:
  1. Öffnen Sie den Workflow
  2. Klicken Sie auf “Versions” Tab
  3. Sehen Sie alle gespeicherten Versionen
  4. Wählen Sie eine Version zum Anzeigen
{
  "version": "1.2.3",
  "createdAt": "2024-01-15T10:30:00Z",
  "createdBy": "user@example.com",
  "changes": "Added error handling for API calls"
}
So stellen Sie eine Version wieder her:
  1. Öffnen Sie Versions-Historie
  2. Wählen Sie die gewünschte Version
  3. Klicken Sie auf “Restore”
  4. Bestätigen Sie die Wiederherstellung
Das Wiederherstellen überschreibt die aktuelle Version. Erstellen Sie vorher ein Backup!

​
Git-basierte Versionierung

​
Workflows in Git speichern

Für erweiterte Versionierung können Sie Workflows in Git exportieren:
1

Workflow exportieren

  1. Öffnen Sie den Workflow
  2. Klicken Sie auf “Export”
  3. Wählen Sie Format: JSON
  4. Speichern Sie die Datei
2

In Git committen

  1. Erstellen Sie Repository-Struktur:
workflows/
├── welcome-email.json
├── order-processing.json
└── support-tickets.json
  1. Committen Sie Änderungen:
git add workflows/
git commit -m "Update welcome email workflow"
git push
3

Versionierung nutzen

  1. Verwenden Sie Git Tags für Releases:
git tag -a v1.0.0 -m "Initial workflow version"
git push --tags
  1. Nutzen Sie Branches für Experimente:
git checkout -b feature/new-workflow
# Änderungen machen
git commit -m "Add new workflow feature"

​
Git-Workflow-Struktur

Empfohlene Struktur: 
localmind-workflows/
├── .gitignore
├── README.md
├── workflows/
│   ├── production/
│   │   ├── welcome-email.json
│   │   └── order-processing.json
│   ├── staging/
│   │   └── welcome-email.json
│   └── development/
│       └── test-workflow.json
├── scripts/
│   ├── export-all.sh
│   └── import-workflow.sh
└── docs/
    └── workflow-documentation.md

​
Backup-Strategien

​
Automatische Backups

Regelmäßige Exports

Tägliche/Wöchentliche Exports:
  • Automatisieren Sie Workflow-Exports
  • Speichern Sie in sicherem Speicher
  • Behalten Sie mehrere Backup-Generationen

Vor wichtigen Änderungen

Manuelle Backups:
  • Exportieren Sie vor größeren Änderungen
  • Erstellen Sie Snapshot vor Updates
  • Testen Sie Backups regelmäßig

​
Backup-Skript Beispiel

#!/bin/bash
# backup-workflows.sh

BACKUP_DIR="./backups/$(date +%Y-%m-%d)"
mkdir -p "$BACKUP_DIR"

# Exportiere alle Workflows
# (Dies würde über Automate API erfolgen)

echo "Backups erstellt in: $BACKUP_DIR"

​
Versionsnummern

​
Semantische Versionierung

Verwenden Sie semantische Versionierung für Workflows: Format: MAJOR.MINOR.PATCH
  • MAJOR: Breaking Changes
  • MINOR: Neue Features, rückwärtskompatibel
  • PATCH: Bugfixes
Beispiele:
  • 1.0.0 - Initial Release
  • 1.1.0 - Neue Features hinzugefügt
  • 1.1.1 - Bugfix
  • 2.0.0 - Breaking Changes

​
Versions-Tags in Git

# Major Release
git tag -a v2.0.0 -m "Major update with breaking changes"

# Minor Release
git tag -a v1.1.0 -m "Added new features"

# Patch Release
git tag -a v1.0.1 -m "Fixed critical bug"

​
Best Practices

Regelmäßige Backups

Erstellen Sie regelmäßige Backups, besonders vor größeren Änderungen.

Commit-Messages

Verwenden Sie aussagekräftige Commit-Messages, die Änderungen beschreiben.

Tags verwenden

Nutzen Sie Git Tags für wichtige Releases und Meilensteine.

Dokumentation

Dokumentieren Sie Versionsänderungen in CHANGELOG.md.

​
CHANGELOG Beispiel

# Changelog

## [2.0.0] - 2024-01-15

### Breaking Changes
- Workflow-Struktur geändert: Neue Node-Reihenfolge erforderlich
- API-Endpunkt geändert: Migration erforderlich

### Added
- Neue Error-Handling-Logik
- Retry-Mechanismus für API-Calls
- Performance-Monitoring

### Changed
- Verbesserte Datenvalidierung
- Optimierte API-Call-Reihenfolge

### Fixed
- Bug bei Timeout-Behandlung
- Fehlerhafte Daten-Transformation behoben

## [1.1.0] - 2024-01-01

### Added
- Neue E-Mail-Templates
- Erweiterte Logging-Funktionen

​
Migration zwischen Versionen

​
Upgrade-Strategie

1

Backup erstellen

Exportieren Sie die aktuelle Version als Backup.
2

Änderungen prüfen

Lesen Sie CHANGELOG und prüfen Sie Breaking Changes.
3

Test-Umgebung

Testen Sie neue Version in Staging/Development.
4

Migration

Führen Sie Migration in Production durch.
5

Validierung

Überprüfen Sie, dass alles funktioniert.

​
Checkliste

  • Workflows sind in Git versioniert
  • Regelmäßige Backups werden erstellt
  • Versionsnummern werden verwendet
  • CHANGELOG wird gepflegt
  • Migration-Strategien sind dokumentiert
  • Backup-Wiederherstellung wurde getestet
Weiterführende Themen: Lesen Sie auch unsere Seiten zu Dokumentation und Sicherheit für weitere Best Practices.