Suiteáil ag baint úsáide as Docker¶
Le himscaradh Weblate dockerized is féidir leat do shampla Weblate pearsanta a chur ar bun agus a reáchtáil i soicindí. Tá gach spleáchas ar Weblate san áireamh cheana féin. Tá PostgreSQL ar bun mar bhunachar sonraí réamhshocraithe agus Redis mar inneall taisce.
Riachtanais crua-earraí¶
Ba cheart go n-oibreodh Weblate ar aon chrua-earraí comhaimseartha gan fadhbanna, seo a leanas an chumraíocht íosta a theastaíonn chun Weblate a rith ar óstach amháin (Weblate, bunachar sonraí agus freastalaí gréasáin):
3 GB RAM
2 chroílár LAP
1 GB de spás stórála
Note
Bíonn éagsúlacht mhór ag baint le riachtanais iarbhír do shuiteáil Weblate bunaithe ar mhéid na n-aistriúchán a bhainistítear ann.
Úsáid cuimhne¶
An níos mó cuimhne is amhlaidh is fearr - úsáidtear é le haghaidh taisceadh ar gach leibhéal (córas comhaid, bunachar sonraí agus Weblate). Maidir leis na céadta comhpháirteanna aistriúcháin, moltar 4 GB RAM ar a laghad.
Hint
Maidir le córais a bhfuil níos lú cuimhne acu ná mar a mholtar, moltar Socrú Soilire aonphróisis.
Úsáid LAP¶
Méadaíonn go leor úsáideoirí comhthráthacha an méid croíleacáin LAP atá ag teastáil.
Úsáid stórála¶
Is é an gnáthúsáid stórála bunachar sonraí ná thart ar 300 MB in aghaidh an 1 milliún focal óstaithe.
Ní hionann an spás stórála a theastaíonn le haghaidh stórtha clónáilte, ach déanann Weblate iarracht a méid a choinneáil íosta trí chlóin éadomhain a dhéanamh.
Nóid¶
Maidir le suíomhanna beaga agus meánmhéide (na milliúin focal óstáilte), is féidir gach comhpháirteanna Weblate (féach Forbhreathnú ar ailtireacht) a reáchtáil ar nód amháin.
Nuair a fhásann tú go dtí na céadta milliún focal óstaithe, moltar nód tiomnaithe a bheith agat don bhunachar sonraí (féach Socrú bunachar sonraí le haghaidh Weblate).
Suiteáil¶
Hint
Glactar leis sna samplaí seo a leanas go bhfuil timpeallacht oibre Ducker agat, le docker-compose-plugin suiteáilte. Seiceáil le do thoil doiciméadú an Docker le haghaidh treoracha.
Cruthaíonn sé seo freastalaí imscaradh Weblate trí HTTP, mar sin ba chóir duit é a chur taobh thiar de seachfhreastalaí foirceanta HTTPS. Is féidir leat imscaradh freisin le seachfhreastalaí HTTPS, féach Deimhnithe SSL uathoibríoch ag baint úsáide as Let's Encrypt. Le haghaidh socruithe níos mó, féach le do thoil Scálú go cothrománach.
Clón an repo weblate-docker:
git clone https://github.com/WeblateOrg/docker-compose.git weblate-docker cd weblate-docker
Cruthaigh a:file: comhad
docker-compose.override.ymlle do shocruithe. Féach Athróga timpeallachta docker le haghaidh liosta iomlán d'athróga comhshaoil.version: '3' services: weblate: ports: - 80:8080 environment: WEBLATE_EMAIL_HOST: smtp.example.com WEBLATE_EMAIL_HOST_USER: user WEBLATE_EMAIL_HOST_PASSWORD: pass WEBLATE_SERVER_EMAIL: weblate@example.com WEBLATE_DEFAULT_FROM_EMAIL: weblate@example.com WEBLATE_SITE_DOMAIN: weblate.example.com WEBLATE_ADMIN_PASSWORD: password for the admin user WEBLATE_ADMIN_EMAIL: weblate.admin@example.com
Note
Mura bhfuil
WEBLATE_ADMIN_PASSWORDsocraithe, cruthaítear an t-úsáideoir riaracháin le pasfhocal randamach a thaispeántar ar an gcéad tosaithe.Déanann an sampla a chuirtear ar fáil éisteacht le Weblate ar chalafort 80, déanann mapáil an chalafoirt a chur in eagar sa chomhad
docker-compose.override.ymlchun é a athrú.Tosaigh coimeádáin Ghréasáin:
docker compose up
Bain sult as d'imscaradh Weblate, tá sé inrochtana ar phort 80 den choimeádán weblate.
See also
Roghnú clárlann íomhá Docker¶
Foilsítear coimeádáin ghréasán chuig na clárlanna seo a leanas:
Docker Hub, féach https://hub.docker.com/r/weblate/weblate
Clárlann Pacáistí GitHub, féach https://github.com/WeblateOrg/docker/pkgs/container/weblate
Note
Gabhann gach sampla íomhánna ó Docker Hub faoi láthair, le do thoil coigeartaigh an chumraíocht dá réir chun clárlann eile a úsáid.
Ag roghnú chlib íomhá Docker¶
Roghnaigh clib a mheaitseálann do thimpeallacht agus d’ionchais:
Ainm chlib |
Cur síos |
Bain úsáid as cás |
|---|---|---|
|
An scaoileadh cobhsaí Weblate, meaitseálann an scaoileadh clibeáilte is déanaí |
Nuashonruithe rollta i dtimpeallacht táirgthe |
|
Scaoileadh cobhsaí Weblate |
Nuashonruithe rollta laistigh de leagan mór i dtimpeallacht táirgthe |
|
Scaoileadh cobhsaí Weblate |
Nuashonruithe rollta laistigh de leagan mion i dtimpeallacht táirgthe |
|
Scaoileadh cobhsaí Weblate |
Imscaradh dea-shainithe i dtimpeallacht táirgthe |
|
Scaoileadh cobhsaí Weblate le hathruithe forbartha sa choimeádán Docker (mar shampla spleáchais nuashonraithe) |
Nuashonruithe rollta i dtimpeallacht stáitse |
|
Scaoileadh cobhsaí Weblate le hathruithe forbartha sa choimeádán Docker (mar shampla spleáchais nuashonraithe) |
Imscaradh dea-shainithe i dtimpeallacht stáitse |
|
Leagan forbartha Weblate ó Git |
Nuashonruithe rollta chun gnéithe Weblate atá le teacht a thástáil |
|
Leagan forbartha Weblate ó Git |
Imscaradh dea-shainithe chun gnéithe Weblate atá le teacht a thástáil |
Déanann ár CI gach íomhá a thástáil sula bhfoilsítear í, mar sin ba cheart go mbeadh an leagan bleeding sách sábháilte le húsáid.
Is féidir liosta iomlán de na clibeanna foilsithe a fháil ag Pacáistí GitHub
Coimeádán docker le tacaíocht HTTPS¶
Féach Suiteáil le haghaidh treoracha úsáide cineálacha, ní luann an chuid seo ach na difríochtaí i gcomparáid leis.
Ag baint úsáide as deimhnithe SSL féin¶
Sa chás go bhfuil deimhniú SSL féin agat is mian leat a úsáid, ní gá ach na comhaid a chur isteach i toirt sonraí Weblate (féach Toirteanna coimeádán docker):
ssl/fullchain.pemina bhfuil an teastas lena n-áirítear aon deimhnithe CA atá ag teastáilssl/privkey.pemina bhfuil an eochair phríobháideach
Caithfidh an dá chomhad seo a bheith ina n-úinéirí ag an úsáideoir céanna leis an gceann a thosaíonn an coimeádán docker agus masc comhaid a bheith socraithe go 600 (inléite agus inscríofa ag an úsáideoir úinéireacht amháin).
Ina theannta sin, glacfaidh coimeádán Weblate le naisc SSL ar phort 4443, beidh tú ag iarraidh cur ar aghaidh an chalafoirt le haghaidh HTTPS a chur san áireamh i sárú cumadóireachta docker:
version: '3'
services:
weblate:
ports:
- 80:8080
- 443:4443
Má tá tú ag óstáil suíomhanna eile ar an bhfreastalaí céanna cheana féin, is dócha go n-úsáideann seachfhreastalaí droim ar ais, mar shampla NGINX, poirt 80` agus 443`. Chun an nasc HTTPS a chur ar aghaidh ó NGINX chuig an gcoimeádán docker, is féidir leat an chumraíocht seo a leanas a úsáid:
server {
listen 443 ssl;
listen [::]:443 ssl;
server_name <SITE_URL>;
ssl_certificate /etc/letsencrypt/live/<SITE>/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/<SITE>/privkey.pem;
location / {
proxy_set_header HOST $host;
proxy_set_header X-Forwarded-Proto https;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Host $server_name;
proxy_pass https://127.0.0.1:<EXPOSED_DOCKER_PORT>;
}
}
Cuir luachanna iarbhír ó do thimpeallacht in ionad `` <SITE_URL>``, `` <SITE>`` agus `` <EXPOSED_DOCKER_PORT>``.
Deimhnithe SSL uathoibríoch ag baint úsáide as Let's Encrypt¶
Ar eagla go dteastaíonn uait Let's Encrypt deimhnithe SSL a ghintear go huathoibríoch ar shuiteáil phoiblí a úsáid, ní mór duit seachfhreastalaí HTTPS droim ar ais a chur le coimeádán Docker breise, úsáidfear https-portal chuige sin. Baintear úsáid as seo sa chomhad docker-compose-https.yml. Ansin cruthaigh comhad docker-compose-https.override.yml le do shocruithe:
version: '3'
services:
weblate:
environment:
WEBLATE_EMAIL_HOST: smtp.example.com
WEBLATE_EMAIL_HOST_USER: user
WEBLATE_EMAIL_HOST_PASSWORD: pass
WEBLATE_SITE_DOMAIN: weblate.example.com
WEBLATE_ADMIN_PASSWORD: password for admin user
https-portal:
environment:
DOMAINS: 'weblate.example.com -> http://weblate:8080'
Nuair a dhéanann tú agairt ar docker compose ní mór duit an dá chomhad a chur ar aghaidh chuige, agus ansin déan:
docker compose -f docker-compose-https.yml -f docker-compose-https.override.yml build
docker compose -f docker-compose-https.yml -f docker-compose-https.override.yml up
An coimeádán Docker a uasghrádú¶
De ghnáth is smaoineamh maith é an coimeádán Weblate a nuashonrú agus an coimeádán PostgreSQL a choinneáil ag an leagan atá agat, toisc go bhfuil uasghrádú PostgreSQL pianmhar go leor agus i bhformhór na gcásanna ní thugann sé go leor buntáistí.
Changed in version 4.17-1: Ós rud é Weblate 4.17-1, úsáideann an coimeádán Docker Django 4.2 rud a éilíonn PostgreSQL 12 nó níos nuaí, le do thoil uasghrádú é roimh uasghrádú Weblate. Féach Coimeádán PostgreSQL a uasghrádú.
Is féidir leat é seo a dhéanamh trí cloí leis an docker-compose atá ann cheana féin agus gan ach na híomhánna is déanaí a tharraingt agus ansin atosú:
# Fetch latest versions of the images
docker compose pull
# Stop and destroy the containers
docker compose down
# Spawn new containers in the background
docker compose up -d
# Follow the logs during upgrade
docker compose logs -f
Ba cheart bunachar sonraí Weblate a aistriú go huathoibríoch ar an gcéad tosaithe, agus níor cheart go mbeadh gá le gníomhartha láimhe breise.
Note
Ní thacaíonn Weblate le huasghráduithe thar mórleaganacha. Mar shampla, má tá tú ar shraith 3.x agus gur mhaith leat a uasghrádú go 4.x, uasghrádú ar dtús chuig an íomhá 4.0.x-y is déanaí (agus é seo á scríobh is é an `` 4.0.4-5``), a a dhéanamh ar an aistriú agus ansin leanúint ar aghaidh ag uasghrádú go leaganacha níos nuaí.
B'fhéidir gur mhaith leat an stór docker-compose a nuashonrú freisin, cé nach bhfuil sé ag teastáil i bhformhór na gcásanna. Féach Coimeádán PostgreSQL a uasghrádú chun an freastalaí PostgreSQL a uasghrádú.
Coimeádán PostgreSQL a uasghrádú¶
Ní thacaíonn coimeádáin PostgreSQL le huasghrádú uathoibríoch idir leagan, ní mór duit an t-uasghrádú a dhéanamh de láimh. Léiríonn na céimeanna seo a leanas ceann de na roghanna uasghrádaithe.
Stop coimeádán Weblate:
docker compose stop weblate cache
Cúltaca an bunachar sonraí:
docker compose exec database pg_dumpall --clean --if-exists --username weblate > backup.sql
Stop an coimeádán bunachar sonraí:
docker compose stop database
Bain an t-imleabhar PostgreSQL:
docker compose rm -v database docker volume remove weblate-docker_postgres-data
Hint
Tá ainm an tionscadail Docker Compose in ainm an imleabhair, is é sin an t-ainm eolaire de réir réamhshocraithe cad is
weblate-dockersa doiciméadú seo.Coigeartaigh
docker-compose.ymlchun leagan nua PostgreSQL a úsáid.Tosaigh coimeádán an bhunachair shonraí:
docker compose up -d database
Athchóirigh an bunachar sonraí ón gcúltaca:
cat backup.sql | docker compose exec -T database psql --username weblate --dbname weblate
Hint
Cinntigh go dtagann ainm an bhunachair shonraí le
POSTGRES_DB.(Roghnach) Nuashonraigh pasfhocal don úsáideoir Weblate. Seans go mbeidh sé seo ag teastáil nuair a athraítear aistriú go PostgreSQL 14 nó 15 mar bhealach chun pasfhocail a stóráil:
docker compose exec -T database psql --username weblate --dbname weblate -c "ALTER USER weblate WITH PASSWORD 'weblate'"
Hint
Cinntigh go dtagann ainm an bhunachair shonraí le
POSTGRES_DB.Tosaigh gach coimeádán atá fágtha:
docker compose up -d
Sínigh isteach admin¶
Tar éis duit an coimeádán a shocrú, is féidir leat síniú isteach mar úsáideoir admin le pasfhocal curtha ar fáil in WEBLATE_ADMIN_PASSWORD, nó pasfhocal randamach a ghintear ar an gcéad tosú mura bhfuil sé sin socraithe.
Chun pasfhocal admin a athshocrú, atosaigh an coimeádán le WEBLATE_ADMIN_PASSWORD socraithe go pasfhocal nua.
Líon na bpróiseas agus tomhaltas cuimhne¶
Cinntear go huathoibríoch líon na bpróiseas oibrithe don WSGI agus don Soilire araon bunaithe ar líon na LAPanna. Oibríonn sé seo go maith don chuid is mó de mheaisíní fíorúla scamall mar go hiondúil is beag LAPanna a bhíonn acu agus méid maith cuimhne.
Sa chás go bhfuil go leor croíleacáin LAP agat agus go bhfuil fadhbanna cuimhne agat, déan iarracht líon na n-oibrithe a laghdú:
environment:
WEBLATE_WORKERS: 2
Is féidir leat catagóirí oibrithe aonair a mhionchoigeartú freisin:
environment:
WEB_WORKERS: 4
CELERY_MAIN_OPTIONS: --concurrency 2
CELERY_NOTIFY_OPTIONS: --concurrency 1
CELERY_TRANSLATE_OPTIONS: --concurrency 1
Is féidir úsáid na cuimhne a laghdú tuilleadh trí phróiseas Soilire amháin a rith:
environment:
CELERY_SINGLE_PROCESS: 1
Scálú go cothrománach¶
Added in version 4.6.
Is féidir leat iolracha coimeádáin Weblate a reáchtáil chun an tseirbhís a scáileáil Caithfidh gach coimeádán an toirte:file: /app/data a roinnt, moltar córas comhaid braisle mar GlusterFS a úsáid chuige seo. Ba chóir go mbeadh an toirte /app/cache ar leithligh do gach coimeádán.
Tá ról sainithe ag gach coimeádán Weblate ag baint úsáide as WEBLATE_SERVICE athróg timpeallachta. Lean go cúramach leis an gcáipéisíocht le do thoil mar ba chóir go mbeadh cuid de na seirbhísí ar siúl uair amháin sa chnuasach, agus tá tábhacht le hord na seirbhísí freisin.
Is féidir leat socrú samplaí a fháil sa docker-compose repo mar docker-compose-split.yml.
Athróga timpeallachta docker¶
Is féidir go leor de Cumraíocht Weblate a shocrú sa choimeádán Docker trí úsáid a bhaint as na hathróga timpeallachta a gcuirtear síos orthu thíos.
Más gá duit socrú a shainiú nach bhfuil nochta trí athróga timpeallachta Docker, féach Cumraíocht thar athróga timpeallachta.
Rúin a rith¶
Added in version 5.0.
Tacaíonn coimeádán gréasáinchléite le rúin a rith mar chomhaid. Chun é sin a úsáid, cuir iarmhír `` _FILE`` leis an athróg timpeallachta agus pas an comhad rúnda trí Docker.
Seans go mbeidh cuma ar docker-compose.yml gaolmhar:
services:
weblate:
environment:
POSTGRES_PASSWORD_FILE: /run/secrets/db_password
secrets:
- db_password
database:
environment:
POSTGRES_PASSWORD_FILE: /run/secrets/db_password
secrets:
- db_password
secrets:
db_password:
file: db_password.txt
See also
Socruithe cineálacha¶
- WEBLATE_DEBUG¶
Cumraíonn sé mód dífhabhtaithe Django ag baint úsáide as
DEBUG.Sampla:
environment: WEBLATE_DEBUG: 1
See also
- WEBLATE_LOGLEVEL¶
Cumraíonn sé briathrachas na logála. Socraigh é seo go
DEBUGchun logaí níos mionsonraithe a fháil.Réamhshocruithe le
INFOnuair a mhúchtarWEBLATE_DEBUG, úsáidtearDEBUGnuair a chuirtear mód dífhabhtaithe ar siúl.Le haghaidh logáil níos ciúine, úsáid
ERRORnó `` RABHADH``.
- WEBLATE_LOGLEVEL_DATABASE¶
Cumraíonn sé logáil na bhfiosruithe bunachar sonraí ar bhriathrachas.
- WEBLATE_LOG_GELF_HOST¶
Added in version 5.9.
Cumraíonn sé cianlogáil trí nasc GELF TCP a úsáid. Is féidir é a úsáid chun comhtháthú le Graylog.
- WEBLATE_LOG_GELF_PORT¶
Added in version 5.9.
Úsáid port saincheaptha le haghaidh
WEBLATE_LOG_GELF_HOST, réamhshocraithe go 12201.
- WEBLATE_SITE_TITLE¶
Athraítear teideal an tsuímh a thaispeántar i gceanntásc gach leathanaigh.
- WEBLATE_SITE_DOMAIN¶
Cumraíonn sé fearann an tsuímh. Tá an paraiméadar seo ag teastáil.
Cuir port san áireamh má tá ceann neamhchaighdeánach á úsáid agat.
Sampla:
environment: WEBLATE_SITE_DOMAIN: example.com:8080
See also
- WEBLATE_ADMIN_NAME¶
- WEBLATE_ADMIN_EMAIL¶
Cumraíonn sé ainm agus r-phost riaracháin an láithreáin. Úsáidtear é chun an bheirt
ADMINSagus úsáideoir admin a chruthú (féachWEBLATE_ADMIN_PASSWORDle haghaidh tuilleadh eolais faoi sin).Sampla:
environment: WEBLATE_ADMIN_NAME: Weblate admin WEBLATE_ADMIN_EMAIL: noreply@example.com
- WEBLATE_ADMIN_PASSWORD¶
Socraíonn sé an pasfhocal don úsáideoir admin.
Mura bhfuil sé socraithe agus níl an t-úsáideoir admin ann, cruthaítear é le pasfhocal randamach a thaispeántar ar an gcéad tosaithe coimeádán.
Mura bhfuil sé socraithe agus má tá úsáideoir admin ann, ní dhéanfar aon ghníomh.
Má tá an t-úsáideoir admin coigeartaithe ar gach tosaithe coimeádán chun
WEBLATE_ADMIN_PASSWORD,WEBLATE_ADMIN_NAMEagusWEBLATE_ADMIN_EMAILa mheaitseáil.
Warning
D'fhéadfadh sé a bheith ina riosca slándála pasfhocal a stóráil sa chomhad cumraíochta. Smaoinigh ar an athróg seo a úsáid le haghaidh socrú tosaigh amháin (nó lig do Weblate pasfhocal randamach a ghiniúint ar an am tosaithe tosaigh) nó chun pasfhocal a ghnóthú.
- WEBLATE_ADMIN_NOTIFY_ERROR¶
Cibé ar cheart ríomhphost a sheoladh chuig riarthóirí ar earráid fhreastalaí. Curtha ar siúl de réir réamhshocraithe.
Seans gur mhaith leat úsáid a bhaint as bailiúchán earráidí eile ar nós Sentry nó Barra Rolla agus é seo a mhúchadh.
See also
- WEBLATE_SERVER_EMAIL¶
An seoladh ríomhphoist óna seoltar teachtaireachtaí earráide.
See also
- WEBLATE_DEFAULT_FROM_EMAIL¶
Cumraíonn sé an seoladh le haghaidh ríomhphoist amach.
See also
- WEBLATE_ADMINS_CONTACT¶
Cumraíonn
ADMINS_CONTACT.
- WEBLATE_CONTACT_FORM¶
Cumraíonn sé iompraíocht na foirme teagmhála, féach
CONTACT_FORM.
- WEBLATE_ALLOWED_HOSTS¶
Cumraíonn óstainmneacha HTTP ceadaithe ag baint úsáide as
ALLOWED_HOSTS.Réamhshocraithe go
*a cheadaíonn gach ainm óstach.Sampla:
environment: WEBLATE_ALLOWED_HOSTS: weblate.example.com,example.com
- WEBLATE_REGISTRATION_OPEN¶
Cumraigh cé acu an bhfuil clárúcháin oscailte trí scoránú
REGISTRATION_OPEN.Sampla:
environment: WEBLATE_REGISTRATION_OPEN: 0
- WEBLATE_REGISTRATION_CAPTCHA¶
Added in version 5.10.
Cumraigh cé acu an n-úsáidtear captcha le haghaidh clárúcháin agus gníomhartha neamhfhíordheimhnithe eile, féach
REGISTRATION_CAPTCHA.Sampla:
environment: WEBLATE_REGISTRATION_CAPTCHA: 0
- WEBLATE_REGISTRATION_ALLOW_BACKENDS¶
Cumraigh cé na modhanna fíordheimhnithe is féidir a úsáid chun cuntas nua a chruthú trí
REGISTRATION_ALLOW_BACKENDS.Sampla:
environment: WEBLATE_REGISTRATION_OPEN: 0 WEBLATE_REGISTRATION_ALLOW_BACKENDS: azuread-oauth2,azuread-tenant-oauth2
- WEBLATE_REGISTRATION_REBIND¶
Added in version 4.16.
Cumraíonn
REGISTRATION_REBIND.
- WEBLATE_TIME_ZONE¶
Cumraíonn sé an crios ama in úsáid i Weblate, féach
TIME_ZONE.Note
Chun crios ama an choimeádáin Docker féin a athrú, úsáid an athróg timpeallachta
TZ.Sampla:
environment: WEBLATE_TIME_ZONE: Europe/Prague
- WEBLATE_ENABLE_HTTPS¶
Glacann Weblate leis go n-oibrítear é taobh thiar de sheachvótálaí HTTPS droim ar ais, úsáideann Weblate HTTPS i ríomhphoist agus naisc API nó socraíonn sé bratacha slána ar fhianáin.
Hint
Féach le do thoil
ENABLE_HTTPSdoiciméadú le haghaidh caveats féideartha.Note
Ní fhágann sé seo go nglacann coimeádán Weblate le naisc HTTPS, ní mór duit é sin a chumrú freisin, féach Coimeádán docker le tacaíocht HTTPS le haghaidh samplaí.
Sampla:
environment: WEBLATE_ENABLE_HTTPS: 1
- WEBLATE_INTERLEDGER_PAYMENT_BUILTIN¶
Added in version 5.11.
Configures
INTERLEDGER_PAYMENT_BUILTIN.
- WEBLATE_INTERLEDGER_PAYMENT_POINTERS¶
Added in version 4.12.1.
Socraíonn Let Weblate an réimse meta[name=monetization] i gceann na cáipéise. Má shonraítear iolraí, roghnaíonn sé ceann go randamach.
See also
- WEBLATE_IP_PROXY_HEADER¶
Faigh Weblate an seoladh IP ó aon cheanntásc HTTP tugtha. Úsáid é seo agus seachfhreastalaí droim ar ais os comhair an choimeádáin Weblate.
Cumasaítear
IP_BEHIND_REVERSE_PROXYagus socraítearIP_PROXY_HEADER.Note
Caithfidh an fhormáid cloí le hionchais Django. Athraíonn Django transforms ainmneacha ceanntásca HTTP amh mar seo a leanas:
athraíonn gach carachtar go cás uachtair
cuirtear béim ar bhunsraitheanna in ionad aon phunann
réamhfhorlíonann
HTTP_réimír
Mar sin dhéanfaí
X-Forwarded-Fora mhapáil goHTTP_X_FORWARDED_FOR.Sampla:
environment: WEBLATE_IP_PROXY_HEADER: HTTP_X_FORWARDED_FOR
- WEBLATE_IP_PROXY_OFFSET¶
Added in version 5.0.1.
Cumraíonn
IP_PROXY_OFFSET.
- WEBLATE_USE_X_FORWARDED_PORT¶
Added in version 5.0.1.
Boole a shonraíonn cé acu ar cheart an ceanntásc X-Forwarded-Port a úsáid in ionad an athróg SERVER_PORT META. Níor cheart é seo a chumasú ach amháin má tá seachfhreastalaí a shocraíonn an ceanntásc seo in úsáid.
See also
Note
Is socrú boolean é seo (bain úsáid as
"fíor"nó"bréag").
- WEBLATE_SECURE_PROXY_SSL_HEADER¶
Tá tuple a sheasann do cheanntásc HTTP/teaglaim luacha a léiríonn iarratas slán. Tá sé seo ag teastáil nuair a bhíonn Weblate ag rith taobh thiar de sheachvótálaí droim ar ais a dhéanann foirceannadh SSL nach dtéann thar cheanntásca caighdeánacha HTTPS.
Sampla:
environment: WEBLATE_SECURE_PROXY_SSL_HEADER: HTTP_X_FORWARDED_PROTO,https
See also
- WEBLATE_REQUIRE_LOGIN¶
Cumasaítear
REQUIRE_LOGINchun fíordheimhniú a chur i bhfeidhm ar an Gréasán iomlán.Sampla:
environment: WEBLATE_REQUIRE_LOGIN: 1
- WEBLATE_LOGIN_REQUIRED_URLS_EXCEPTIONS¶
- WEBLATE_ADD_LOGIN_REQUIRED_URLS_EXCEPTIONS¶
- WEBLATE_REMOVE_LOGIN_REQUIRED_URLS_EXCEPTIONS¶
Cuirtear eisceachtaí URL leis le haghaidh fíordheimhnithe atá ag teastáil don suiteáil Weblate ar fad ag baint úsáide as
LOGIN_REQUIRED_URLS_EXCEPTIONS.Is féidir leat na socruithe iomlána a athsholáthar, nó an luach réamhshocraithe a athrú ag baint úsáide as na hathróga
ADDagus `` REMOVE``.Chun fíordheimhniú na foirme teagmhála a chur i bhfeidhm, déan:
environment: WEBLATE_REMOVE_LOGIN_REQUIRED_URLS_EXCEPTIONS: /contact/$
- WEBLATE_GOOGLE_ANALYTICS_ID¶
Cumraítear aitheantas do Google Analytics trí
GOOGLE_ANALYTICS_IDa athrú.
- WEBLATE_DEFAULT_PULL_MESSAGE¶
Cumraíonn sé an teideal agus an teachtaireacht réamhshocraithe le haghaidh iarratais tarraingthe trí API trí
DEFAULT_PULL_MESSAGEa athrú.See also
- WEBLATE_SIMPLIFY_LANGUAGES¶
Cumraíonn sé an polasaí simplithe teanga, féach
SIMPLIFY_LANGUAGES.
- WEBLATE_DEFAULT_ACCESS_CONTROL¶
Cumraíonn sé an réamhshocrú Rialú rochtana do thionscadail nua, féach
DEFAULT_ACCESS_CONTROL.
- WEBLATE_DEFAULT_RESTRICTED_COMPONENT¶
Cumraíonn sé an luach réamhshocraithe do Rochtain shrianta le haghaidh comhpháirteanna nua, féach
DEFAULT_RESTRICTED_COMPONENT.
- WEBLATE_DEFAULT_TRANSLATION_PROPAGATION¶
Cumraíonn sé an luach réamhshocraithe le haghaidh Ceadaigh iomadú aistriúcháin do chomhpháirteanna nua, féach
DEFAULT_TRANSLATION_PROPAGATION.
- WEBLATE_DEFAULT_COMMITER_EMAIL¶
Cumraíonn
DEFAULT_COMMITER_EMAIL.
- WEBLATE_DEFAULT_COMMITER_NAME¶
Cumraíonn
DEFAULT_COMMITER_NAME.
- WEBLATE_DEFAULT_SHARED_TM¶
Cumraíonn
DEFAULT_SHARED_TM.
- WEBLATE_AKISMET_API_KEY¶
Cumraigh an eochair API Akismet, féach
AKISMET_API_KEY.
- WEBLATE_GPG_IDENTITY¶
Cumraítear síniú GPG na ngealltanas, féach
WEBLATE_GPG_IDENTITY.See also
- WEBLATE_URL_PREFIX¶
Cumraigh réimír URL an áit a bhfuil Weblate ag rith, féach
URL_PREFIX.
- WEBLATE_SILENCED_SYSTEM_CHECKS¶
Cumraigh seiceálacha nach mian leat go dtaispeánfaí iad, féach
SILENCED_SYSTEM_CHECKS.
- WEBLATE_CSP_SCRIPT_SRC¶
- WEBLATE_CSP_IMG_SRC¶
- WEBLATE_CSP_CONNECT_SRC¶
- WEBLATE_CSP_STYLE_SRC¶
- WEBLATE_CSP_FONT_SRC¶
- WEBLATE_CSP_FORM_SRC¶
Is féidir an ceanntásc HTTP Content-Security-Policy a shaincheapadh.
- WEBLATE_LICENSE_FILTER¶
Cumraíonn
LICENSE_FILTER.
- WEBLATE_LICENSE_REQUIRED¶
Cumraíonn
LICENSE_REQUIRED.
- WEBLATE_WEBSITE_REQUIRED¶
Cumraíonn
WEBSITE_REQUIRED.
- WEBLATE_HIDE_VERSION¶
Cumraítear
HIDE_VERSION.
- WEBLATE_BASIC_LANGUAGES¶
Cumraíonn
BASIC_LANGUAGES.
- WEBLATE_DEFAULT_AUTO_WATCH¶
Cumraíonn
DEFAULT_AUTO_WATCH.
- WEBLATE_RATELIMIT_ATTEMPTS¶
- WEBLATE_RATELIMIT_LOCKOUT¶
- WEBLATE_RATELIMIT_WINDOW¶
Added in version 4.6.
Cumraigh teorannóir rátaí.
Hint
Is féidir leat cumraíocht a shocrú d'aon scóipí teoranta rátaí. Chun sin a dhéanamh cuir réimír
WEBLATE_le haon cheann de na suíomhanna a thuairiscítear in Teorainn rátaí.
- WEBLATE_API_RATELIMIT_ANON¶
- WEBLATE_API_RATELIMIT_USER¶
Added in version 4.11.
Cumraigh teorannú ráta API. Réamhshocruithe go dtí
100/lále haghaidh gan ainm agus `` 5000/uair`` d'úsáideoirí fíordheimhnithe.See also
- WEBLATE_ENABLE_HOOKS¶
Added in version 4.13.
Cumraíonn
ENABLE_HOOKS.
- WEBLATE_ENABLE_AVATARS¶
Added in version 4.6.1.
Cumraíonn sé
ENABLE_AVATARS.
- WEBLATE_AVATAR_URL_PREFIX¶
Added in version 4.15.
Cumraíonn
AVATAR_URL_PREFIX.
- WEBLATE_LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH¶
Added in version 4.9.
Cumraíonn
LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH.
- WEBLATE_SSH_EXTRA_ARGS¶
Added in version 4.9.
Cumraíonn
SSH_EXTRA_ARGS.
- WEBLATE_BORG_EXTRA_ARGS¶
Added in version 4.9.
Cumraíonn
BORG_EXTRA_ARGSmar liosta de args scartha camóg.Sampla:
environment: WEBLATE_BORG_EXTRA_ARGS: --exclude,vcs/
- WEBLATE_ENABLE_SHARING¶
Added in version 4.14.1.
Cumraíonn
ENABLE_SHARING.
- WEBLATE_SUPPORT_STATUS_CHECK¶
Added in version 5.5.
Cumraíonn
SUPPORT_STATUS_CHECK.
- WEBLATE_EXTRA_HTML_HEAD¶
Added in version 4.15.
Cumraíonn sé
EXTRA_HTML_HEAD.
- WEBLATE_PRIVATE_COMMIT_EMAIL_TEMPLATE¶
Added in version 4.15.
Cumraíonn
PRIVATE_COMMIT_EMAIL_TEMPLATE.
- WEBLATE_PRIVATE_COMMIT_EMAIL_OPT_IN¶
Added in version 4.15.
Cumraíonn
PRIVATE_COMMIT_EMAIL_OPT_IN.
- WEBLATE_UNUSED_ALERT_DAYS¶
Added in version 4.17.
Cumraíonn
UNUSED_ALERT_DAYS.
- WEBLATE_UPDATE_LANGUAGES¶
Added in version 4.3.2.
Cumraíonn
UPDATE_LANGUAGES.
- WEBLATE_CORS_ALLOWED_ORIGINS¶
Added in version 4.16.
Ceadaigh iarratais CORS chuig API ó bhunús ar leith.
Sampla:
environment: WEBLATE_CORS_ALLOWED_ORIGINS: https://example.com,https://weblate.org
- WEBLATE_CORS_ALLOW_ALL_ORIGINS¶
Added in version 5.6.1: Ceadaíonn sé iarratais CORS chuig API ó gach bunús.
- CLIENT_MAX_BODY_SIZE¶
Added in version 4.16.3.
Cumraíonn sé uasmhéid coirp a nglacann an freastalaí gréasáin ionsuite leis.
environment: CLIENT_MAX_BODY_SIZE: 200m
Hint
Tá réimír
WEBLATE_in easnamh ar an athróg seo d'aon ghnó mar go bhfuil sé roinnte le coimeádán tríú páirtí a úsáidtear i Deimhnithe SSL uathoibríoch ag baint úsáide as Let's Encrypt.
Dintiúir suímh óstála cód¶
Sa choimeádán Docker, is féidir na dintiúir óstála cód a chumrú in athróga ar leith nó ag baint úsáide as foclóir Python chun iad a shocrú ag an am céanna. Tá na samplaí seo a leanas le haghaidh Iarratais tharraingt GitHub, ach baineann siad le gach Comhtháthú rialaithe leagan le hainmneacha athraitheacha athraithe go cuí.
Seans go mbeidh cuma ar chumraíocht shamplach do GitHub:
WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com
Bainfear úsáid as mar:
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "api-user",
"token": "api-token",
}
}
Nó is féidir foclóir Python a sholáthar mar theaghrán:
WEBLATE_GITHUB_CREDENTIALS='{ "api.github.com": { "username": "api-user", "token": "api-token", } }'
Nó an cosán chuig comhad ina bhfuil an foclóir Python:
echo '{ "api.github.com": { "username": "api-user", "token": "api-token", } }' > /path/to/github-credentials
WEBLATE_GITHUB_CREDENTIALS_FILE='/path/to/github-credentials'
- WEBLATE_GITHUB_USERNAME¶
- WEBLATE_GITHUB_TOKEN¶
- WEBLATE_GITHUB_HOST¶
- WEBLATE_GITHUB_CREDENTIALS¶
Cumraíonn Iarratais tharraingt GitHub trí athrú
GITHUB_CREDENTIALS.
- WEBLATE_GITLAB_USERNAME¶
- WEBLATE_GITLAB_TOKEN¶
- WEBLATE_GITLAB_HOST¶
- WEBLATE_GITLAB_CREDENTIALS¶
Cumraigh Iarratais chumasc GitLab trí
GITLAB_CREDENTIALSa athrú.
- WEBLATE_GITEA_USERNAME¶
- WEBLATE_GITEA_TOKEN¶
- WEBLATE_GITEA_HOST¶
- WEBLATE_GITEA_CREDENTIALS¶
Cumraigh Iarratais tarraingt Gitea trí
GITEA_CREDENTIALSa athrú.
- WEBLATE_PAGURE_USERNAME¶
- WEBLATE_PAGURE_TOKEN¶
- WEBLATE_PAGURE_HOST¶
- WEBLATE_PAGURE_CREDENTIALS¶
Cumraigh leathanach iarratais chumaisc trí
PAGURE_CREDENTIALSa athrú.
- WEBLATE_BITBUCKETSERVER_USERNAME¶
- WEBLATE_BITBUCKETSERVER_TOKEN¶
- WEBLATE_BITBUCKETSERVER_HOST¶
- WEBLATE_BITBUCKETSERVER_CREDENTIALS¶
Cumraíonn Iarratais ar tharraingt Ionad Sonraí Bitbucket trí athrú
BITBUCKETSERVER_CREDENTIALS.
- WEBLATE_BITBUCKETCLOUD_USERNAME¶
- WEBLATE_BITBUCKETCLOUD_WORKSPACE¶
- WEBLATE_BITBUCKETCLOUD_TOKEN¶
- WEBLATE_BITBUCKETCLOUD_HOST¶
- WEBLATE_BITBUCKETCLOUD_CREDENTIALS¶
Cumraigh Iarratais ar tharraingt Bitbucket Cloud trí
BITBUCKETCLOUD_CREDENTIALSa athrú.
- WEBLATE_AZURE_DEVOPS_USERNAME¶
- WEBLATE_AZURE_DEVOPS_ORGANIZATION¶
- WEBLATE_AZURE_DEVOPS_TOKEN¶
- WEBLATE_AZURE_DEVOPS_HOST¶
- WEBLATE_AZURE_DEVOPS_CREDENTIALS¶
Cumraigh Iarratais tarraingthe Azure DevOps trí
AZURE_DEVOPS_CREDENTIALSa athrú.
Socruithe moltaí uathoibríocha¶
Changed in version 4.13: Tá seirbhísí molta uathoibríocha cumraithe anois sa chomhéadan úsáideora, féach Moltaí uathoibríocha.
Allmhairítear na hathróga timpeallachta atá ann cheana le linn an aistrithe go Weblate 4.13, ach ní bheidh aon éifeacht bhreise ag baint lena n-athrú.
Socruithe fíordheimhnithe¶
LDAP¶
- WEBLATE_AUTH_LDAP_SERVER_URI¶
- WEBLATE_AUTH_LDAP_USER_DN_TEMPLATE¶
- WEBLATE_AUTH_LDAP_USER_ATTR_MAP¶
- WEBLATE_AUTH_LDAP_BIND_DN¶
- WEBLATE_AUTH_LDAP_BIND_PASSWORD¶
- WEBLATE_AUTH_LDAP_CONNECTION_OPTION_REFERRALS¶
- WEBLATE_AUTH_LDAP_USER_SEARCH¶
- WEBLATE_AUTH_LDAP_USER_SEARCH_FILTER¶
- WEBLATE_AUTH_LDAP_USER_SEARCH_UNION¶
- WEBLATE_AUTH_LDAP_USER_SEARCH_UNION_DELIMITER¶
Cumraíocht fíordheimhnithe LDAP.
Sampla le haghaidh ceangal díreach:
environment: WEBLATE_AUTH_LDAP_SERVER_URI: ldap://ldap.example.org WEBLATE_AUTH_LDAP_USER_DN_TEMPLATE: uid=%(user)s,ou=People,dc=example,dc=net # map weblate 'full_name' to ldap 'name' and weblate 'email' attribute to 'mail' ldap attribute. # another example that can be used with OpenLDAP: 'full_name:cn,email:mail' WEBLATE_AUTH_LDAP_USER_ATTR_MAP: full_name:name,email:mail
Sampla le cuardach agus ceangal:
environment: WEBLATE_AUTH_LDAP_SERVER_URI: ldap://ldap.example.org WEBLATE_AUTH_LDAP_BIND_DN: CN=ldap,CN=Users,DC=example,DC=com WEBLATE_AUTH_LDAP_BIND_PASSWORD: password WEBLATE_AUTH_LDAP_USER_ATTR_MAP: full_name:name,email:mail WEBLATE_AUTH_LDAP_USER_SEARCH: CN=Users,DC=example,DC=com
Sampla do chuardach agus ceangal ceardchumainn:
environment: WEBLATE_AUTH_LDAP_SERVER_URI: ldap://ldap.example.org WEBLATE_AUTH_LDAP_BIND_DN: CN=ldap,CN=Users,DC=example,DC=com WEBLATE_AUTH_LDAP_BIND_PASSWORD: password WEBLATE_AUTH_LDAP_USER_ATTR_MAP: full_name:name,email:mail WEBLATE_AUTH_LDAP_USER_SEARCH_UNION: ou=users,dc=example,dc=com|ou=otherusers,dc=example,dc=com
Sampla le cuardach agus ceangal le hEolaire Gníomhach:
environment: WEBLATE_AUTH_LDAP_BIND_DN: CN=ldap,CN=Users,DC=example,DC=com WEBLATE_AUTH_LDAP_BIND_PASSWORD: password WEBLATE_AUTH_LDAP_SERVER_URI: ldap://ldap.example.org WEBLATE_AUTH_LDAP_CONNECTION_OPTION_REFERRALS: 0 WEBLATE_AUTH_LDAP_USER_ATTR_MAP: full_name:name,email:mail WEBLATE_AUTH_LDAP_USER_SEARCH: CN=Users,DC=example,DC=com WEBLATE_AUTH_LDAP_USER_SEARCH_FILTER: (sAMAccountName=%(user)s)
See also
GitHub¶
- WEBLATE_SOCIAL_AUTH_GITHUB_KEY¶
- WEBLATE_SOCIAL_AUTH_GITHUB_SECRET¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ORG_KEY¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ORG_SECRET¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ORG_NAME¶
- WEBLATE_SOCIAL_AUTH_GITHUB_TEAM_KEY¶
- WEBLATE_SOCIAL_AUTH_GITHUB_TEAM_SECRET¶
- WEBLATE_SOCIAL_AUTH_GITHUB_TEAM_ID¶
Cumasaítear Fíordheimhniú GitHub.
Eagrán Fiontraíochta GitHub¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ENTERPRISE_KEY¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ENTERPRISE_SECRET¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ENTERPRISE_URL¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ENTERPRISE_API_URL¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ENTERPRISE_SCOPE¶
Cumasaítear Fíordheimhniú GitHub EE.
Bitbuicéad¶
- WEBLATE_SOCIAL_AUTH_BITBUCKET_OAUTH2_KEY¶
- WEBLATE_SOCIAL_AUTH_BITBUCKET_OAUTH2_SECRET¶
- WEBLATE_SOCIAL_AUTH_BITBUCKET_KEY¶
- WEBLATE_SOCIAL_AUTH_BITBUCKET_SECRET¶
Cumasaítear Fíordheimhniú Bitbucket.
Facebook¶
- WEBLATE_SOCIAL_AUTH_FACEBOOK_KEY¶
- WEBLATE_SOCIAL_AUTH_FACEBOOK_SECRET¶
Cumasaítear Facebook OAuth 2.
Google¶
- WEBLATE_SOCIAL_AUTH_GOOGLE_OAUTH2_KEY¶
- WEBLATE_SOCIAL_AUTH_GOOGLE_OAUTH2_SECRET¶
- WEBLATE_SOCIAL_AUTH_GOOGLE_OAUTH2_WHITELISTED_DOMAINS¶
- WEBLATE_SOCIAL_AUTH_GOOGLE_OAUTH2_WHITELISTED_EMAILS¶
Cumasaítear Google OAuth 2.
GitLab¶
- WEBLATE_SOCIAL_AUTH_GITLAB_KEY¶
- WEBLATE_SOCIAL_AUTH_GITLAB_SECRET¶
- WEBLATE_SOCIAL_AUTH_GITLAB_API_URL¶
Cumasaítear GitLab OAuth 2.
Gitea¶
- WEBLATE_SOCIAL_AUTH_GITEA_API_URL¶
- WEBLATE_SOCIAL_AUTH_GITEA_KEY¶
- WEBLATE_SOCIAL_AUTH_GITEA_SECRET¶
Cumasaíonn sé fíordheimhniú Gitea.
Eolaire Gníomhach Azure¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_OAUTH2_KEY¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_OAUTH2_SECRET¶
Cumasaíonn sé fíordheimhniú Eolaire Gníomhach Azure, féach Eolaire gníomhach Microsoft Azure.
Azure Active Directory le tacaíocht Tionóntaí¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_KEY¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_SECRET¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_TENANT_ID¶
Cumasaíonn sé fíordheimhniú Eolaire Gníomhach Azure le tacaíocht Tionónta, féach Eolaire gníomhach Microsoft Azure.
Eochrach¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_KEY¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_SECRET¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_PUBLIC_KEY¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_ALGORITHM¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_AUTHORIZATION_URL¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_ACCESS_TOKEN_URL¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_TITLE¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_IMAGE¶
Cumasaíonn sé fíordheimhniú Slack, féach Keycloak - Open Source Red Hat SSO.
Díoltóirí linux¶
Is féidir leat fíordheimhniú a chumasú ag baint úsáide as seirbhísí fíordheimhnithe díoltóirí Linux trí athróga seo a leanas a shocrú d'aon luach.
- WEBLATE_SOCIAL_AUTH_FEDORA¶
- WEBLATE_SOCIAL_AUTH_OPENSUSE¶
- WEBLATE_SOCIAL_AUTH_OPENINFRA¶
- WEBLATE_SOCIAL_AUTH_UBUNTU¶
Leac¶
- WEBLATE_SOCIAL_AUTH_SLACK_KEY¶
OpenID Connect¶
Added in version 4.13-1.
- WEBLATE_SOCIAL_AUTH_OIDC_OIDC_ENDPOINT¶
- WEBLATE_SOCIAL_AUTH_OIDC_KEY¶
- WEBLATE_SOCIAL_AUTH_OIDC_SECRET¶
- WEBLATE_SOCIAL_AUTH_OIDC_USERNAME_KEY¶
Cumraigh comhtháthú cineálach OpenID Connect.
See also
SAML¶
Gintear eochracha SAML féin-shínithe go huathoibríoch ar an gcéad thos Sa chás gur mhaith leat eochracha féin a úsáid, cuir an deimhniú agus an eochair phríobháideach in /app/data/ssl/saml.crt agus /app/data/ssl/saml.key.
- WEBLATE_SAML_IDP_ENTITY_ID¶
- WEBLATE_SAML_IDP_URL¶
- WEBLATE_SAML_IDP_X509CERT¶
- WEBLATE_SAML_IDP_IMAGE¶
- WEBLATE_SAML_IDP_TITLE¶
Socruithe Soláthraí Aitheantais SAML, féach Fíordheimhniú SAML.
- WEBLATE_SAML_ID_ATTR_NAME¶
- WEBLATE_SAML_ID_ATTR_USERNAME¶
- WEBLATE_SAML_ID_ATTR_EMAIL¶
- WEBLATE_SAML_ID_ATTR_USER_PERMANENT_ID¶
Added in version 4.18.
mapáil tréithe SAML.
Socruithe fíordheimhnithe eile¶
- WEBLATE_NO_EMAIL_AUTH¶
Díchumasaítear fíordheimhniú ríomhphoist nuair a shocraítear é ar aon luach. Féach Fíordheimhniú pasfhocail a mhúchadh.
Socrú bunachar sonraí PostgreSQL¶
Cruthaíonn docker-compose.yml an bunachar sonraí, mar sin bíonn tionchar ag na socruithe seo ar choimeádáin Weblate agus PostgreSQL araon.
- POSTGRES_PASSWORD¶
Pasfhocal PostgreSQL.
See also
- POSTGRES_USER¶
Ainm úsáideora PostgreSQL.
- POSTGRES_DB¶
Ainm bunachar sonraí PostgreSQL.
- POSTGRES_HOST¶
Óstainm freastalaí PostgreSQL nó seoladh IP. Réamhshocrú ar
bunachar sonraí.
- POSTGRES_PORT¶
Port freastalaí PostgreSQL. Réamhshocruithe go ceann ar bith (úsáideann sé an luach réamhshocraithe).
- POSTGRES_SSL_MODE¶
Cumraigh conas a láimhseálann PostgreSQL SSL i dtaca leis an bhfreastalaí, le haghaidh roghanna féideartha féach Tuairisc Mhód SSL.
- POSTGRES_ALTER_ROLE¶
Cumraítear ainm ról PostgreSQL le hathrú le linn ascnaimh an bhunachair sonraí, féach Weblate a chumrú chun PostgreSQL a úsáid.
Réamhshocruithe chuig
POSTGRES_USER.
- POSTGRES_CONN_MAX_AGE¶
Added in version 4.8.1.
Fad saoil nasc bunachar sonraí, mar shlánuimhir soicind. Úsáid 0 chun naisc bhunachar sonraí a dhúnadh ag deireadh gach iarratais.
Changed in version 5.1: Is é an t-iompar réamhshocraithe ná naisc bhunachar sonraí neamhtheoranta marthanacha a bheith agat.
De ghnáth, beidh nasc níos oscailte leis an mbunachar sonraí mar thoradh ar mharthanacht naisc a chumasú. Coigeartaigh cumraíocht do bhunachar sonraí roimh chumasú.
Cumraíocht shamplach:
environment: POSTGRES_CONN_MAX_AGE: 3600
See also
- POSTGRES_DISABLE_SERVER_SIDE_CURSORS¶
Added in version 4.9.1.
Díchumasaigh cúrsóirí taobh an fhreastalaí sa bhunachar sonraí. Tá sé seo riachtanach i roinnt socruithe pgbouncer.
Cumraíocht shamplach:
environment: POSTGRES_DISABLE_SERVER_SIDE_CURSORS: 1
- WEBLATE_DATABASES¶
Added in version 5.1.
Socraithe go bréagach chun cumraíocht timpeallachtbhunaithe nasc an bhunachair shonraí a dhíchumasú. Úsáid Socruithe sáraitheacha ón méid sonraí chun nasc an bhunachair shonraí a chumrú de láimh.
Freastalaí MySQL nó MariaDB¶
Ní féidir MySQL ná MariaDB a chumrú trí athróga timpeallachta. Féach MySQL agus MariaDB le haghaidh faisnéise faoi na cinn a bhfuil Weblate acu a úsáid. Úsáid WEBLATE_DATABASES chun an nasc bunachar sonraí a chumrú de láimh.
Socruithe cúltaca bunachar sonraí¶
- WEBLATE_DATABASE_BACKUP¶
Cumraíonn sé dumpáil laethúil an bhunachair shonraí trí úsáid a bhaint as
DATABASE_BACKUP. Réamhshocrú goplain.
Socrú freastalaí taisce¶
Tá sé molta go láidir ag Weblate go n-úsáidfeá Redis agus caithfidh tú sampla Redis a chur ar fáil agus tú ag rith Weblate in Docker.
See also
- REDIS_HOST¶
Óstainm nó seoladh IP an fhreastalaí Redis. Réamhshocruithe le
taisce.
- REDIS_PORT¶
An port freastalaí Redis. Réamhshocrú go
6379.
- REDIS_DB¶
Uimhir bhunachar sonraí Redis, réamhshocraithe go
1.
- REDIS_PASSWORD¶
Focal faire an fhreastalaí Redis, nach n-úsáidtear de réir réamhshocraithe.
See also
- REDIS_TLS¶
Cumasaíonn sé SSL a úsáid le haghaidh nasc Redis.
- REDIS_VERIFY_SSL¶
Is féidir é a úsáid chun fíorú teastais SSL a dhíchumasú le haghaidh nasc Redis.
Socrú freastalaí ríomhphoist¶
Chun go n-oibreoidh r-phost amach, ní mór duit freastalaí ríomhphoist a sholáthar.
Sampla de chumraíocht TLS:
environment:
WEBLATE_EMAIL_HOST: smtp.example.com
WEBLATE_EMAIL_HOST_USER: user
WEBLATE_EMAIL_HOST_PASSWORD: pass
Sampla de chumraíocht SSL:
environment:
WEBLATE_EMAIL_HOST: smtp.example.com
WEBLATE_EMAIL_PORT: 465
WEBLATE_EMAIL_HOST_USER: user
WEBLATE_EMAIL_HOST_PASSWORD: pass
WEBLATE_EMAIL_USE_TLS: 0
WEBLATE_EMAIL_USE_SSL: 1
See also
- WEBLATE_EMAIL_HOST¶
Óstainm freastalaí ríomhphoist nó seoladh IP.
- WEBLATE_EMAIL_PORT¶
Port freastalaí ríomhphoist, réamhshocraithe go 25.
See also
- WEBLATE_EMAIL_HOST_USER¶
Úsáideoir fíordheimhnithe ríomhphoist.
See also
- WEBLATE_EMAIL_HOST_PASSWORD¶
Pasfhocal fíordheimhnithe ríomhphoist.
See also
- WEBLATE_EMAIL_USE_SSL¶
Cibé ar cheart nasc intuigthe TLS (slán) a úsáid agus tú ag caint leis an bhfreastalaí SMTP. I bhformhór na ndoiciméadú ríomhphoist, tagraítear don chineál seo de nasc TLS mar SSL. Úsáidtear é go ginearálta ar phort 465. Má tá fadhbanna agat, féach ar an socrú follasach TLS
WEBLATE_EMAIL_USE_TLS.Changed in version 4.11: Tá an tacaíocht SSL/TLS cumasaithe go huathoibríoch bunaithe ar an
WEBLATE_EMAIL_PORT.See also
- WEBLATE_EMAIL_USE_TLS¶
Cibé ar cheart nasc TLS (slán) a úsáid agus tú ag caint leis an bhfreastalaí SMTP. Úsáidtear é seo le haghaidh naisc shainráite TLS, go ginearálta ar phort 587 nó 25. Má tá naisc ar crochadh agat, féach ar an socrú TLS intuigthe
WEBLATE_EMAIL_USE_SSL.Changed in version 4.11: Tá an tacaíocht SSL/TLS cumasaithe go huathoibríoch bunaithe ar an
WEBLATE_EMAIL_PORT.See also
- WEBLATE_EMAIL_BACKEND¶
Cumraítear cúl-deireadh Django lena úsáid chun ríomhphoist a sheoladh.
See also
- WEBLATE_AUTO_UPDATE¶
Cumraíonn sé cé acu agus conas ba cheart do Weblate stórtha a nuashonrú.
See also
Note
Is suíomh Boole é seo (úsáid
"fíor"nó"bréagach").
Comhtháthú suímh¶
- WEBLATE_GET_HELP_URL¶
Cumraíonn
GET_HELP_URL.
- WEBLATE_STATUS_URL¶
Cumraíonn
STATUS_URL.
- WEBLATE_PRIVACY_URL¶
Cumraíonn
PRIVACY_URL.
Tuarascálacha earráide a bhailiú agus monatóireacht a dhéanamh ar fheidhmíocht¶
Moltar earráidí a bhailiú ón suiteáil go córasach, féach Tuarascálacha earráide a bhailiú agus monatóireacht a dhéanamh ar fheidhmíocht.
Chun tacaíocht do Rollbar a chumasú, socraigh an méid seo a leanas:
- ROLLBAR_KEY¶
Do chomhartha rochtana do fhreastalaí poist Rollbar.
- ROLLBAR_ENVIRONMENT¶
Do thimpeallacht Rollbar, réamhshocraithe go
léiriú.
Chun tacaíocht do Sentry a chumasú, socraigh an méid seo a leanas:
- SENTRY_DSN¶
Do Sentry DSN, féach
SENTRY_DSN.
- SENTRY_ENVIRONMENT¶
Do Thimpeallacht Sentry (roghnach), réamhshocrú go
WEBLATE_SITE_DOMAIN.
- SENTRY_TRACES_SAMPLE_RATE¶
Cumraíonn
SENTRY_TRACES_SAMPLE_RATE.Sampla:
environment: SENTRY_TRACES_SAMPLE_RATE: 0.5
- SENTRY_PROFILES_SAMPLE_RATE¶
Cumraíonn
SENTRY_PROFILES_SAMPLE_RATE.Sampla:
environment: SENTRY_PROFILES_SAMPLE_RATE: 0.5
- SENTRY_SEND_PII¶
Cumraíonn
SENTRY_SEND_PII.
Logánú CDN¶
- WEBLATE_LOCALIZE_CDN_URL¶
- WEBLATE_LOCALIZE_CDN_PATH¶
Added in version 4.2.1.
Cumraíocht le haghaidh Logánú JavaScript CDN.
Is é an
WEBLATE_LOCALIZE_CDN_PATHan chonair laistigh den choimeádán. Ba cheart é a stóráil ar an toirt leanúnach agus ní sa stóráil neamhbhuan.Ceann de na féidearthachtaí is ea é sin a stóráil taobh istigh den treoir sonraí Weblate:
environment: WEBLATE_LOCALIZE_CDN_URL: https://cdn.example.com/ WEBLATE_LOCALIZE_CDN_PATH: /app/data/l10n-cdn
Note
Tá tú freagrach as riaradh na gcomhad ginte ag Weblate a shocrú, ní stórálann sé ach na comhaid i suíomh cumraithe.
Aipeanna cumasaithe a athrú, seiceálacha, breiseáin, aistriúchán meaisín nó uathshocrú¶
Is féidir cumraíocht ionsuite na seiceálacha cumasaithe, na mbreiseán nó na socruithe uathoibríocha a choigeartú leis na hathróga seo a leanas:
- WEBLATE_ADD_APPS¶
- WEBLATE_REMOVE_APPS¶
- WEBLATE_ADD_CHECK¶
- WEBLATE_REMOVE_CHECK¶
- WEBLATE_ADD_AUTOFIX¶
- WEBLATE_REMOVE_AUTOFIX¶
- WEBLATE_ADD_ADDONS¶
- WEBLATE_REMOVE_ADDONS¶
- WEBLATE_ADD_MACHINERY¶
Added in version 5.6.1.
- WEBLATE_REMOVE_MACHINERY¶
Added in version 5.6.1.
Sampla:
environment:
WEBLATE_REMOVE_AUTOFIX: weblate.trans.autofixes.whitespace.SameBookendingWhitespace
WEBLATE_ADD_ADDONS: customize.addons.MyAddon,customize.addons.OtherAddon
Socruithe coimeádán¶
- WEBLATE_WORKERS¶
Added in version 4.6.1.
Bunlíon na bpróiseas oibrithe atá ag rith sa choimeádán. Nuair nach bhfuil sé socraithe déantar é a chinneadh go huathoibríoch ar tosaithe coimeádán bunaithe ar líon na gcroí LAP atá ar fáil.
Úsáidtear é chun a chinneadh
CELERY_MAIN_OPTIONS,CELERY_NOTIFY_OPTIONS,CELERY_MEMORY_OPTIONS,CELERY_TRANSLATE_OPTIONS,CELERY_BACKUP_OPTIONS,CELERY_BEAT_OPTIONS, agusWEB_WORKERS. Is féidir leat na socruithe seo a úsáid chun mionchoigeartú.
- CELERY_MAIN_OPTIONS¶
- CELERY_NOTIFY_OPTIONS¶
- CELERY_MEMORY_OPTIONS¶
- CELERY_TRANSLATE_OPTIONS¶
- CELERY_BACKUP_OPTIONS¶
- CELERY_BEAT_OPTIONS¶
Ligeann na hathróga seo duit roghanna oibrithe Soilire a choigeartú. Is féidir go mbeadh sé úsáideach concurrency (
--concurrency 16) a choigeartú nó cur i bhfeidhm difriúil linn snámha a úsáid (--pool = gevent).De réir réamhshocraithe, tá líon na n-oibrithe comhthráthacha bunaithe ar
WEBLATE_WORKERS.Sampla:
environment: CELERY_MAIN_OPTIONS: --concurrency 16
- CELERY_SINGLE_PROCESS¶
Added in version 5.7.1: Is féidir an athróg seo a shocrú go
1chun próiseas soilire amháin a rith. Laghdaíonn sé seo úsáid chuimhne ach d'fhéadfadh tionchar a bheith aige ar fheidhmíocht Weblate.environment: CELERY_SINGLE_PROCESS: 1
See also
- WEB_WORKERS¶
Cumraigh cé mhéad oibrí WSGI ba cheart a fhorghníomhú.
Réamhshocrú é go
WEBLATE_WORKERS.Sampla:
environment: WEB_WORKERS: 32
Changed in version 5.9: Ritheann an coimeádán Docker dhá phróiseas WSGI ó 5.9 agus cumraíonn
WEB_WORKERScé mhéad snáithe a bheidh ag gach próiseas.
- WEBLATE_SERVICE¶
Sainmhíníonn cé na seirbhísí ba chóir a fhorghníomhú taobh Úsáid é seo le haghaidh Scálú go cothrománach.
Sainmhínítear na seirbhísí seo a leanas:
celery-beatSceidealóir tasc soilire, níor cheart ach sampla amháin a bheith ar siúl. Tá an coimeádán seo freagrach freisin as aistrithe struchtúr an bhunachair shonraí agus ba cheart é a thosú roimh chinn eile.
celery-backupOibrí soilire le haghaidh cúltacaí, níor cheart ach sampla amháin a bheith ar siúl.
celery-celeryOibrí Soilire Cineálach.
celery-memoryCuimhne aistriúcháin Oibrí soilire.
celery-notifyFógraí Oibrí soilire.
celery-translateAistriúchán uathoibríoch Oibrí soilire.
webFreastalaí gréasáin.
Toirteanna coimeádán docker¶
Tá dhá imleabhar (data agus cache) easpórtáilte ag an gcoimeádán Weblate. Tá a méideanna sonraí ag na coimeádáin seirbhíse eile (PostgreSQL nó Redis) freisin, ach níl siad sin clúdaithe sa doiciméad seo.
Tá an toirt data gléasta mar /app/data agus úsáidtear é chun sonraí marthanacha Weblate a stóráil ar nós stórtha clónáilte nó chun suiteáil Weblate a shaincheapadh. Déanann DATA_DIR cur síos níos mine ar a bhfuil stóráilte anseo.
Braitheann socrúchán toirt Docker ar chóras óstach ar do chumraíocht Docker, ach de ghnáth stóráiltear é in /var/lib/docker/volumes/weblate-docker_weblate-data/_data/ (tá ainm d'eolaire docker-componc, coimeádán agus ainmneacha toirte sa chosán).
Tá an cache` toirte gléasta mar /app/cache agus úsáidtear é chun comhaid statacha a stóráil agus CACHE_DIR. Déantar an t-ábhar a athchruthú ar tosaithe coimeádáin agus is féidir an toirt a fheistiú trí úsáid a bhaint as córas comhaid gearrthéarmach mar tmpfs.
Agus na méideanna á gcruthú de láimh, ba cheart go mbeadh na heolairí faoi úinéireacht AitheantasÚsáideora 1000 mar is é sin an t-úsáideoir a úsáidtear taobh istigh den choimeádán.
Is féidir coimeádán le plátaí gréasáin a fhorghníomhú freisin le córas fréimhe inléite amháin. Sa chás seo, ba cheart dhá imleabhar breise `` tmpfs`` a fheistiú: /tmp agus /run.
See also
Córas fréimhe inléite amháin¶
Added in version 4.18.
Agus an coimeádán á rith le córas comhaid fréimhe inléite amháin, tá gá le dhá imleabhar breise tmpfs - /tmp agus /run.
Cumraíocht thar athróga timpeallachta¶
Tá sé mar aidhm ag athróga timpeallachta docker an chuid is mó de socruithe cumraíochta is ábhartha do shuiteálacha Weblate a nochtadh.
Má aimsíonn tú socrú nach bhfuil nochtaithe mar athróg timpeallachta, agus go gcreideann tú gur cheart go mbeadh, bíodh leisce ort iarr go nochtfaí é i leagan amach anseo de Weblate.
Más gá duit socrú nach bhfuil nochtaithe mar athróg timpeallachta Docker a mhodhnú, is féidir leat é sin a dhéanamh fós, ceachtar from the data volume no extending the Docker image.
See also
Socruithe sáraitheacha ón méid sonraí¶
Is féidir leat comhad a chruthú ag /app/data/settings-override.py, i.e. ag bun an toirt sonraí, chun socruithe arna sainiú trí athróga timpeallachta a shíneadh nó a shárú.
Socruithe a shárú trí íomhá an Docker a leathnú¶
Chun socruithe ag leibhéal íomhá an Docker a shárú seachas ón méid sonraí:
Cuir modúl le do phacáiste a iompórtálann gach socrú ó
weblate.settings_docker.Mar shampla, laistigh den struchtúr pacáiste sampla a shainítear ag Modúl Python a chruthú, d'fhéadfá comhad a chruthú ag
weblate_customization/weblate_customization/settings.pyleis an gcód tosaigh seo a leanas:from weblate.settings_docker import *
Cruthaigh
Dockerfilesaincheaptha a thagann le hoidhreacht ón íomhá oifigiúil Weblate Docker, agus ansin suiteálann do phacáiste agus pointe ar an athróg timpeallachta `` DJANGO_SETTINGS_MODULE`` chuig do mhodúl socruithe:FROM weblate/weblate USER root COPY weblate_customization /usr/src/weblate_customization RUN source /app/venv/bin/activate && uv pip install --no-cache-dir /usr/src/weblate_customization ENV DJANGO_SETTINGS_MODULE=weblate_customization.settings USER 1000
In ionad an íomhá oifigiúil Weblate Docker a úsáid, tóg íomhá saincheaptha ón gcomhad
Dockerfileseo.Níl bealach glan é seo a dhéanamh le
docker-compose.override.yml. D'fhéadfá `` build: .`` a chur leis an nódweblate `` sa chomhad sin, ach ansin déanfar d'íomhá saincheaptha a chlibeáil mar ``weblate/weblatei do chóras, rud a d'fhéadfadh a bheith ina fhadhb.Mar sin, in ionad an
docker-compose.ymla úsáid díreach ón stór oifigiúil, gan mhodhnú, agus é a leathnú trídocker-compose .override.yml, b'fhéidir gur mhaith leat cóip den chomhad oifigiúildocker-compose.ymla dhéanamh, agus do chóip a chur in eagar chunimage: weblate/weblatea chur in ionadbuild: ..Féach an Compose file build reference le haghaidh sonraí maidir le híomhánna a thógáil ón bhfoinse agus
docker-composein úsáid.Leathnaigh do mhodúl socruithe saincheaptha chun socruithe a shainiú nó a ath-shainmhíniú.
Is féidir leat socruithe a shainiú roimh nó tar éis an ráitis iompórtála thuas chun a chinneadh cé na socruithe a bhfuil tosaíocht acu. Is féidir le hathróga timpeallachta socruithe arna sainiú roimh an ráiteas allmhairithe a shárú agus is féidir sáruithe socraithe a shainítear sa toirt sonraí. Ní féidir an socrú a shainítear tar éis an ráitis allmhairithe a shárú.
Is féidir leat dul níos faide freisin. Mar shampla, is féidir leat cuid de na rudaí a dhéanann
weblate.docker_settings`` a atáirgeadh <https://github.com/WebateOrg/weblate/blob/main/weblate/settings_docker.py>`__, mar shampla socruithe a nochtadh mar athróga timpeallachta, nó cead a thabhairt do shocruithe sáraitheacha ó chomhaid Python sa toirt sonraí.
Lógó agus comhaid statacha eile a athsholáthar¶
Is féidir na comhaid statacha a thagann le Weblate a athshealbhú trí chur isteach i /app/data/python/customize/static (féach Toirteanna coimeádán docker). Mar shampla cruthóidh /app/data/python/customize/static/favicon.ico in ionad an favicon.
Hint
Déantar na comhaid a chóipeáil go dtí an suíomh comhfhreagrach nuair a thosaítear an coimeádán, mar sin tá gá le Weblate a atosú tar éis inneachar na toirte a athrú.
Is féidir an cur chuige seo a úsáid freisin chun teimpléid Ghréasán a shárú. Mar shampla is féidir Dlíthiúil doiciméid a chur isteach i /app/data/python/customize/templates/legal/documents.
Nó is féidir leat an modúl féin a chur san áireamh freisin (féach Weblate a shaincheapadh) agus é a chur mar imleabhar ar leith le coimeádán an Docker, mar shampla:
weblate:
volumes:
- weblate-data:/app/data
- ./weblate_customization/weblate_customization:/app/data/python/weblate_customization
environment:
WEBLATE_ADD_APPS: weblate_customization
Freastalaí PostgreSQL á chumrú¶
Úsáideann coimeádán PostgreSQL cumraíocht réamhshocraithe PostgreSQL agus ní bhainfidh sé úsáid éifeachtach as do chroíleacáin LAP ná as do chuimhne. Moltar an chumraíocht a shaincheapadh chun an fheidhmíocht a fheabhsú.
Is féidir an chumraíocht a choigeartú mar a thuairiscítear i Cumraíocht Bunachar Sonraí ag https://hub.docker.com/_/postgres. Is féidir an chumraíocht a mheaitseálann do thimpeallacht a ghiniúint ag baint úsáide as https://pgtune.leopard.in.ua/.
Inmheánach coimeádán¶
Tá an coimeádán ag baint úsáide supervisor chun seirbhísí aonair a thosú. I gcás Scálú go cothrománach, ní thosaíonn sé ach seirbhís aonair i gcoimeádán.
Úsáid stádas na seirbhísí a sheiceáil:
docker compose exec --user weblate weblate supervisorctl status
Tá seirbhísí aonair do gach scuaine Soilire (féach Tascanna cúlra ag baint úsáide as Soilire le haghaidh sonraí). Is féidir leat roinnt tascanna a phróiseáil tríd an oibrí cuí a stopadh:
docker compose exec --user weblate weblate supervisorctl stop celery-translate