Zum Inhalt springen
Orimora Docs

Git-Mirror

Ein Git-Mirror verbindet einen Ordner mit einem Git-Repository: Orimora committet und pusht die veröffentlichten Dokumente dieses Ordners bei jedem Veröffentlichen als Markdown ins Repo. Es ist eine von drei Outbound-Optionen — neben einen Ordner in eine statische Seite ziehen (ganz ohne Repo) und ein einzelnes Dokument an einen Webhook/n8n-Endpunkt senden — und ergänzt Webhooks (Ereignis-Benachrichtigungen) und Export (manuelle Einzeldownloads).

Voraussetzungen

Abschnitt betitelt „Voraussetzungen“
  • Capability Ordner freigeben (collection.share) und Schreibrecht auf der Kollektion — standardmäßig nur Admins
  • Server-Env: GIT_MIRROR_ENCRYPTION_KEY (der PAT wird verschlüsselt gespeichert — siehe Installation)
  • Für andere als die Standard-Hosts: GIT_MIRROR_ALLOWED_HOSTS
  • Ein Repository und ein Personal Access Token (PAT) mit Push-Recht auf den Ziel-Branch. SSH-Deploy-Keys sind bewusst nicht vorgesehen (HTTPS + PAT unterstützen GitHub, GitLab, Bitbucket, Gitea und Codeberg)

Repository verbinden

Abschnitt betitelt „Repository verbinden“
  1. Öffne in der Seitenleiste das Menü des Ordners (Kebab oder Rechtsklick) und wähle „Mit einem Dienst verbinden…”.
  2. Wähle den Dienst Git-Mirror (Push).
  3. Trage ein:
    • Repository-URL — z. B. https://github.com/acme/docs.git
    • Branch — Standard main
    • Pfad im Repo — optionaler Präfix, z. B. content/docs
    • Access-Token (PAT) — verschlüsselt gespeichert, wird nicht erneut angezeigt
  4. Repository verbinden. Orimora pusht die bereits veröffentlichten Dokumente des Ordners sofort und danach bei jedem weiteren Veröffentlichen.

Orimora schreibt eine Markdown-Datei pro veröffentlichtem Dokument (mit Frontmatter) unter dem Pfad-Präfix. Entwürfe und unveröffentlichte Dokumente werden nie gepusht.

Mirrors verwalten

Abschnitt betitelt „Mirrors verwalten“

Der Verbindungs-Dialog des Ordners listet seine Git-Mirrors. Pro Eintrag kannst du:

  • Resync — den gesamten Ordner neu pushen (z. B. nach dem Reparieren von Repo-Rechten)
  • Trennen — Orimora hört auf zu pushen; das Repository selbst bleibt unangetastet

Hat es geklappt?

Abschnitt betitelt „Hat es geklappt?“

Jeder Push wird als Delivery protokolliert: Status, HTTP-Code, Dauer und etwaiger Fehler. Ein pausierter Mirror zeigt den auslösenden Fehler. Der ehrliche End-to-End-Check ist das Repository selbst — prüfe, ob die Commits auf dem Ziel-Branch angekommen sind.

Siehe auch

Abschnitt betitelt „Siehe auch“