ການອັບເກຣດ Weblate¶

ການອັບເກຣດ Docker image¶

Weblate Docker image ທາງການ (ເບິ່ງ ການຕິດຕັ້ງໂດຍໃຊ້ Docker) ໄດ້ລວມເອົາຂັ້ນຕອນການອັບເກຣດທັງໝົດໄວ້ແລ້ວ. ໂດຍປົກກະຕິ, ບໍ່ຈຳເປັນຕ້ອງມີການໂຕ້ຕອບດ້ວຍຕົນເອງນອກເໜືອໄປຈາກການດຶງເວີຊັນລ່າສຸດ (ຫຼືຢ່າງໜ້ອຍກໍເວີຊັນໃໝ່ກວ່າ).

ຄຳແນະນຳການອັບເກຣດທົ່ວໄປ¶

ໃຫ້ກວດເບິ່ງການປ່ຽນແປງໃໝ່ໆຕໍ່ ຄວາມຕ້ອງການດ້ານຊອບແວ ສະເໝີກ່ອນການອັບເກຣດ. ເມື່ອຕິດຕັ້ງ ຫຼືອັບເກຣດຄວາມຕ້ອງການທັງໝົດແລ້ວ, ໃຫ້ຮັບປະກັນວ່າ settings.py ຂອງທ່ານກົງກັບການປ່ຽນແປງໃນການຕັ້ງຄ່າ (ປຶກສາ settings_example.py ສຳລັບຄ່າທີ່ຖືກຕ້ອງ).

ກວດເບິ່ງ ຄຳແນະນຳສະເພາະເວີຊັນ ສະເໝີກ່ອນການອັບເກຣດ. ຖ້າທ່ານຂ້າມເວີຊັນໃດໜຶ່ງໄປ, ໃຫ້ແນ່ໃຈວ່າໄດ້ປະຕິບັດຕາມຄຳແນະນຳສຳລັບທຸກເວີຊັນທີ່ທ່ານຂ້າມໃນລະຫວ່າງການອັບເກຣດນັ້ນ. ບາງຄັ້ງການອັບເກຣດເທື່ອລະໜ້ອຍໄປຫາເວີຊັນກາງແມ່ນດີກວ່າເພື່ອໃຫ້ແນ່ໃຈວ່າການຍ້າຍລະບົບຈະເປັນໄປຢ່າງລຽບງ່າຍ. ການອັບເກຣດຂ້າມຫຼາຍເວີຊັນຄວນຈະເຮັດວຽກໄດ້, ແຕ່ບໍ່ໄດ້ຜ່ານການທົດສອບດີເທົ່າກັບການອັບເກຣດເທື່ອລະເວີຊັນ!

Note

ໃຫ້ສຳຮອງຖານຂໍ້ມູນທັງໝົດສະເໝີກ່ອນການອັບເກຣດ, ເພື່ອໃຫ້ທ່ານສາມາດຍ້ອນກັບຖານຂໍ້ມູນໄດ້ຫາກການອັບເກຣດລົ້ມເຫຼວ, ເບິ່ງ ການສຳຮອງຂໍ້ມູນ ແລະການຍ້າຍ Weblate.

ລໍຖ້າໃຫ້ຄິວ Celery ຫວ່າງເປົ່າ, ຈາກນັ້ນຢຸດໂປຣເຊສ WSGI ແລະ Celery ເພື່ອຫຼີກລ່ຽງບໍ່ໃຫ້ໂປຣເຊສເກົ່າເຮັດວຽກໃນຂະນະອັບເກຣດ. ຖ້າບໍ່ດັ່ງນັ້ນ, ອາດເກີດການປ່ຽນແປງທີ່ບໍ່ເຂົ້າກັນໃນຖານຂໍ້ມູນ.

ຄິວວຽກຂອງ Celery ບໍ່ແມ່ນອິນເຕີເຟດທີ່ໝັ້ນຄົງລະຫວ່າງເວີຊັນ, ສະນັ້ນວຽກທີ່ຢູ່ໃນຄິວຈາກເວີຊັນເກົ່າບໍ່ໄດ້ຮັບປະກັນວ່າຈະເຮັດວຽກໄດ້ຫຼັງຈາກອັບເກຣດ. ທ່ານສາມາດຕິດຕາມຄວາມຍາວຂອງຄິວໄດ້ໃນ ອິນເຕີເຟດການຈັດການ ຫຼືໂດຍໃຊ້ celery_queues.
ອັບເກຣດ Weblate

ສຳລັບການຕິດຕັ້ງຜ່ານ pip ສາມາດເຮັດໄດ້ໂດຍ:
```
uv pip install -U "weblate[all]==version"
```
ຫຼື, ຖ້າທ່ານພຽງແຕ່ຕ້ອງການໄດ້ເວີຊັນລ່າສຸດທີ່ປ່ອຍອອກມາ:
```
uv pip install -U "weblate[all]"
```
ຖ້າທ່ານບໍ່ຕ້ອງການຕິດຕັ້ງ dependencies ເພີ່ມເຕີມທັງໝົດ ໃຫ້ເຮັດດັ່ງນີ້:
```
uv pip install -U weblate
```
ການໃຊ້ Git checkout, ທ່ານຈຳເປັນຕ້ອງດຶງຊໍສ໌ໂຄດ (source code) ໃໝ່ ແລະອັບເດດການຕິດຕັ້ງຂອງທ່ານ:
```
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]'
```
ເວີຊັນໃໝ່ຂອງ Weblate ອາດມີ Python dependencies ໃໝ່, ໃຫ້ກວດເບິ່ງວ່າພວກມັນກວມເອົາຟີເຈີທີ່ທ່ານຕ້ອງການຫຼືບໍ່.
ອັບເກຣດໄຟລ໌ການຕັ້ງຄ່າໂດຍປະຕິບັດຕາມ settings_example.py, ຫຼື ຄຳແນະນຳສະເພາະເວີຊັນ.
ອັບເກຣດຖານຂໍ້ມູນ:
```
weblate migrate --noinput
```
ເກັບກຳໄຟລ໌ static ທີ່ອັບເດດແລ້ວ (ເບິ່ງ ການແລ່ນເຊີບເວີ ແລະ ການໃຫ້ບໍລິການໄຟລ໌ Static):
```
weblate collectstatic --noinput
```
ຖ້າທ່ານກຳລັງໃຊ້ການຕິດຕັ້ງຈາກ Git, ທ່ານຄວນສ້າງໄຟລ໌ locale ໃໝ່ທຸກຄັ້ງທີ່ອັບເກຣດ. ທ່ານສາມາດເຮັດໄດ້ໂດຍການຮຽກ:
```
weblate compilemessages
```
ກວດສອບວ່າການຕັ້ງຄ່າຂອງທ່ານປົກກະຕິດີ (ເບິ່ງ ການຕັ້ງຄ່າໃນການຜະລິດ (Production) ນຳ):
```
weblate check --deploy
```
ຣີສະຕາດ Celery worker (ເບິ່ງ ວຽກງານເບື້ອງຫຼັງໂດຍໃຊ້ Celery).

ການອັບເກຣດບາງຄັ້ງຈະເຮັດການຕື່ມຂໍ້ມູນ (backfill) ແລະລວມກຸ່ມ Translation-memory ໃນເບື້ອງຫຼັງໂດຍໃຊ້ວຽກງານ Celery ຕາມໄລຍະເວລາ. ໃຫ້ເປີດ Celery ເຮັດວຽກໄວ້ຫຼັງຈາກອັບເກຣດ ແລະຕິດຕາມຄວາມຄືບໜ້າໃນ Administration > Performance report. ເບິ່ງ ຂອບເຂດໜ່ວຍຄວາມຈຳການແປ ສຳລັບລາຍລະອຽດ.

ຄຳແນະນຳສະເພາະເວີຊັນ¶

Changed in version 5.0: ຄຳແນະນຳສະເພາະເວີຊັນໄດ້ຖືກລວມເຂົ້າໃນບັນທຶກການປ່ອຍເວີຊັນແລ້ວ, ເບິ່ງ Weblate 2026.11.

ການອັບເກຣດຈາກເວີຊັນເກົ່າທີ່ບໍ່ຮອງຮັບ¶

ການອັບເກຣດໂດຍກົງຮອງຮັບສະເພາະເວີຊັນຈາກປີປະຕິທິນປັດຈຸບັນ ຫຼືປີກ່ອນໜ້າ. ຖ້າທ່ານຕ້ອງການອັບເກຣດຂ້າມຂອບເຂດນີ້, ໃຫ້ອັບເກຣດໄປຍັງເວີຊັນກາງຕາມລາຍການຂ້າງລຸ່ມນີ້ກ່ອນ. ການອັບເກຣດທີ່ຂ້າມຂັ້ນຕອນນີ້ຈະບໍ່ໄດ້ຮັບການຮອງຮັບ ແລະຈະເຮັດໃຫ້ລະບົບເສຍຫາຍ.

ຖ້າທ່ານກຳລັງອັບເກຣດຈາກເວີຊັນ 2.x, ໃຫ້ອັບເກຣດເປັນ 3.0.1 ກ່ອນສະເໝີ.
ຖ້າທ່ານກຳລັງອັບເກຣດຈາກເວີຊັນ 3.x, ໃຫ້ອັບເກຣດເປັນ 4.0.4 ກ່ອນສະເໝີ.
ຖ້າທ່ານກຳລັງອັບເກຣດຈາກເວີຊັນ 4.x, ໃຫ້ອັບເກຣດເປັນ 5.0.2 ກ່ອນສະເໝີ.
ຖ້າທ່ານກຳລັງອັບເກຣດຈາກເວີຊັນ 5.0.x-5.9.x, ໃຫ້ອັບເກຣດເປັນ 5.10.4 ກ່ອນສະເໝີ.
ການອັບເກຣດຈາກ 5.10.x ແລະໃໝ່ກວ່ານັ້ນສາມາດເຮັດໄດ້ໂດຍກົງ.

ການຍ້າຍຈາກຖານຂໍ້ມູນອື່ນໄປຫາ PostgreSQL¶

Warning

MySQL ແລະ MariaDB ບໍ່ໄດ້ຮັບການຮອງຮັບໃນ Weblate ອີກຕໍ່ໄປ. ທ່ານຕ້ອງຍ້າຍໄປຫາ PostgreSQL ກ່ອນການອັບເກຣດ.

ຖ້າທ່ານກຳລັງໃຊ້ Weblate ກັບ MySQL ຫຼື MariaDB, ໃຫ້ພິຈາລະນາຍ້າຍໄປຫາ PostgreSQL ເພື່ອປະສິດທິພາບທີ່ດີກວ່າໂດຍປະຕິບັດຕາມຂັ້ນຕອນຕໍ່ໄປນີ້. ຈື່ໄວ້ວ່າໃຫ້ຢຸດເຊີເວີເວັບ ແລະ Celery ກ່ອນ, ບໍ່ດັ່ງນັ້ນທ່ານອາດຈະພົບກັບຂໍ້ມູນທີ່ບໍ່ສອດຄ່ອງກັນ.

ການສ້າງຖານຂໍ້ມູນໃນ PostgreSQL¶

ໂດຍປົກກະຕິແລ້ວມັນເປັນຄວາມຄິດທີ່ດີທີ່ຈະໃຊ້ Weblate ໃນຖານຂໍ້ມູນແຍກຕ່າງຫາກ ແລະບັນຊີຜູ້ໃຊ້ແຍກຕ່າງຫາກ:

# 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

ການຍ້າຍໄປ PostgreSQL ໂດຍໃຊ້ pgloader¶

pgloader ແມ່ນເຄື່ອງມືຍ້າຍຂໍ້ມູນທົ່ວໄປສຳລັບຍ້າຍຂໍ້ມູນໄປຫາ PostgreSQL. ທ່ານສາມາດໃຊ້ປ່ຽນຖານຂໍ້ມູນ Weblate ຂອງທ່ານໄດ້.

ປັບ settings.py ຂອງທ່ານໃຫ້ໃຊ້ PostgreSQL ເປັນຖານຂໍ້ມູນ.
ຍ້າຍ schema ໃນຖານຂໍ້ມູນ 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'
;

ການຍ້າຍຈາກ Pootle¶

ເນື່ອງຈາກ Weblate ຖືກຂຽນຂຶ້ນເພື່ອເປັນຕົວແທນຂອງ Pootle, ຈຶ່ງສາມາດຍ້າຍບັນຊີຜູ້ໃຊ້ຈາກມັນໄດ້. ທ່ານສາມາດ dump ຜູ້ໃຊ້ຈາກ Pootle ແລະນຳເຂົ້າພວກມັນໂດຍໃຊ້ importusers.