INSTALL GEOTREK INSTANCE

this file describe how to install geotrek instance on makina geotrek docker server

Create a specific branch on gitlab geotrek-admin-deploy-docker from master

Connect to docker server (passwords in vaultier)

ssh root@ip_of_server

Clone and rename folder in /srv/geotrek

cd /srv/geotrek
git clone https://gitlab.makina-corpus.net/geotrek/geotrek-admin-deploy-docker.git your_instance_name
cd your_instance_name
git remote add your_instance_name instance_git
git checkout -b your_instance_name your_instance_name/your_instance_name

Create user and database on postgresql server

$ su - postgres
$ psql

CREATE USER your_database_user WITH ENCRYPTED PASSWORD 'your_user_password';
CREATE DATABASE your_database WITH OWNER your_database_user;
\c your_database
CREATE EXTENSION POSTGIS;
\q

Create environment file

$ cp .env.dist .env

Fill .env with data. If you share postgresql server, you must use docker interface address

GEOTREK_VERSION=geotrek_version
POSTGRES_HOST=172.17.0.1 ( | interface_address)
POSTGRES_USER=your_database_user
POSTGRES_DB=your_database
POSTGRES_PASSWORD=your_user_password
DOMAIN_NAME=your.final.geotrek.domain
SECRET_KEY=secret-and-unique-secret-and-unique
GUNICORN_CMD_ARGS=--bind=0.0.0.0:8000 --workers=5 --timeout=600
# CONVERSION_HOST=convertit_web
# CAPTURE_HOST=screamshotter_web

For the version of geotrek check : https://hub.docker.com/r/geotrekce/admin/tags/

Init volume config (with docker-compose)

docker-compose run web bash exit

Edit custom.py before initial.sh

$ sudo nano ./var/conf/custom.py

Fix at least your :

• SRID
• SPATIAL_EXTENT
• DEFAULT_STRUCTURE_NAME
• MODELTRANSLATION_LANGUAGES
• SYNC_RANDO_OPTIONS

Launch docker stack

Use this command only if you do not use docker-compose

docker stack deploy -c docker-stack.yml your_instance_name

Test initialize database and basic data

With docker stack :

docker exec $(docker ps -q -f name="your_instance_name_web") initial.sh

With docker-compose :

docker-compose run web initial.sh

---

---

Only with Docker Compose :

Install Service

1. Edit your docker-compose.yml, change ports :

     web:
        image: geotrekce/admin:${GEOTREK_VERSION}
        ports:
          - "127.0.0.1:<port_not_use_1>:8000"
        env_file:
          - .env
        volumes:
         - ./var:/app/src/var
        depends_on:
          - celery
        command: gunicorn geotrek.wsgi:application
   
     api:
        image: geotrekce/admin:${GEOTREK_VERSION}
        ports:
          - "127.0.0.1:<port_not_use_2>:8000"
        env_file:
          - .env
        volumes:
         - ./var:/app/src/var
        depends_on:
          - web
          - celery
        command: gunicorn geotrek.wsgi:application

2. Create a symbolic link between your nginx and /etc/nginx/sites-enable/

   ln -s nginx.conf /etc/nginx/sites-enable/<your_instance_name>.conf

3. Rename your service :

   mv your_instance_name.service <your_instance_name>.service

4. Fix Working Directory in <your_instance_name>.service

   WorkingDirectory=/srv/geotrek/<your_instance_name>
   

5. Copy your service in /etc/systemd/system

   cp <your_instance_name>.service /etc/systemd/system/<your_instance_name>.service

6. Enable the system

   systemctl enable <your_instance_name>.service

Run or Stop the service

systemctl start your_instance_name
systemctl stop your_instance_name

---

---

Only with Docker Stack :

Delete instance

docker stack rm your_instance_name

Redeploy (after update)

docker stack deploy -c docker-stack.yml your_instance_name
docker exec $(docker ps -q -f name="your_instance_name_web") update.sh

CRON jobs

Cleanup

edit host's cron to run cleanup.sh

Backup

edit host's cron to run backup.sh Backup are stored in /var/backups/geotrek/your_instance_name

Sync rando

edit host's cron to run sync_rando.sh

Don't forget to set SYNC_RANDO_OPTIONS in custom.py to set url, portal_url, skip_tiles and other required sync settings

Parsers

edit host's cron to run