Zum Hauptinhalt springen

Dokumentation

Konfigurieren Sie Docusaurus, wenn der Mandant eine eigene Dokumentationsoberfläche veröffentlichen oder betreiben soll.

← Zur Übersicht der Mandanten-Komponenten

Dokumentation

Docusaurus

Veröffentlicht eine eigene Dokumentationsinstanz für den Mandanten.

Direkte Voraussetzungen: APISIX und Zugriff auf das Dokumentationsimage

Inventory
documentation.enable
Ansible-Tag
documentation
Inventory-Konfiguration

Relevanter Ausschnitt im Mandantenblock

YAML-Ausschnitt und 5 Parameter

documentation:
enable: true
domain: "docs.example.org"
image_project: "registry.gitlab.com/…/documentation"
image_tag: "latest"
gitlab_user: ""
gitlab_token: ""
shared_documentation: false
public: false
ParameterBedeutungErwartete Werte
domainÖffentlicher Hostname der Dokumentation.Vollständiger Hostname ohne https://
image_project / image_tagRegistry-Pfad und auszurollender Stand.Container-Registry-Pfad und freigegebener Tag
gitlab_user / gitlab_tokenZugang für ein privates Image.Deploy Token oder leer bei öffentlichem Image
shared_documentationNutzt eine Dokumentation gemeinsam über Mandanten hinweg.true oder false
publicErlaubt öffentlichen Zugriff ohne Anmeldung.true oder false