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.

  1. Clón an repo weblate-docker:

    git clone https://github.com/WeblateOrg/docker-compose.git weblate-docker
    cd weblate-docker
    
  2. Cruthaigh a:file: comhad docker-compose.override.yml le 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_PASSWORD socraithe, 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.yml chun é a athrú.

  3. 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.

Roghnú clárlann íomhá Docker

Foilsítear coimeádáin ghréasán chuig na clárlanna seo a leanas:

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

latest

An scaoileadh cobhsaí Weblate, meaitseálann an scaoileadh clibeáilte is déanaí

Nuashonruithe rollta i dtimpeallacht táirgthe

<MAJOR>

Scaoileadh cobhsaí Weblate

Nuashonruithe rollta laistigh de leagan mór i dtimpeallacht táirgthe

<MAJOR>.<MINOR>

Scaoileadh cobhsaí Weblate

Nuashonruithe rollta laistigh de leagan mion i dtimpeallacht táirgthe

<VERSION>.<PATCH>

Scaoileadh cobhsaí Weblate

Imscaradh dea-shainithe i dtimpeallacht táirgthe

edge

Scaoileadh cobhsaí Weblate le hathruithe forbartha sa choimeádán Docker (mar shampla spleáchais nuashonraithe)

Nuashonruithe rollta i dtimpeallacht stáitse

edge-<DATE>-<SHA>

Scaoileadh cobhsaí Weblate le hathruithe forbartha sa choimeádán Docker (mar shampla spleáchais nuashonraithe)

Imscaradh dea-shainithe i dtimpeallacht stáitse

bleeding

Leagan forbartha Weblate ó Git

Nuashonruithe rollta chun gnéithe Weblate atá le teacht a thástáil

bleeding-<DATE>-<SHA>

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.pem ina bhfuil an teastas lena n-áirítear aon deimhnithe CA atá ag teastáil

  • ssl/privkey.pem ina 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.

  1. Stop coimeádán Weblate:

    docker compose stop weblate cache
    
  2. Cúltaca an bunachar sonraí:

    docker compose exec database pg_dumpall --clean --if-exists --username weblate > backup.sql
    
  3. Stop an coimeádán bunachar sonraí:

    docker compose stop database
    
  4. 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-docker sa doiciméadú seo.

  5. Coigeartaigh docker-compose.yml chun leagan nua PostgreSQL a úsáid.

  6. Tosaigh coimeádán an bhunachair shonraí:

    docker compose up -d database
    
  7. 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.

  8. (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.

  9. 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

Socruithe cineálacha

WEBLATE_DEBUG

Cumraíonn sé mód dífhabhtaithe Django ag baint úsáide as DEBUG.

Sampla:

environment:
  WEBLATE_DEBUG: 1
WEBLATE_LOGLEVEL

Cumraíonn sé briathrachas na logála. Socraigh é seo go DEBUG chun logaí níos mionsonraithe a fháil.

Réamhshocruithe le INFO nuair a mhúchtar WEBLATE_DEBUG, úsáidtear DEBUG nuair a chuirtear mód dífhabhtaithe ar siúl.

Le haghaidh logáil níos ciúine, úsáid ERROR nó `` 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
WEBLATE_ADMIN_NAME
WEBLATE_ADMIN_EMAIL

Cumraíonn sé ainm agus r-phost riaracháin an láithreáin. Úsáidtear é chun an bheirt ADMINS agus úsáideoir admin a chruthú (féach WEBLATE_ADMIN_PASSWORD le 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_NAME agus WEBLATE_ADMIN_EMAIL a 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.

WEBLATE_SERVER_EMAIL

An seoladh ríomhphoist óna seoltar teachtaireachtaí earráide.

WEBLATE_DEFAULT_FROM_EMAIL

Cumraíonn sé an seoladh le haghaidh ríomhphoist amach.

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_HTTPS doicimé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_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.

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_PROXY agus socraítear IP_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-For a mhapáil go HTTP_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.

Note

Is socrú boolean é seo (bain úsáid as "fíor""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
WEBLATE_REQUIRE_LOGIN

Cumasaítear REQUIRE_LOGIN chun 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 ADD agus `` 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_ID a athrú.

WEBLATE_DEFAULT_PULL_MESSAGE

Cumraíonn sé an teideal agus an teachtaireacht réamhshocraithe le haghaidh iarratais tarraingthe trí API trí DEFAULT_PULL_MESSAGE a athrú.

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.

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.

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_ARGS mar 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_CREDENTIALS a athrú.

WEBLATE_GITEA_USERNAME
WEBLATE_GITEA_TOKEN
WEBLATE_GITEA_HOST
WEBLATE_GITEA_CREDENTIALS

Cumraigh Iarratais tarraingt Gitea trí GITEA_CREDENTIALS a athrú.

WEBLATE_PAGURE_USERNAME
WEBLATE_PAGURE_TOKEN
WEBLATE_PAGURE_HOST
WEBLATE_PAGURE_CREDENTIALS

Cumraigh leathanach iarratais chumaisc trí PAGURE_CREDENTIALS a 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_CREDENTIALS a 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_CREDENTIALS a 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_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)

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
SOCIAL_AUTH_SLACK_SECRET

Cumasaíonn sé fíordheimhniú Slack, féach Leac.

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.

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.

WEBLATE_MIN_PASSWORD_SCORE

Íosscór focal faire arna mheas ag an meastóir láidreachta pasfhocail zxcvbn . Réamhshocrú go 3, socraithe go 0 chun seiceáil neart a dhíchumasú.

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

Rúin a rith

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
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ú go plain.

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.

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

Rúin a rith

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
WEBLATE_EMAIL_HOST

Óstainm freastalaí ríomhphoist nó seoladh IP.

WEBLATE_EMAIL_PORT

Port freastalaí ríomhphoist, réamhshocraithe go 25.

See also

EMAIL_PORT

WEBLATE_EMAIL_HOST_USER

Úsáideoir fíordheimhnithe ríomhphoist.

See also

EMAIL_HOST_USER

WEBLATE_EMAIL_HOST_PASSWORD

Pasfhocal fíordheimhnithe ríomhphoist.

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.

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.

WEBLATE_EMAIL_BACKEND

Cumraítear cúl-deireadh Django lena úsáid chun ríomhphoist a sheoladh.

WEBLATE_AUTO_UPDATE

Cumraíonn sé cé acu agus conas ba cheart do Weblate stórtha a nuashonrú.

See also

AUTO_UPDATE

Note

Is suíomh Boole é seo (úsáid "fíor""bréagach").

Comhtháthú suímh

WEBLATE_GET_HELP_URL

Cumraíonn GET_HELP_URL.

WEBLATE_STATUS_URL

Cumraíonn STATUS_URL.

Cumraíonn LEGAL_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_PATH an 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, agus WEB_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 1 chun 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
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_WORKERS cé 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-beat

Sceidealó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-backup

Oibrí soilire le haghaidh cúltacaí, níor cheart ach sampla amháin a bheith ar siúl.

celery-celery

Oibrí Soilire Cineálach.

celery-memory

Cuimhne aistriúcháin Oibrí soilire.

celery-notify

Fógraí Oibrí soilire.

celery-translate

Aistriúchán uathoibríoch Oibrí soilire.

web

Freastalaí 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.

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.

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í:

  1. Cruthaigh pacáiste Python saincheaptha.

  2. 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.py leis an gcód tosaigh seo a leanas:

    from weblate.settings_docker import *
    
  3. Cruthaigh Dockerfile saincheaptha 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
    
  4. In ionad an íomhá oifigiúil Weblate Docker a úsáid, tóg íomhá saincheaptha ón gcomhad Dockerfile seo.

    Níl bealach glan é seo a dhéanamh le docker-compose.override.yml. D'fhéadfá `` build: .`` a chur leis an nód weblate `` sa chomhad sin, ach ansin déanfar d'íomhá saincheaptha a chlibeáil mar ``weblate/weblate i do chóras, rud a d'fhéadfadh a bheith ina fhadhb.

    Mar sin, in ionad an docker-compose.yml a ú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úil docker-compose.yml a dhéanamh, agus do chóip a chur in eagar chun image: weblate/weblate a chur in ionad build: ..

    Féach an Compose file build reference le haghaidh sonraí maidir le híomhánna a thógáil ón bhfoinse agus docker-compose in úsáid.

  5. 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