From 853c113a07f8450691eb340a023e3fb27229dd44 Mon Sep 17 00:00:00 2001 From: Meir Date: Wed, 12 Feb 2020 17:28:35 +0100 Subject: [PATCH] aktualigas README; forigas DEPLOYMENT (closes #185) --- DEPLOYMENT.md | 110 -------------------------------------------------- README.md | 45 ++++++++++++--------- 2 files changed, 25 insertions(+), 130 deletions(-) delete mode 100644 DEPLOYMENT.md diff --git a/DEPLOYMENT.md b/DEPLOYMENT.md deleted file mode 100644 index d8f32617..00000000 --- a/DEPLOYMENT.md +++ /dev/null @@ -1,110 +0,0 @@ -# DEPLOYMENT - - -## Install on a new production server - -*ps@ps:~$* `sudo apt install nginx libpq-dev python3-dev python3-pip supervisor mercurial git vim postgresql autopostgresqlbackup` - -*ps@ps:~$* `ssh-keygen` - - Generating public/private rsa key pair. - Enter file in which to save the key (/home/ps/.ssh/id_rsa): *Enter* - Enter passphrase (empty for no passphrase): *Enter* - Enter same passphrase again: *Enter* - Your identification has been saved in /home/ps/.ssh/id_rsa. - Your public key has been saved in /home/ps/.ssh/id_rsa.pub. - The key fingerprint is: - 4b:85:03:e8:d1:d6:9c:d7:9b:09:46:3d:8a:ce:69:82 ps@ps - The key's randomart image is: - +---[RSA 2048]----+ - | o.o o.o | - | o o.+.+ + | - | . o o+.o = | - | . .o. + | - | . oS. | - | E ..=. | - | o. | - | | - | | - +-----------------+ - -*ps@ps:~$* `cat ~/.ssh/id_rsa.pub` - - ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDDjRRf//bqeEh1AiOVwsE88vpMnl/3Lmeon6YjcZ+KKFypjorEeVujYM9ji71Y5ihJvd6taYslF0+cJX1kpxunSpdaJRqmu07YI+RiFvooNMiVJlsC5n2oK/WYtGd1UeY8yxrjZ1b9nG9zkgfp50yCUgq2h6gfx5O+9289yLHtN3UTx/uZDAOqsVtVfJZv4Bnd9UozFuX3nd2mPRur2I2coqabxa24r/R/EUVinpULwz0BVy3VtHdNUMrvDnOXFhJxGby3hIVI2NbQwNMsu0Jbr9IvCx7T6vaxbCxGiif5nraabCfQcVQz5HdN+67novXTZAlBzMbyjhTMjVxKtBz/ ps@ps - -Copy this key in the [Deploy Keys in Bitbucket](https://bitbucket.org/pasportaservo/pasportaservo/admin/deploy-keys/) - -*ps@ps:~$* `sudo mkdir /srv/pasportaservo` - -*ps@ps:~$* `cd /srv/` - -*ps@ps:/srv$* `chown ps pasportaservo/` - -*ps@ps:/srv$* `hg clone ssh://hg@bitbucket.org/pasportaservo/pasportaservo` - - The authenticity of host 'bitbucket.org (131.103.20.168)' can't be established. - RSA key fingerprint is 97:8c:1b:f2:6f:14:6b:5c:3b:ec:aa:46:46:74:7c:40. - Are you sure you want to continue connecting (yes/no)? *yes* - remote: Warning: Permanently added 'bitbucket.org,131.103.20.168' (RSA) to the list of known hosts. - destination directory: pasportaservo - requesting all changes - adding changesets - adding manifests - adding file changes - added 187 changesets with 718 changes to 210 files - updating to branch default - 187 files updated, 0 files merged, 0 files removed, 0 files unresolved - -#### Creating the environment - -*ps@ps:~$* `sudo pip3 install virtualenvwrapper` - -*ps@ps:~$* `sudo mkdir /opt/envs` - -*ps@ps:~$* `sudo chgrp ps /opt/envs` - -*ps@ps:~$* `sudo chmod 775 /opt/envs` - -Add these lines at the bottom of ~/.bashrc - -*ps@ps:~$* `vim ~/.bashrc` - -> `# virtualenvwrapper` - -> `export WORKON_HOME=/opt/envs` - -> `export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3` - -> `source /usr/local/bin/virtualenvwrapper.sh` - -*ps@ps:~$* `source ~/.bashrc` - -*ps@ps:~$* `mkvirtualenv ps` - -*(ps)ps@ps:~$* `cd /srv/pasportaservo` - -*(ps)ps@ps:/srv/pasportaservo$* `pip install -r requirements/base.txt` - -#### Configuring PostgreSQL - -*ps@ps:~$* `sudo -u postgres createuser ps --interactive` - - Shall the new role be a superuser? (y/n) *n* - Shall the new role be allowed to create databases? (y/n) *y* - Shall the new role be allowed to create more new roles? (y/n) *n* - -*ps@ps:~$* `zcat pasportaservo_2015-11-23_07h35m.lundo.sql.gz | psql -d ps` - -#### Starting Django - -*(ps)ps@ps:/srv/pasportaservo/pasportaservo/settings$* `ln -s prod.py local_settings.py` - -*(ps)ps@ps:/srv/pasportaservo$* `mkdir static` - -Copy the `media` folder in `static` - -*(ps)ps@ps:/srv/pasportaservo$* `dj collectstatic` - -*(ps)ps@ps:/srv/pasportaservo$* `dj runserver` - -to test and then Ctrl-C diff --git a/README.md b/README.md index 41af2e84..b635b634 100644 --- a/README.md +++ b/README.md @@ -15,21 +15,21 @@ ### [Pasporta Servo](https://eo.wikipedia.org/wiki/Pasporta_Servo) estas senpaga tutmonda gastiga servo. -#### La projekto komencis en 1974 kiel eta jarlibro, kaj ekde 2009 ankaŭ daŭras kiel retejo. En tiu ĉi deponejo kolektiĝas la kodo kiu ruligas la retejon [pasportaservo.org](https://pasportaservo.org). - +**La projekto komenciĝis en 1974 kiel eta jarlibro, kaj ekde 2009 daŭras ankaŭ kiel retejo + (unue surbaze de Drupalo kaj nuntempe sur [Dĵango](https://www.djangoproject.com)). + En tiu ĉi deponejo kolektiĝas la kodo kiu ruligas la retejon [pasportaservo.org](https://pasportaservo.org).** - [Kontribui](#kontribui) - [Instali](#instali) - [Licenco](#licenco) -## Kontribui -Ĉu vi trovis cimon? Ĉu vi havas ideo kiel plibonigi la retejon? Nepre kreu [novan atentindaĵon](https://github.com/tejo-esperanto/pasportaservo/issues/new). +# Kᴏɴᴛʀɪʙᴜɪ +Ĉu vi trovis cimon? Ĉu vi havas ideon kiel plibonigi la retejon? Nepre kreu [novan atentindaĵon](https://github.com/tejo-esperanto/pasportaservo/issues/new). -## Instali -# INSTALI +# Iɴꜱᴛᴀʟɪ Ubuntu 16.10 / Debian Stretch: @@ -59,10 +59,10 @@ Por ĉiuj: #### Fontkodo -Iru al la [Github projektpaĝo](https://github.com/tejo-esperanto/pasportaservo) -kaj forku ĝin. Poste, vi povas kloni ĝin: +Iru al la [GitHub-projektpaĝo](https://github.com/tejo-esperanto/pasportaservo) +kaj forku la deponejon. Poste, vi povas kloni ĝin (ne forgesu tion fari ene de virtuala medio): - git clone https://github.com/via-uzantnomo/pasportaservo.git + git clone https://github.com/{via-uzantnomo}/pasportaservo.git cd pasportaservo pip install wheel pip install -r requirements/dev.txt @@ -73,22 +73,24 @@ kaj forku ĝin. Poste, vi povas kloni ĝin: Ĉu bone? Vidu http://localhost:8000 ----- - #### Retmesaĝoj -Dum disvolvigo, estas praktika uzi *MailDump* por provadi sendi retmesaĝoj. -Ekster la *env* virtuala medio, kun Pitono 2: +Dum disvolvigo, estas praktika uzi *MailDump* por provadi sendi retmesaĝojn. +Ekster la *env* virtuala medio, kun Pitono: pip install --user maildump maildump +---- + + ### Problem-solvado #### PostgreSQL: `unrecognized option --interactive` -Se la komando `sudo -u postgres createuser --interactive` malsukcesas (ekz., vi ricevas eraron "unrecognized option --interactive"), provu: +Se la komando `sudo -u postgres createuser --interactive` malsukcesas +(ekz., vi ricevas eraron "unrecognized option --interactive"), provu: $ sudo -u postgres psql psql (9.6.6) @@ -96,7 +98,7 @@ Se la komando `sudo -u postgres createuser --interactive` malsukcesas (ekz., vi postgres=# CREATE ROLE {via-uzantonomo} WITH LOGIN CREATEDB CREATEROLE; postgres=# \q -#### PostgreSQL: Ĉu mi bone kreis la datumbazoj? +#### PostgreSQL: Ĉu mi bone kreis la datumbazojn? $ sudo -u postgres psql psql (9.5.4) @@ -118,15 +120,18 @@ Se vi vidas tabelon kiel ĉi-supre, ĉio glate paŝis. ### Komprenu la strukturon de la kodo -- **pasportaservo/**: ĝenerala dosierujo kun konfiguro, baz-nivelaj URL-oj… -- **hosting/**: la ĉefa programo por gastiganta servo +- **pasportaservo/**: ĝenerala dosierujo kun konfiguro, baz-nivelaj URL-oj, bibliotekoj, ktp +- **core/**: bazaj ŝablonoj kaj ĉio rilata al aŭtentigo kaj (rolbazita) rajtigado +- **hosting/**: la ĉefa programo por gastiga servo -Kaj en la diversaj *aplikaĵon* (ekz. `hosting`, `book`, `links`…): +Kaj ene de la diversaj *Dĵango-aplikaĵoj* (ekz. `hosting`, `pages`, `links`…): -- models.py: strukturo de la datumoj +- models.py: strukturo de la datumoj, kaj bazaj operacioj por ĉiu modelo +- forms.py: formularoj por enigi kaj modifi datumojn - urls.py: ligoj inter URL-oj kaj paĝo-vidoj - views.py: difino de vidoj, paĝoj por prezentado - templates/: pseŭdo-HTML dosieroj (ŝablonoj) +- templatetags/: ebligas pli kompleksajn operaciojn en la ŝablonoj ### Lerni Dĵangon @@ -136,6 +141,6 @@ Kaj en la diversaj *aplikaĵon* (ekz. `hosting`, `book`, `links`…): - https://docs.djangoproject.com/en/stable/ -## Licenco +# Lɪᴄᴇɴᴄᴏ [GNU AGPLv3](LICENSE)