HedgeDoc

HedgeDoc

#

HedgeDoc ist ein kollaborativer Markdown-Editor, der es mehreren Benutzern ermöglicht, gleichzeitig an Dokumenten zu arbeiten. Er bietet eine einfache und intuitive Oberfläche für die Erstellung und Bearbeitung von Markdown-Inhalten.

Status

#

Deployment

#

Quelle

#

Die Anwendung wird als generisches app-template Helm-Chart von BJW-S Labs bereitgestellt.

Das Projekt basiert auf der offiziellen HedgeDoc-Website. Das Docker-Image stammt von quay.io/hedgedoc/hedgedoc. PostgreSQL: Offizielles Docker Image

Dokumentation

#

Die offizielle Dokumentation von HedgeDoc ist unter docs.hedgedoc.org zu finden.

• HedgeDoc GitHub Repository

Funktion

#

HedgeDoc dient als Plattform für die kollaborative Erstellung von Notizen, Dokumentationen und Präsentationen im Markdown-Format. Es ist ideal für Meetings, Brainstorming-Sitzungen oder das gemeinsame Verfassen von Texten. Die fertigen Dokumente können einfach geteilt und exportiert werden.

Lokale Anpassungen

#

Die Konfiguration erfolgt über Umgebungsvariablen in der values.yaml-Datei.

Wichtige Umgebungsvariablen

#

• CMD_DB_URL: Die Verbindungs-URL zur PostgreSQL-Datenbank.
• CMD_DOMAIN: Die öffentliche Domain der Anwendung.
• CMD_OAUTH2_*: Konfiguriert die OAuth2/OIDC-Authentifizierung über Authentik.
• CMD_LDAP_*: Konfiguriert die LDAP-Authentifizierung (aktuell: ldaps://addc.casa-due-pur.de:636).
• CMD_ALLOW_ANONYMOUS: Ist auf false gesetzt, sodass nur authentifizierte Benutzer Dokumente erstellen und bearbeiten können.

Wichtige Einstellungen

#

• Ingress: Der Zugriff auf die Weboberfläche wird über einen Ingress mit einem Hostnamen ermöglicht.
• Authentifizierung: Die Benutzeranmeldung ist sowohl über LDAP als auch über Authentik (OAuth2/OIDC) möglich. Eine lokale Registrierung ist deaktiviert.
• Datenbank: Eine PostgreSQL-Datenbank läuft als Sidecar-Container.
• Speicher: Hochgeladene Dateien (hedgedoc-uploads) und Datenbank (hedgedoc-db) werden persistent auf Longhorn-Volumes (PVC) gespeichert.

Installation

#

Die Anwendung wird mittels Kustomize und Helm durch ArgoCD im Kubernetes-Cluster bereitgestellt. Die Konfiguration befindet sich im apps/hedgedoc-Verzeichnis. Eine manuelle Installation kann mit folgendem Befehl durchgeführt werden:

1kubectl kustomize --enable-helm apps/hedgedoc | kubectl apply -n hedgedoc -f -

Abhängigkeiten

#

• Ein laufender Kubernetes-Cluster.
• Ein Ingress-Controller (z.B. Traefik) für den externen Zugriff.
• Eine Zertifikatsmanagement-Lösung (z.B. cert-manager) zur Bereitstellung von TLS-Zertifikaten.
• Longhorn: Als Storage-Provider für die PersistentVolumes.
• LDAP-Server: Für die LDAP-Benutzerauthentifizierung.
• Authentik: Als OAuth2/OIDC-Anbieter für SSO.