Weblate a thacú agus a bhogadh¶

Cúltacaí ag leibhéal an tionscadail¶

Added in version 4.14.

Déanann an tionscadal cúltaca de gach ábhar aistriúcháin ó Weblate (tionscadal, comhpháirteanna, aistriúcháin, nótaí tráchta, moltaí nó seiceálacha). Tá sé oiriúnach chun tionscadal a aistriú go dtí sampla Weblate eile.

Is féidir leat cúltaca tionscadail a dhéanamh i Operations ↓ Backups. Is féidir an cúltaca a athchóiriú agus tionscadal á chruthú (féach Tionscadail agus comhpháirteanna aistriúcháin a chur leis).

Níl faisnéis rialaithe rochtana agus stair san áireamh sna cúltacaí faoi láthair.

The comments and suggestions are backed up with the username of the user who did create them. Upon import it is assigned to a matching user. If there is no user with such username, it is assigned to anonymous user.

Coinnítear na cúltacaí ginte ar an bhfreastalaí mar atá cumraithe ar PROJECT_BACKUP_KEEP_DAYS agus PROJECT_BACKUP_KEEP_COUNT (réamhshocraithe sé 3 chúltaca a choinneáil ar feadh 30 lá ar a mhéad).

Import validation of uploaded project backups can be tuned using PROJECT_BACKUP_IMPORT_MAX_MEMBERS, PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE, PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE, PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE, and PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO.

Úsáid an comhad ginte chun an tionscadal a allmhairiú nuair Tionscadail agus comhpháirteanna aistriúcháin a chur leis no i import_projectbackup.

Note

Seans go dteipfeadh ar athshlánú an chúltaca má tá sraith dhifriúil de Sainmhínithe teanga nó cumraíocht dhifriúil de SIMPLIFY_LANGUAGES ag an bhfreastalaí athshlánaithe. Inseoidh an t-athchóiriú duit cé na cóid teanga nach bhféadfaí a phróiseáil agus is féidir leat sainmhínithe teanga atá in easnamh a chur leis de láimh.

Cúltaca uathoibrithe ag baint úsáide as BorgBackup¶

Tá tacaíocht ionsuite ag Weblate chun cúltacaí seirbhíse a chruthú ag baint úsáide as BorgBackup. Cruthaíonn Borg cúltacaí criptithe spás-éifeachtach ar féidir iad a stóráil go sábháilte sa scamall. Is féidir na cúltacaí a rialú sa chomhéadan bainistíochta ón gcluaisín Cúltacaí.

Changed in version 4.4.1: Tá bunachair shonraí PostgreSQL san áireamh sna cúltacaí uathoibrithe.

Tá na cúltacaí a úsáideann Borg incriminteach agus tá Weblate cumraithe chun na cúltacaí seo a leanas a choinneáil:

Cúltacaí laethúla ar feadh 14 lá ar ais
Cúltacaí seachtainiúla ar feadh 8 seachtaine ar ais
Cúltacaí míosúla ar feadh 6 mhí ar ais

Borg eochair criptithe¶

Cruthaíonn BorgBackup cúltacaí criptithe agus ní bheadh tú in ann iad a chur ar ais gan an pasfhrása. Gintear an pasfhrása agus seirbhís chúltaca nua á chur leis agus ba cheart duit é a chóipeáil agus a choinneáil in áit shábháilte.

Má tá tú ag úsáid Stóráil chúltaca soláthraithe Weblate, le do thoil cúltaca d'eochair phríobháideach SSH freisin, mar a úsáidtear í chun rochtain a fháil ar do chúltaca.

See also

borg init

Cúltaca a shaincheapadh¶

Is féidir an chúltaca bunachar sonraí a chumrú trí DATABASE_BACKUP.
Is féidir cruthú an chúltaca a shaincheapadh trí BORG_EXTRA_ARGS a úsáid.

Stóráil chúltaca soláthraithe Weblate¶

Is é an bealach is éasca chun cúltaca a dhéanamh do shampla Weblate ná an tseirbhís cúltaca a cheannach ag weblate.org. Seo mar a gheobhaidh tú é a rith:

Ceannaigh an seirbhís cúltaca ar https://weblate.org/support/#backup.
Cuir isteach an eochair a fuarthas sa chomhéadan bainistíochta, féach Tacaíocht a chomhtháthú.
Nascann Weblate leis an tseirbhís néal agus faigheann sé faisnéis rochtana do na cúltacaí.
Cuir an chumraíocht chúltaca nua ar siúl ón gcluaisín Cúltacaí.
Déan do dhintiúir Borg a chúltaca chun a bheith in ann na cúltacaí a chur ar ais, féach Borg eochair criptithe.

Hint

Tá an chéim láimhe chun gach rud a chur ar siúl ann ar mhaithe le do shábháilteacht. Gan do thoiliú ní sheoltar aon sonraí chuig an stór cúltaca a fhaightear tríd an bpróiseas clárúcháin.

Ag baint úsáide as stóráil cúltaca saincheaptha¶

Is féidir leat do stór féin a úsáid le haghaidh na gcúltacaí freisin. Is féidir SSH a úsáid chun cúltacaí a stóráil sa chiancheann scríbe, ní mór BorgBackup a bheith suiteáilte ar an spriocfhreastalaí.

See also

General i gcáipéisíocht Borg

Córas comhad áitiúil¶

Moltar an cosán iomlán don chúltaca áitiúil a shonrú, mar shampla /path/to/cúltac. Caithfidh an t-úsáideoir a reáchtáil Weblate an t-eolaire a bheith inscríofa (féach Ceadanna córas comhaid). Mura bhfuil sé ann, déanann Weblate iarracht é a chruthú ach teastaíonn na ceadanna cuí uait chun é sin a dhéanamh.

Hint

Agus Weblate á rith in Docker, cinntigh le do thoil go bhfuil an suíomh cúltaca nochta mar imleabhar ón gcoimeádán Weblate. Seachas sin, caithfidh Docker na cúltacaí nuair a atosóidh sé an coimeádán ina bhfuil sé.

Rogha amháin is ea cúltacaí a chur i toirt atá ann cheana, mar shampla /app/data/borgbackup. Is toirt atá ann cheana sa choimeádán é seo.

Is féidir leat coimeádán nua a chur leis freisin do na cúltacaí sa chomhad Docker Compose mar shampla trí /borgbackup a úsáid:

services:
  weblate:
    volumes:
      - /home/weblate/data:/app/data
      - /home/weblate/borgbackup:/borgbackup

The directory where backups will be stored has to be owned by UID 1000, otherwise Weblate won’t be able to write the backups there.

Cúltaca cianda¶

Chun cúltacaí cianda a chruthú, beidh ort BorgBackup a shuiteáil ar fhreastalaí eile atá inrochtana do d'imscaradh Weblate trí SSH ag baint úsáide as an eochair Weblate SSH:

Ullmhaigh freastalaí ina stórálfar do chúltacaí.
Suiteáil an freastalaí SSH air (gheobhaidh tú é de réir réamhshocraithe leis an chuid is mó dáileacháin Linux).
Suiteáil BorgBackup ar an bhfreastalaí sin; tá pacáistí ar fáil ag formhór na ndáiltí Linux (féach Installation).
Roghnaigh úsáideoir atá ann cheana féin nó cruthaigh úsáideoir nua a úsáidfear le haghaidh cúltaca.
Cuir eochair SSH Weblate le comhad .ssh/authorized_keys an úsáideora, ionas gur féidir le Weblate SSH a dhéanamh chuig an bhfreastalaí gan focal faire (féach Eochracha gréasáin SSH).
Cruthaigh eolaire inscríofa ag an úsáideoir inar féidir le Weblate stór cúltaca Borg a shocrú go cianda, mar shampla san eolaire baile (i.e. /home/borg/backups).
Cumraigh an suíomh cúltaca i Weblate mar user@host:/home/borg/backups nó ssh://user@host:port/home/borg/backups.
Once enabled, the backups will be triggered automatically daily. You can also manually trigger a backup from the Weblate UI or using backup.

Hint

Soláthraíonn Stóráil chúltaca soláthraithe Weblate cúltacaí iargúlta uathoibrithe duit gan aon iarracht.

See also

Athchóiriú ó BorgBackup¶

Athchóirigh rochtain ar do stór cúltaca agus ullmhaigh do phasfhrása cúltaca.
Déan liosta de na cúltacaí ar fad ar an bhfreastalaí ag baint úsáide as liosta borg ATHCHÓIRIÚ.
Athchóirigh an cúltaca atá uait chuig an eolaire reatha ag baint úsáide as borg extract REPOSITORY::ARCHIVE.
Athchóirigh an bunachar sonraí ón dumpáil SQL atá curtha san eolaire backup sa treoir sonraí Weblate (féach Sonraí dumpáilte le haghaidh cúltacaí).
Cóipeáil cumraíocht Weblate (backups/settings.py, féach Sonraí dumpáilte le haghaidh cúltacaí) go dtí an suíomh ceart, féach Cumraíocht a choigeartú.

Agus coimeádán Docker á úsáid agat, tá an comhad socruithe san áireamh sa choimeádán cheana féin agus ba cheart duit na hathróga comhshaoil bunaidh a ath D'fhéadfadh an comhad environment.yml cabhrú leat leis seo (féach Sonraí dumpáilte le haghaidh cúltacaí).
Cóipeáil na dir sonraí athchóirithe iomlána go dtí an suíomh atá cumraithe ag DATA_DIR.

Nuair a bhíonn coimeádán Docker in úsáid cuir na sonraí isteach sa toirt sonraí, féach Toirteanna coimeádán docker.

Cinntigh le do thoil go bhfuil úinéireacht agus ceadanna cearta ag na comhaid, féach Ceadanna córas comhaid.

Seans go mbeidh cuma mar seo ar sheisiún Borg:

$ borg list /tmp/xxx
Enter passphrase for key /tmp/xxx:
2019-09-26T14:56:08 Thu, 2019-09-26 14:56:08 [de0e0f13643635d5090e9896bdaceb92a023050749ad3f3350e788f1a65576a5]
$ borg extract /tmp/xxx::2019-09-26T14:56:08
Enter passphrase for key /tmp/xxx:

See also

Ag athchóiriú socruithe bunaithe ar Docker¶

Glactar leis sna céimeanna seo a leanas go bhfuil Docker Compose socraithe go hoifigiúil ag baint úsáide as na seirbhísí PostgreSQL agus Valkey atá sa phacáiste, féach Suiteáil ag baint úsáide as Docker. Má úsáideann d’imscaradh bunachar sonraí seachtrach nó comhad Compose saincheaptha, déan na céimeanna bunachar sonraí agus toirte a oiriúnú don timpeallacht sin.

Tosaigh le seiceáil amach Docker Compose a mheaitseálann an imscaradh athchóirithe. Athchóirigh do sháruithe, rúin agus athróga comhshaoil Compose bunaidh. Is féidir leis an gcomhad environment.yml ó Sonraí dumpáilte le haghaidh cúltacaí cabhrú leis seo, ach ní dhéantar é a allmhairiú go huathoibríoch.

Athchóirigh an cartlann chúltaca ag baint úsáide as Athchóiriú ó BorgBackup nó díphacáil do chúltaca láimhe ionas go mbeidh eolaire sonraí Weblate agus backups/database.sql ar fáil.
Stop na seirbhísí ar féidir leo scríobh chuig an mbunachar sonraí nó chuig an toirt sonraí:
```
docker compose stop weblate cache
```
Athchruthaigh an toirt PostgreSQL.
```
docker compose stop database
docker compose rm -v database
docker volume remove weblate-docker_postgres-data
```
Braitheann ainm an imleabhair ar ainm tionscadail Compose agus féadfaidh sé a bheith difriúil ó weblate-docker_postgres-data. Seiceáil do shocrú sula mbaintear aon imleabhair.
Tosaigh an tseirbhís bunachar sonraí:
```
docker compose up -d database
```
Athchóirigh an dumpáil bunachar sonraí:
```
cat backups/database.sql | docker compose exec -T database psql --username weblate --dbname weblate
```
Seiceáil go bhfuil ainm an bhunachair shonraí ag teacht le POSTGRES_DB agus go bhfuil an t-úsáideoir ag teacht le POSTGRES_USER i do chumraíocht Compose.
Athchóirigh eolaire sonraí Weblate chuig an toirt sonraí Docker atá feistithe mar /app/data, féach Toirteanna coimeádán docker. Caithfidh comhaid san toirt seo a bheith faoi úinéireacht UID 1000, féach Ceadanna córas comhaid.
Tosaigh na seirbhísí atá fágtha agus lean na logaí:
```
docker compose up -d
docker compose logs -f
```
Déanann coimeádán Weblate imirce bunachar sonraí ar thosú. Má tá tú ag uasghrádú Weblate freisin, lean An coimeádán Docker a uasghrádú.

Athnuaigh na stórtha tar éis an athchóirithe:

docker compose exec --user weblate weblate weblate updategit --all

See also

Cúltaca láimhe¶

Ag brath ar cad ba mhaith leat a shábháil, cúltaca an cineál sonraí a stórálann Weblate i ngach áit faoi seach.

Hint

Má tá na cúltacaí láimhe á dhéanamh agat, b'fhéidir gur mhaith leat rabhadh Weblate a chur faoi easpa cúltacaí trí weblate.I028 a chur chuig: SILENCED_SYSTEM_CHECKS in settings.py nó WEBLATE_SILENCED_SYSTEM_CHECKS do Docker.

SILENCED_SYSTEM_CHECKS.append("weblate.I028")

Bunachar Sonraí¶

Braitheann an suíomh stórála iarbhír ar do shocrú bunachar sonraí.

Hint

Is é an bunachar sonraí an stóráil is tábhachtaí. Socraigh cúltacaí rialta de do bhunachar sonraí. Gan an bunachar sonraí, tá na haistriúcháin ar fad imithe.

Cúltaca bunachar sonraí dúchais¶

Is é an cur chuige molta ná dump den bhunachar sonraí a shábháil ag baint úsáide as uirlisí dúchasacha bunachar sonraí ar nós pg_dump. De ghnáth, feidhmíonn sé níos fearr ná cúltaca Django, agus athchóiríonn sé táblaí iomlána leis na sonraí go léir.

Is féidir leat an cúltaca seo a chur ar ais i scaoileadh Weblate níos nuaí, déanfaidh sé na himirce riachtanacha go léir agus é ag rith isteach migrate. Téigh i gcomhai Weblate a uasghrádú maidir le faisnéis níos mionsonraithe maidir le conas uasghrádú idir leaganacha.

Django cúltaca bunachar sonraí¶

Mar mhalairt air sin, is féidir leat do bhunachar sonraí a chúltaca le hordú dumpdata Django. Ar an mbealach sin is cúltaca agnostic bunachar sonraí é agus is féidir é a úsáid ar eagla go dteastaíonn uait inneall an bhunachair shonraí a athrú.

Sula ndéanfaidh tú an bunachar sonraí a athchóiriú ní mór duit a bheith ag rith go díreach mar an leagan Weblate céanna a ndearnadh an cúltaca air. Tá sé seo riachtanach mar go n-athraíonn struchtúr an bhunachair sonraí idir eisiúintí agus dhéanfá truaillithe ar na sonraí ar bhealach éigin. Tar éis duit an leagan céanna a shuiteáil, reáchtáil gach ascnamh bunachar sonraí ag baint úsáide as migrate.

Ina dhiaidh sin cruthófar roinnt iontrálacha sa bhunachar sonraí cheana féin agus beidh siad sa bhunachar cúltaca freisin. Is é an cur chuige a mholtar iontrálacha den sórt sin a scriosadh de láimh ag baint úsáide as an bhlaosc bainistíochta (féach Orduithe bainistíochta a agairt):

weblate shell
>>> from weblate.auth.models import User
>>> User.objects.get(username='anonymous').delete()

Comhaid¶

Má tá go leor spáis cúltaca agat, níl le déanamh ach cúltaca a dhéanamh den leagan iomlán DATA_DIR. Is geall sábháilte é seo fiú má chuimsíonn sé roinnt comhad nach dteastaíonn uait. Déanann na hailt seo a leanas cur síos ar cad ba cheart duit cúltaca a dhéanamh agus cad is féidir leat a shárú go mion.

Sonraí dumpáilte le haghaidh cúltacaí¶

Changed in version 4.7: Cuireadh an dump comhshaoil mar environment.yml chun cabhrú le hathchóiriú i dtimpeallachtaí Docker.

Stóráilte in DATA_DIR /backups.

Tugann Weblate sonraí éagsúla anseo, agus is féidir leat na comhaid seo a áireamh le haghaidh cúltacaí níos iomláine. Déantar na comhaid a nuashonrú go laethúil (teastaíonn freastalaí seilire beats ag rith, féach Tascanna cúlra ag baint úsáide as Soilire). Faoi láthair, áirítear leis seo:

Socruithe Weblate cosúil settings.py (tá leagan leathnaithe ann freisin in settings-expanded.py).
Cúltaca bunachar sonraí PostgreSQL mar database.sql.
Dumpáil comhshaoil mar environment.yml.

Déantar cúltacaí an bhunachair shonraí a shábháil mar ghnáth-théacs de réir réamhshocraithe, ach is féidir iad a chomhbhrú nó a scipeáil go hiomlán trí úsáid a bhaint as DATABASE_BACKUP.

Chun cúltaca an bhunachair shonraí a athbhunú, lódáil le huirlisí bunachar sonraí é, mar shampla:

psql --file=database.sql weblate

Stórálacha rialaithe leagan¶

Stóráilte i DATA_DIR /vcs.

Tá cóip de do stórtha réamhtheachtacha le hathruithe Weblate sna stórtha rialaithe leagan. Má tá Brúigh ar thiomantas cumasaithe le do chuid comhpháirteanna aistriúcháin go léir, cuirfear gach athrú Weblate san áireamh in aghaidh an tsrutha. Ní gá cúltaca a dhéanamh de na stórtha ar thaobh Weblate mar is féidir iad a chlónáil arís ón suíomh in aghaidh an tsrutha gan aon chaillteanas sonraí.

Eochracha SSH agus GPG¶

Stóráilte i DATA_DIR /ssh agus DATA_DIR /home.

Má tá tú ag úsáid eochracha SSH nó GPG ginte ag Weblate, ba chóir duit cúltaca a dhéanamh de na suíomhanna seo. Seachas sin caillfidh tú na heochracha príobháideacha agus beidh ort cinn nua a athghiniúint.

Stóráiltear scripteanna fillteáin SSH a ghintear i CACHE_DIR agus ní gá iad a chúltaca.

Comhaid uaslódáilte ag úsáideoirí¶

Stóráilte i DATA_DIR /media.

Ba cheart duit cúltaca a dhéanamh de gach comhad a d’uaslódáil an t-úsáideoir (m.sh. Scáileáin agus comhthéacs amhairc).

Tascanna soilire¶

D’fhéadfadh go mbeadh roinnt faisnéise sa scuaine tascanna Soilire, ach de ghnáth ní bhíonn gá léi le haghaidh cúltaca. Ar a mhéad caillfidh tú nuashonruithe nach bhfuil próiseáilte fós go cuimhne aistriúcháin. Moltar an téacs iomlán nó nuashonrú stórtha a dhéanamh ar athchóiriú ar aon nós, mar sin níl aon fhadhb ann iad seo a chailliúint.

Líne ordaithe le haghaidh cúltaca láimhe¶

Ag baint úsáide as post cron, is féidir leat ordú Bash a chur ar bun le forghníomhú ar bhonn laethúil, mar shampla:

$ tar -Jcf ~/backup/weblate-backup-$(date -u +%Y-%m-%d_%H%M%S).xz backups vcs ssh home media fonts secret

Is féidir leat liosta na bhfillteán agus na gcomhad a choigeartú de réir do chuid riachtanas. Chun an chuimhne aistriúcháin a sheachaint (i bhfillteán cúltacaí), is féidir leat úsáid a bhaint as:

$ tar -Jcf ~/backup/weblate-backup-$(date -u +%Y-%m-%d_%H%M%S).xz backups/database.sql backups/settings.py vcs ssh home media fonts secret

Cúltaca láimhe a athbhunú¶

Athchóirigh na sonraí go léir atá cúltacaithe agat.
Nuashonraigh gach stór ag baint úsáide as updategit.
```
weblate updategit --all
```

Suiteáil Weblate a bhogadh¶

Athlonnú do shuiteáil chuig córas eile trí na treoracha cúltaca agus athchóirithe thuas a leanúint.

See also