Instalar en OpenShift¶

Con la plantilla de Weblate de OpenShift, puede poner en funcionamiento su instancia personal de Weblate en cuestión de segundos. Todas las dependencias de Weblate ya están incluidas. PostgreSQL se configura como la base de datos predeterminada y se utilizan las notificaciones de volumen persistentes.

Puede encontrar la plantilla en <https://github.com/WeblateOrg/openshift/>.

Instalación¶

Los ejemplos siguientes presuponen que cuenta con un entorno OpenShift versión 3.x en funcionamiento y la herramienta de cliente oc instalada. Consulte la documentación de OpenShift para obtener instrucciones.

El template.yml es adecuado para ejecutar todos los componentes en OpenShift. También está template-external-postgresql.yml que no inicia un servidor PostgreSQL y permite configurar un servidor PostgreSQL externo.

Consola web¶

Copie el contenido sin procesar de template.yml e impórtelos a su proyecto, luego use el botón Create para crear su aplicación. La consola web le pedirá los valores de todos los parámetros utilizados por la plantilla.

CLI¶

Para cargar la plantilla de Weblate en la biblioteca de plantillas de su proyecto actual, pase el archivo template.yml con el siguiente comando:

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

La plantilla ya está disponible para su selección mediante la consola web o la CLI.

Parámetros¶

Los parámetros que puede anular se enumeran en la sección parámetros de la plantilla. Puede enumerarlos con la CLI utilizando el siguiente comando y especificando el archivo que se utilizará:

$ 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

Aprovisionamiento¶

You can also use the CLI to process templates and use the configuration that is generated to create objects immediately.

$ 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

The Weblate instance should be available after successful migration and deployment at the specified WEBLATE_SITE_DOMAIN parameter.

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.

To reset admin password, restart the container with WEBLATE_ADMIN_PASSWORD set to new password in the respective Secret.

Eliminar¶

$ 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

Configuración¶

Al procesar la plantilla se creará un ConfigMap respectivo que se puede utilizar para personalizar la imagen de Weblate. El ConfigMap se monta directamente como variables de entorno y desencadena un nuevo despliegue cada vez que se modifica. Para más opciones de configuración, véase Docker environment variables para una lista completa de variables de entorno.