Installeren op OpenShift¶

Met het OpenShift sjabloon voor Weblate kunt u uw persoonlijke instantie van Weblate in seconden in bedrijf hebben. Alle afhankelijkheden van Weblate zijn al opgenomen. PostgreSQL wordt ingesteld als standaard database en blijvende volumeclaims worden gebruikt.

U vindt het sjabloon op <https://github.com/WeblateOrg/openshift/>.

Installatie¶

De volgende voorbeelden gaan ervan uit dat u een werkende omgeving voor OpenShift v3.x hebt, met oc cliëntprogramma geïnstalleerd. Bekijk de documentatie van OpenShift voor instructies.

template.yml is geschikt voor het uitvoeren van alle onderdelen in OpenShift. Er is ook template-external-postgresql.yml data geen server voor PostgreSQL start en u in staat stelt een externe server voor PostgreSQL te configureren.

Webconsole¶

Kopieer de ruwe inhoud van template.yml en importeer die in uw project, gebruik dan de knop Create in de OpenShift webconsole om uw toepassing te maken. De webconsole zal u vragen naar de waarden voor alle parameters die worden gebruikt door het sjabloon.

CLI¶

Geef, om het sjabloon van Weblate naar de bibliotheek voor sjablonen van uw huidige project te uploaden, het bestand template.yml door met de volgende opdracht:

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

Het sjabloon is nu beschikbaar om te selecteren met de webconsole of de CLI.

Parameters¶

De parameters die u kunt overschrijven zijn vermeld in het gedeelte parameters van het sjabloon. U kunt ze vermelden met de CLI door de volgende opdracht te gebruiken en het te gebruiken bestand specificeert:

$ 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

Verschaffen¶

U kunt ook de CLI gebruiken om sjablonen te verwerken en de configuratie gebruiken die is gegenereerd om direct objecten te maken.

$ 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

De instantie van Weblate zou beschikbaar moeten zijn na een succesvolle migratie en uitrol op de gespecificeerde parameter WEBLATE_SITE_DOMAIN.

Na het opstellen van de container kunt u inloggen als gebruiker admin met het wachtwoord dat is opgegeven in WEBLATE_ADMIN_PASSWORD, of een willekeurig wachtwoord dat is gegenereerd bij het eerste opstarten, als dat niet was ingesteld.

Herstellen van het wachtwoord van admin, start de container opnieuw op met WEBLATE_ADMIN_PASSWORD ingesteld op het nieuwe wachtwoord in de respectievelijke Secret.

Afbreken¶

$ 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

Configuratie¶

Door het verwerken van het sjabloon zal een respectievelijke ConfigMap worden gemaakt en die kan worden gebruikt om de image van Weblate aan te passen. De ConfigMap is direct gemount als omgevingsvariabelen en activeert een nieuwe uitrol, elke keer als hij wordt gewijzigd. Voor meer opties voor configureren, bekijk Docker omgevingsvariabelen voor ene volledige lijst met omgevingsvariabelen.