Upgrading Weblate

Actualitzacions de la imatge de Docker

La imatge oficial de Weblate Docker (vegeu Instal·lació mitjançant Docker) integra tots els passos d’actualització. Normalment, no es necessita cap interacció manual més enllà de treure la versió més recent (o almenys més recent).

Vegeu també

S’està actualitzant el contenidor Docker

Instruccions genèriques d’actualització

Always look for new changes to Requisits de programari before upgrading. Once all requirements are installed or upgraded, ensure your settings.py matches the changes in the configuration (consult settings_example.py for correct values).

Comproveu sempre Version-specific instructions abans d’actualitzar. Si ometeu alguna versió, assegureu-vos de seguir les instruccions de totes les versions que ometeu durant aquesta actualització. De vegades és millor actualitzar gradualment a una versió intermèdia per garantir una migració sense problemes. L’actualització en diverses versions hauria de funcionar, però no està tan ben provada com les actualitzacions d’una única versió!

Nota

Always back up the full database before upgrading, so that you can roll back the database if the upgrade fails, see Còpia de seguretat i moviment de Weblate.

  1. Espereu que les cues d’Api es quedin buides i, a continuació, atureu els processos WSGI i Celery per evitar que els processos antics s’executin durant l’actualització. En cas contrari, es podrien produir canvis incompatibles a la base de dades.

    La cua de tasques de Celery no és una interfície estable entre les versions, de manera que no es garanteix que les tasques a la cua de la versió antiga funcionin després de l’actualització. Podeu controlar la longitud de la cua a la Interfície de gestió o utilitzant celery_queues.

  2. Upgrade Weblate

    Per a les instal·lacions de pip, es pot aconseguir mitjançant:

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

    O, si només voleu obtenir la darrera versió publicada:

    uv pip install -U "weblate[all]"

    Si no voleu instal·lar totes les dependències opcionals, feu el següent:

    uv pip install -U weblate

    Amb Git Checkout, heu d’aconseguir el codi font nou i actualitzar la instal·lació:

    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]'

  3. Les noves versions de Weblate poden tenir nous Dependències de Python, comproveu si cobreixen les funcions que voleu.

  4. Actualitzeu el fitxer de configuració seguint settings_example.py o Version-specific instructions.

  5. Actualitza la base de dades:

    weblate migrate --noinput

  6. Recolliu fitxers estàtics actualitzats (vegeu Servidor en execució i Donant arxius estàtics):

    weblate collectstatic --noinput

  7. Si esteu executant una instal·lació des de Git, també hauríeu de regenerar els fitxers de configuració regional cada vegada que actualitzeu. Podeu fer-ho invocant:

    weblate compilemessages

  8. Verify that your setup is sane (see also Configuració de producció):

    weblate check --deploy

  9. Reinicieu el treballador de Celery (vegeu Tasques de fons amb api).

    Some upgrades run translation-memory scope backfill and consolidation in the background using periodic Celery tasks. Keep Celery running after the upgrade and monitor progress in Administration > Performance report. See Translation-memory scopes for details.

Version-specific instructions

Canviat a la versió 5.0: Les instruccions específiques de la versió ara s’inclouen a les notes de la versió, vegeu Weblate 2026.9.1.

Actualitza des d’una versió anterior no compatible

Les actualitzacions directes només s’admeten per a versions de l’any natural actual o anterior. Si necessiteu actualitzar més enllà d’aquest límit, actualitzeu primer a una versió intermèdia tal com es mostra a continuació. Les actualitzacions que salten aquest pas no són compatibles i es trencaran.

  • Si esteu actualitzant des de la versió 2.x, sempre primer actualitzeu a la 3.0.1.

  • Si esteu actualitzant des de la versió 3.x, sempre primer actualitzeu a la 4.0.4.

  • Si esteu actualitzant des de la versió 4.x, sempre primer actualitzeu a la 5.0.2.

  • Si esteu actualitzant de 5.0.x-5.9.x, sempre primer actualitzeu a 5.10.4.

  • Actualment, s’admeten directament les actualitzacions de 5.10.x i posteriors.

Vegeu també

Migració d’altres bases de dades a PostgreSQL

Avís

MySQL i MariaDB ja no són compatibles amb Weblate. Heu de migrar a PostgreSQL abans d’actualitzar.

Si esteu executant Weblate amb MySQL o MariaDB, considereu migrar a PostgreSQL per obtenir un millor rendiment seguint els passos següents. Recordeu aturar els dos servidors web i Celery per endavant, en cas contrari, podríeu acabar amb dades inconsistents.

Creació d’una base de dades en PostgreSQL

Normalment és una bona idea executar Weblate en una base de dades independent i un compte d’usuari independent:

# 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

Migració a PostgreSQL mitjançant pgloader

El pgloader és una eina de migració genèrica per migrar dades a PostgreSQL. Podeu utilitzar-lo per migrar la vostra base de dades Weblate.

  1. Ajusteu el vostre settings.py per utilitzar PostgreSQL com a base de dades.

  2. Migreu l’esquema a la base de dades 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'
;

Migrant des de Pootle

Com que Weblate es va escriure originalment com a reemplaçament de Pootle, s’admet per migrar-ne els comptes d’usuari. Podeu abocar els usuaris de Pootle i importar-los mitjançant importusers.