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 v3.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. Hay también template-external-postgresql.yml lo cual no inicia un servidor PostgreSQL y le concede configurar un servidor externo de PostgreSQL.

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¶

También puede usar CLI para procesar plantillas y usar la configuración que es generada para crear objetos de inmediato.

$ 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 instancia de Weblate debería estar disponible después de una migración e implementación correcta en el parámetro WEBLATE_SITE_DOMAIN especificado.

Después de la configuración del contenedor, puede iniciar sesión como usuario admin con la contraseña proporcionada en WEBLATE_ADMIN_PASSWORD, o si no se fijó, con una contraseña aleatoria generada en el primer inicio.

Para restablecer la contraseña de admin reinicie el contenedor con WEBLATE_ADMIN_PASSWORD configurado como nueva contraseña en el respectivo 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 Variables de entorno de Docker para una lista completa de variables de entorno.