S’està instal·lant a OpenShift¶

Amb la plantilla d’OpenShift Weblate, podeu posar en funcionament la vostra instància personal de Weblate en qüestió de segons. Totes les dependències de Weblate ja estan incloses. PostgreSQL es configura com a base de dades predeterminada i s’utilitzen reclamacions de volum persistents.

Podeu trobar la plantilla a <https://github.com/WeblateOrg/openshift/>.

Installation¶

Els exemples següents suposen que teniu un entorn OpenShift v3.x que funciona, amb l’eina de client oc instal·lada. Consulteu la documentació d’OpenShift per obtenir instruccions.

El template.yml és adequat per executar tots els components a OpenShift. També hi ha template-external-postgresql.yml que no inicia un servidor PostgreSQL i us permet configurar un servidor PostgreSQL extern.

Web Console¶

Copy the raw content from template.yml and import them into your project, then use the Create button in the OpenShift web console to create your application. The web console will prompt you for the values for all of the parameters used by the template.

CLI¶

Per carregar la plantilla de Weblate a la biblioteca de plantilles del vostre projecte actual, passeu el fitxer template.yml amb l’ordre següent:

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

La plantilla ara està disponible per seleccionar-la mitjançant la consola web o la CLI.

Parameters¶

Els paràmetres que podeu substituir es mostren a la secció de paràmetres de la plantilla. Podeu llistar-los amb la CLI utilitzant l’ordre següent i especificant el fitxer que s’utilitzarà:

$ 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

Provisioning¶

També podeu utilitzar la CLI per processar plantilles i utilitzar la configuració que es genera per crear objectes immediatament.

$ 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

La instància de Weblate hauria d’estar disponible després de la migració i el desplegament correctes al paràmetre WEBLATE_SITE_DOMAIN especificat.

After container setup, you can sign in as admin user with password provided in WEBLATE_ADMIN_PASSWORD, or a random password generated on first start if that was not set.

Per restablir la contrasenya admin, reinicieu el contenidor amb WEBLATE_ADMIN_PASSWORD establerta com a nova contrasenya al respectiu Secret.

Eliminate¶

$ 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

Configuration¶

En processar la plantilla, es crearà un ConfigMap respectiu que es pot utilitzar per personalitzar la imatge del Weblate. El ConfigMap es munta directament com a variables d’entorn i desencadena un nou desplegament cada vegada que es canvia. Per obtenir més opcions de configuració, vegeu Variables d’entorn de Docker per a la llista completa de variables d’entorn.