Einleitung — Wenn tägliche Routine zur Stolperfalle wird
Viele Entwickler und technische Redakteure kennen das Szenario: Neue Content‑Workflows werden manuell hochgeladen, regelmäßige Exporte und Backups laufen per Hand, und die Anbindung von Produktdaten aus PIM oder Shop ist eine fragile Eigenentwicklung. Für Self‑Hosted-Instanzen ist zusätzlich die Kontrolle über Daten und Deployments zentral. Genau hier setzt Marqentra mit seiner API & CLI an: Sie ermöglichen automatisierte, reproduzierbare Abläufe rund um Content‑Produktion, Publishing und Datenintegration.
Voraussetzungen und erste Schritte
Bevor Sie Automatisierungen bauen, sollten folgende Grundlagen stehen:
- Eine laufende Marqentra Self‑Hosted‑Instanz und Zugangsdaten für einen API‑Account oder einen CLI‑Token.
- Ein Versions-Repository (z. B. Git) für Workflow‑Definitionen, Templates und Skripte.
- Ein Ort für Artefakte und Backups (z. B. internes Storage, SFTP oder objekt‑speicher wie S3).
Praktisch empfiehlt es sich, ein kurzes Test‑Repository anzulegen mit: Workflow‑JSON(s), Konfigurationsdateien und Deploy‑Skripten. So behalten Sie Änderungen, Review und Rollbacks im Griff.
Automatisches Deployen von Workflows via CLI & API
Ein häufiger Use‑Case: Neue oder aktualisierte Workflows automatisch in der Self‑Hosted‑Instanz ausrollen, sobald sie in Git landen.
Pattern: Git → CI → Marqentra
- Commit in Haupt-Branch triggert CI-Job (z. B. GitHub Actions, GitLab CI).
- CI prüft Validität der Workflow‑Datei (Schema‑Check) und führt Tests aus.
- Bei Erfolg ruft CI Marqentra CLI oder API auf, um Workflow zu deployen.
Konkrete Schritte im CI‑Job (Pseudobeschreibung):
- Checkout des Repos
- Schema‑Validierung der Workflow‑Definitionen
- marqentra-cli login --token $MARQ_TOKEN --host $MARQ_URL
- marqentra-cli deploy workflow --file workflows/product-feed.json
Alternativ lässt sich die API direkt ansprechen: das CI‑System sendet die Workflow‑Datei per HTTPS an den Marqentra‑Endpoint mit Authorisierungstoken. Verwenden Sie Umgebungsvariablen für Token und Endpunkt, niemals Hardcoded‑Secrets.
Idempotenz und Versionierung
Gestalten Sie Deploy‑Operationen idempotent: Aus einem Commit sollte kein doppelter Effekt entstehen. Setzen Sie Versionsfelder in Ihren Workflow‑Definitionen und prüfen Sie auf Server‑Seite, ob eine Datei bereits in gleicher Version existiert, bevor Sie überschreiben. So vermeiden Sie unerwünschte Rollbacks oder doppelte Tasks.
Scripting für Backups und Exports
Backups sind besonders bei Self‑Hosted‑Instanzen wichtig — nicht nur Inhalte, sondern auch Mediathek, Workflow‑Metadaten und Publikations‑Logs. Marqentra API & CLI lassen sich in einfache Backup‑Pipelines integrieren.
Backup‑Pattern
- Datenexport via API/CLI: Exportieren Sie Content‑Bundles, Mediadateien und Metadaten regelmäßig.
- Komprimieren und verschlüsseln: Packen Sie Exporte und verschlüsseln Sie Artefakte (z. B. GPG) vor der Übertragung.
- Archivierung: Speichern Sie Exporte an einem getrennten Ort (S3/Bucket, offsite SFTP) und behalten Sie Aufbewahrungsregeln.
Typischer Ablauf als Cron/CI‑Job:
- marqentra-cli export all --output /tmp/marq-export-$(date +%F).tar.gz
- gpg --encrypt --recipient backup@company.example /tmp/marq-export-....tar.gz
- aws s3 cp /tmp/... s3://company-marqentra-backups/ --storage-class STANDARD_IA
Falls Sie keine S3‑Integration nutzen, kann das gleiche Muster auf internen NAS‑Shares oder via SFTP angewendet werden. Ergänzen Sie Monitoring, das fehlschlagende Exporte rechtzeitig meldet.
Anbindung eigener Datenquellen: PIM, Shop und mehr
Die Verbindung externer Systeme (PIM, Shop, CRM) ist oft der größte Hebel für relevanten Content. Zwei bewährte Integrationsansätze:
1) Pull‑Connector (periodisch)
Ein Scheduler ruft periodisch die API des PIM/Shops ab, transformiert Daten (Mapping auf Marqentra‑Schemas) und sendet aktualisierte Items an Marqentra via API/CLI. Vorteile: kontrolliertes Rate‑Limit, leicht zu testen.
2) Push‑Connector (eventgetrieben)
Der Shop oder PIM sendet Webhooks bei Datenänderungen an einen kleinen Integrationsservice, der die Nachricht entgegennimmt, normalisiert und an Marqentra weiterleitet. Vorteil: minimale Latenz, weniger unnötige Abfragen.
Praktische Tipps für Connectors
- Nutzen Sie ein Transformations‑Layer (z. B. einfache Scripts oder ein kleines Node/Python‑Service) für Mapping und Validierung.
- Implementieren Sie Retry‑Logik und Dead‑Letter‑Queue bei fehlschlagenden Einträgen.
- Versionieren Sie Mappings separat und testen Sie Backwards‑Kompatibilität vor Deployment.
CI/CD‑Tipps für Ihre Self‑Hosted‑Instanz
Self‑Hosting bietet Kontrolle, verlangt aber Disziplin im Betrieb. Einige Best Practices:
- Trennen Sie Test‑ und Produktionsinstanzen. Testen Sie Deployments automatisiert, bevor Sie produktiv ausrollen.
- Automatisieren Sie Rollback‑Szenarien: Bei fehlerhaften Deployments sollte ein definiertes Rollback auslösend sein.
- Verwenden Sie Secrets‑Management (z. B. Vault, GitHub Secrets) für API‑Tokens. Legen Sie Token mit minimalen Rechten an.
- Beobachtung: Log‑Aggregation und Monitoring (CPU, Speicher, API‑Latenz) helfen, automatisierte Jobs stabil zu betreiben.
- Deployment‑Freigabe: Nutzen Sie Approvals in Ihrem CI, wenn kritische Workflows verändert werden.
Sicherheit, Datenschutz und Self‑Hosted‑Vorteile
Beim Self‑Hosted‑Betrieb behalten Sie die Datenhoheit: Content, Medien und Nutzerdaten liegen in Ihrer Infrastruktur. Deshalb sollten Security‑Checks fester Bestandteil der Automatisierung sein:
- Regelmäßige Rotation von API‑Tokens.
- Least‑Privilege für Service‑Accounts.
- Verschlüsselte Übertragung und Speicherung sensibler Exporte.
Marqentra erlaubt es, Automatisierung lokal zu betreiben und gleichzeitig zentrale Funktionen (Themenfindung, KI‑gestützte Erstellung, Redaktionsplanung und Publishing) in Ihre bestehenden Pipelines einzubinden — ohne Daten an Dritte abzugeben.
Praxisbeispiel: Kurzer Integrationsablauf für Produktbeschreibungen
Ein typischer Ablauf aus Sicht eines Entwicklers:
- PIM sendet Webhook bei Produktänderung an Integration Service.
- Service validiert und mapped Daten in das Marqentra‑Workflow‑Format.
- CI prüft Template und testet KI‑Prompts lokal (Sandbox) und versioniert die Änderungen.
- marqentra-cli deploy workflow --file updated-product-workflow.json
- Marqentra erstellt Content, prüft Qualität und terminiert Veröffentlichung.
- Export/Backup‑Job archiviert die Version zusammen mit Metadaten.
Dieses Pattern skaliert: Sie können mehrere Quellen anschließen, ohne zentrale Workflows händisch anzupassen.
Fazit und Handlungsaufforderung
Marqentra API & CLI geben Entwicklern die Werkzeuge, repetitive Aufgaben zu automatisieren, Backups reproduzierbar zu machen und eigene Datenquellen sicher anzubinden — ideal für Self‑Hosted‑Betrieb, bei dem Kontrolle und Datenschutz im Vordergrund stehen. Beginnen Sie mit kleinen, versionierten Schritten: ein Workflow im Repo, ein CI‑Job zum Deploy und ein einfacher Backup‑Cron. Aus diesen Bausteinen entstehen robuste Automatisierungs‑Pipelines, die Zeit sparen und Fehler reduzieren.
Marqentra entdecken und Demo testen: https://marqentra.com
Nächster Schritt
Marqentra selbst ausprobieren
Marqentra verbindet Themenfindung, KI-gestützte Content-Erstellung, Medienverwaltung, Redaktionsplanung, automatische Veröffentlichung und Analyse in einem zentralen System. Die eigenständige Marqentra-Software läuft auf dem eigenen Webspace bzw. Server. Für WordPress steht zusätzlich Marqentra for WordPress zur Verfügung.