Installation auf OpenShift¶

Mit dem Kubernetes Helm-Diagramm können Sie Ihre persönliche Weblate-Instanz in Sekundenschnelle zum Laufen bringen. Alle Abhängigkeiten von Weblate sind bereits enthalten. PostgreSQL ist als Standarddatenbank eingerichtet und es werden dauerhafte Volume-Claims verwendet.

Sie finden die Vorlage unter <https://github.com/WeblateOrg/openshift/>.

Installation¶

Die folgenden Beispiele gehen davon aus, dass Sie eine funktionierende OpenShift v3.x-Umgebung haben, in der das Client-Tool oc installiert ist. Bitte lesen Sie in der OpenShift-Dokumentation nach, um Anweisungen zu erhalten.

Die template.yml ist für den Betrieb aller Komponenten in OpenShift geeignet. Es gibt auch die Datei template-external-postgresql.yml, die keinen PostgreSQL-Server startet und es Ihnen ermöglicht, einen externen PostgreSQL-Server zu konfigurieren.

Webkonsole¶

Kopieren Sie die Rohdaten aus template.yml und importieren Sie sie in Ihr Projekt. Verwenden Sie dann die Schaltfläche Create in der OpenShift-Webkonsole, um Ihre Anwendung zu erstellen. Die Webkonsole wird Sie nach den Werten für alle von der Vorlage verwendeten Parameter fragen.

CLI¶

Um die Weblate-Vorlage in die Vorlagenbibliothek Ihres aktuellen Projekts hochzuladen, übergeben Sie die Datei template.yml mit dem folgenden Befehl:

$ oc create -f https://raw.githubusercontent.com/WeblateOrg/openshift/main/template.yml \
   -n <PROJECT>

Die Vorlage kann nun über die Webkonsole oder das CLI ausgewählt werden.

Parameter¶

Die Parameter, die Sie überschreiben können, sind im Parameterbereich der Vorlage aufgeführt. Sie können diese mit der CLI auflisten, indem Sie den folgenden Befehl verwenden und die zu verwendende Datei angeben:

$ oc process --parameters -f https://raw.githubusercontent.com/WeblateOrg/openshift/main/template.yml

# If the template is already uploaded
$ oc process --parameters -n <PROJECT> weblate

Bereitstellung¶

Sie können Vorlagen auch über die Befehlszeilenschnittstelle (CLI) verarbeiten und die erzeugte Konfiguration verwenden, um sofort Objekte zu erstellen.

$ oc process -f https://raw.githubusercontent.com/WeblateOrg/openshift/main/template.yml \
    -p APPLICATION_NAME=weblate \
    -p WEBLATE_VERSION=4.3.1-1 \
    -p WEBLATE_SITE_DOMAIN=weblate.app-openshift.example.com \
    -p POSTGRESQL_IMAGE=docker-registry.default.svc:5000/openshift/postgresql:9.6 \
    -p REDIS_IMAGE=docker-registry.default.svc:5000/openshift/redis:3.2 \
    | oc create -f

Die Weblate-Instanz sollte nach erfolgreicher Migration und Bereitstellung unter dem angegebenen Parameter WEBLATE_SITE_DOMAIN verfügbar sein.

Nach der Container-Einrichtung können Sie sich als Benutzer admin mit dem in WEBLATE_ADMIN_PASSWORD bereitgestellten Passwort oder, falls es nicht festgelegt wurde, mit einem beim ersten Start generierten Zufallspasswort anmelden.

Um das admin-Passwort zurückzusetzen, starten Sie den Container neu, wobei WEBLATE_ADMIN_PASSWORD auf das neue Passwort im entsprechenden Secret gesetzt wird.

Beseitigen¶

$ oc delete all -l app=<APPLICATION_NAME>
$ oc delete configmap -l app= <APPLICATION_NAME>
$ oc delete secret -l app=<APPLICATION_NAME>
# ATTENTION! The following command is only optional and will permanently delete all of your data.
$ oc delete pvc -l app=<APPLICATION_NAME>

$ oc delete all -l app=weblate \
    && oc delete secret -l app=weblate \
    && oc delete configmap -l app=weblate \
    && oc delete pvc -l app=weblate

Konfiguration¶

Durch die Verarbeitung der Vorlage wird eine entsprechende ConfigMap erstellt, die zur Anpassung des Weblate-Images verwendet werden kann. Die ConfigMap wird direkt als Umgebungsvariable eingebunden und löst bei jeder Änderung eine neue Bereitstellung aus. Für weitere Konfigurationsoptionen siehe Docker-Umgebungsvariablen für eine vollständige Liste der Umgebungsvariablen.