Weblate frissítése¶

Docker-képfájlok frissítése¶

A hivatalos Weblate Docker-kép (lásd: Telepítés Docker használatával) minden frissítési lépést integrál. Általában nincs szükség manuális beavatkozásra azon kívül, hogy letölti a legújabb (vagy legalább újabb) verziót.

Lásd még

Docker-konténer frissítése

Általános frissítési útmutató¶

Mindig ellenőrizze a Szoftverkövetelmények változásait frissítés előtt. Miután az összes követelményt telepítette vagy frissítette, győződjön meg róla, hogy a settings.py megfelel az új beállításoknak (ehhez használja a settings_example.py fájlt mintának).

Mindig nézze meg a Verzióspecifikus útmutatások részt is frissítés előtt. Ha verziókat kihagyva frissít, kövesse az összes kimaradó verzióhoz tartozó útmutatót. Néha érdemes köztes verziók telepítésével fokozatosan haladni a zökkenőmentes átállás érdekében. Több verzió átugrásával is lehet frissíteni, de ez kevésbé van tesztelve, mint az egy verzión belüli frissítés!

Megjegyzés

Mindig készítsen teljes adatbázis-mentést frissítés előtt, hogy sikertelen frissítés esetén vissza tudjon állni, lásd: Weblate biztonsági mentése és áthelyezése.

Állítsa le a WSGI- és Celery-folyamatokat a frissítés idejére, hogy elkerülje a régi folyamatok futását. Ellenkező esetben inkompatibilis adatbázisváltozások léphetnek fel.

A Weblate frissítése

Pip-es telepítés esetén a következő módon frissíthet:

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

Vagy, ha a legújabb kiadott verziót szeretné:

uv pip install -U "weblate[all]"

Ha nem kívánja az összes opcionális függőséget telepíteni, tegye ezt:

uv pip install -U weblate

Git-es klónozás esetén töltse le az új forráskódot és frissítse a telepítést:

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

Az új Weblate kiadások új Python függőségek függőségeket is tartalmazhatnak, ellenőrizze, hogy ezek lefedik-e a kívánt funkciókat.
Frissítse a konfigurációs fájlt a settings_example.py vagy a Verzióspecifikus útmutatások útmutatásai szerint.
Frissítse az adatbázist:
```
weblate migrate --noinput
```
Gyűjtse össze a frissített statikus fájlokat (lásd: Szerver futtatása és Statikus fájlok kiszolgálása):
```
weblate collectstatic --noinput --clear
```
Tömörítse a JavaScript- és CSS-fájlokat (opcionális, lásd: Kliensoldali fájlok tömörítése):
```
weblate compress
```
Ha Git-alapú telepítést használ, minden frissítés után újra kell generálnia a lokalizációs fájlokat. Ezt az alábbi paranccsal teheti meg:
```
weblate compilemessages
```
Ellenőrizze, hogy a beállítások helyesek-e (lásd még Éles környezet beállítása):
```
weblate check --deploy
```
Indítsa újra a Celery-munkafolyamatot (lásd: Háttérfeladatok Celery használatával).

Verzióspecifikus útmutatások¶

A 5.0 verzióban változott: A verzióspecifikus útmutatások mostantól a kiadási megjegyzésekben találhatók, lásd: Weblate 5.12.

Frissítés régebbi főverzióról¶

Főverziók közötti frissítés nem támogatott. Mindig frissítsen először az adott főverzió legújabb javítókiadására. A köztes lépés kihagyása nem támogatott, és rendszerhibát okozhat.

Ha a 2.x kiadásról frissít, először mindig a 3.0.1 verzióra frissítsen.
Ha a 3.x kiadásról frissít, először mindig a 4.0.4 verzióra frissítsen.
Ha a 4.x kiadásról frissít, először mindig az 5.0.2 verzióra frissítsen.

Lásd még

Frissítés 2.20-ról 3.0-ra a Weblate 3.0 dokumentációjában, Frissítés 3.11-ről 4.0-ra a Weblate 4.0 dokumentációjában, Frissítés 4.x-ről 5.0.2-re a Weblate 5.0 dokumentációjában

Más adatbázisról PostgreSQL-re való átállás¶

Ha nem PostgreSQL adatbázist használ Weblate futtatásához, érdemes áttérni PostgreSQL-re a jobb teljesítmény érdekében az alábbi lépések követésével. Ne feledje, hogy előtte állítsa le mind a web-, mind a Celery-szervert, különben adatintegritási problémák léphetnek fel.

Adatbázis létrehozása PostgreSQL-ben¶

Általában jó ötlet külön adatbázist és külön felhasználói fiókot használni Weblate számára:

# 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

Átállás PostgreSQL-re pgloader használatával¶

A pgloader egy általános migrációs eszköz, amely lehetővé teszi adatok áthelyezését PostgreSQL-re. Ezzel migrálhatja Weblate adatbázisát is.

Állítsa be a settings.py fájlt úgy, hogy PostgreSQL adatbázist használjon.

Migrálja az adatbázissémát a PostgreSQL adatbázisba:

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

Átállás Pootle rendszerről¶

Mivel a Weblate eredetileg a Pootle helyettesítésére készült, támogatott a felhasználói fiókok migrálása onnan. A felhasználókat a Pootle rendszerből ki lehet exportálni, majd a importusers parancs segítségével lehet importálni.