Modernizar Weblate¶

Mejoras de imagen Docker¶

La imagen oficial del Docker de Weblate (consulte Instalar con Docker) integra todos los pasos de mejora. Típicamente, ninguna interacción es necesaria más allá de tomar la más última (o al menos la más nueva) versión.

Ver también

Actualizar el contenedor de Docker

Instrucciones de mejoras genéricas¶

Siempre busca los cambios nuevos a Requisitos de software antes de mejorar. Una vez que todos los requisitos estén instalados o avanzados, asegure su settings.py coincida con los cambios en la configuración (consulte settings_example.py para corregir los valores).

Consulte siempre las Instrucciones de versión específica antes de actualizar. Si se salta alguna versión, asegúrese de seguir las instrucciones de todas las versiones que se salte durante dicha actualización. A veces es mejor actualizar gradualmente a una versión intermedia para garantizar una migración sin problemas. ¡La actualización a varias versiones debería funcionar, pero no está tan probada como las actualizaciones a una única versión!

Nota

Siempre respalde la base de datos completa antes de modernizar, tal que pueda recuperar la base de datos si falla la modernización, consulte Respaldar y trasladar Weblate.

Espere a que las colas de Celery queden vacías y, a continuación, detenga los procesos WSGI y Celery para evitar que se ejecuten procesos antiguos durante la actualización. De lo contrario, podrían producirse cambios incompatibles en la base de datos.

La cola de tareas de Celery no es una interfaz estable entre versiones, por lo que no se garantiza que las tareas en cola de la versión anterior funcionen después de la migración. Puede supervisar la longitud del Interfaz administrativa o mediante el uso de celery_queues.

Versión nueva de Weblate

Para instalaciones pip puede ser logrado por:

uv pip install -U "weblate[all]==version"

O, si tan solo quiere obtener la última versión liberada:

uv pip install -U "weblate[all]"

Si no deseas instalar todo de las dependencias opcionales haz:

uv pip install -U weblate

Al utilizar el checkout de Git, necesita obtener código fuente nuevo y actualiza su instalación:

cd weblate-src
git pull
# Update Weblate inside your Python environment
. ~/weblate-env/bin/uv pip install -e '.[all]'
# Install dependencies directly when not using Python environment
uv pip install --upgrade -e .
# Install optional dependencies directly when not using a Python environment
uv pip install --upgrade -e '.[all]'

Los lanzamientos nuevos de Weblate tendrían Dependencias de Python nuevos, compruebe si cubren las características que desea.
Mejora el archivo de la configuración siguiendo o bien settings_example.py, o bien Instrucciones de versión específica.
Modernizó la base de datos:
```
weblate migrate --noinput
```
Recoge estadísticas actuales de archivos (consulte Ejecutar servidor y Sirviendo archivos estáticos):
```
weblate collectstatic --noinput --clear
```
Comprime archivos JavaScript y CSS (opcional, consulte Comprimir bienes cliente):
```
weblate compress
```
Si está ejecutando una instalación desde Git, también regeneraría los archivos de configuración regional cada vez que migre. Puede hacerlo invocando:
```
weblate compilemessages
```
Verifica que su configuración es correcta (consulte además Puesta en marcha de entorno de producción):
```
weblate check --deploy
```
Reinicie el trabajador Celery (consulte Tareas en segundo plano con Celery).

Instrucciones de versión específica¶

Distinto en la versión 5.0: Las instrucciones específicas de la versión ahora son incluidas en las notas de lanzamiento, consulte Weblate 2026.5.

Upgrade from an older unsupported release¶

Direct upgrades are only supported for releases from the current or previous calendar year. If you need to upgrade across this boundary, upgrade first to an intermediate version as listed below. Upgrades skipping this step are not supported and will break.

Si está mejorando desde el lanzamiento 2.x siempre primero modernice a 3.0.1.
Si está mejorando desde el lanzamiento 3.x, siempre primero mejore a 4.0.4.
Si está mejorando desde el lanzamiento 4.x, siempre primero mejora a 5.0.2.
If you are upgrading from 5.0.x-5.9.x, always first upgrade to 5.10.4.
Upgrades from 5.10.x and newer are currently directly supported.

Ver también

Migrar desde otras bases de datos a PostgreSQL¶

Advertencia

MySQL y MariaDB no son mantenidos por más tiempo en Weblate. Debe migrar a PostgreSQL antes de mejorar.

Si está ejecutando Weblate con MySQL o MariaDB, considere migrar a PostgreSQL para un rendimiento mejor haciendo los pasos siguientes. Recuerde detener ambos, la web y los servidores Celert antes de todo, en otro caso tal vez finalice con datos inconsistentes.

Crear una base de datos en PostgreSQL¶

Suele ser una buena idea ejecutar Weblate en su propia base de datos, y una cuenta de usuario separada:

# If PostgreSQL was not installed before, set the main password
sudo -u postgres psql postgres -c "\password postgres"

# Create a database user called "weblate"
sudo -u postgres createuser -D -P weblate

# Create the database "weblate" owned by "weblate"
sudo -u postgres createdb -E UTF8 -O weblate weblate

Migrar a PostgreSQL con pgloader¶

EL pgloader es una herramienta de migración genérica para migrar datos a PostgreSQL. Puede utilizarlo para migrar su base de datos de Weblate.

Ajusta tu settings.py para utilizar PostgreSQL como base de datos.

Migra el esquema en la base de datos de PostgreSQL:

weblate migrate
weblate sqlflush | weblate dbshell

3. Run the pgloader to transfer the data. The following script can be used to migrate the database, but you might want to learn more about pgloader to better understand what it does, and tweak it to match your setup:

LOAD DATABASE
     FROM mysql://weblate:password@localhost/weblate
     INTO postgresql://weblate:password@localhost/weblate

WITH include no drop, truncate, create no tables, create no indexes, no foreign keys, disable triggers, reset sequences, data only

ALTER SCHEMA 'weblate' RENAME TO 'public'
;

Migrar de Pootle¶

Como Weblate fue escrito originalmente como un sustituto de Pootle, está mantenido para migrar las cuentas de usuario desde éste. Puede volcar los usuarios desde Pootle e importarlos mediante importusers.