Skip to content

Latest commit

 

History

History
143 lines (103 loc) · 3.29 KB

SERVER.md

File metadata and controls

143 lines (103 loc) · 3.29 KB
Raw

Install on an Ubuntu server

First, install the following system dependencies:

sudo apt update
sudo apt upgrade
sudo apt-get install --no-install-recommends \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common \
    python-certbot-nginx \
    nginx \
    git

Then, install docker from the official repository:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"
sudo apt-get update
sudo apt-get install --no-install-recommends docker-ce docker-ce-cli containerd.io

Add your user to the docker group to run Docker as a non-root user:

sudo groupadd docker
sudo usermod -aG docker $USER
sudo newgrp docker
sudo systemctl enable docker
sudo systemctl start docker

Exit your shell session, and come back to be able to execute docker commands later on.

Install docker-compose:

sudo curl -L "https://github.com/docker/compose/releases/download/1.25.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Clone the stylo repository:

cd ~
git clone https://github.com/EcrituresNumeriques/stylo.git

Update the submodule:

cd stylo
git submodule init
git submodule update

Copy the stylo-example.env file and edit the variables:

cp stylo-example.env stylo.env

Finally, start the application:

docker-compose up -d --build

Deploy a new version

Push changes to the master branch then connect to the server using ssh. Fetch the changes:

cd git/stylo
git pull --rebase

Update and restart Stylo:

docker-compose up -d --build

Install a reverse proxy (NGINX)

Fetch the configuration file:

wget https://raw.githubusercontent.com/EcrituresNumeriques/stylo/master/infrastructure/files/stylo.huma-num.fr.conf -O- | sudo tee /etc/nginx/sites-enabled/stylo.huma-num.fr.conf

Edit the configuration to set the correct domain.

Install certbot to add Let's encrypt certificate:

sudo certbot certonly -n --standalone -d stylo-dev.huma-num.fr --agree-tos -m [email protected]
sudo openssl dhparam -dsaparam -out /etc/letsencrypt/ssl-dhparams.pem 4096

Once it's done, check that the configuration is valid with nginx -t then restart NGINX:

systemctl restart nginx

Database operations

Backup

docker exec mongodb-stylo sh -c 'mongodump --archive --db stylo-prod' > stylo-prod.dump

Restore

docker exec -i mongodb-stylo sh -c 'mongorestore --archive' < stylo-prod.dump
docker exec mongodb-stylo mongo --quiet --eval "db.adminCommand({listDatabases: 1}).databases.map(n => n.name)"
# ['admin', 'config', 'local', 'stylo-prod']

NOTE: If you need to rename the database during the import, you can use --nsFrom and --nsTo. For instance, if we want to rename the database from stylo to stylo-prod, we can use:

$ docker exec -i mongodb-stylo sh -c 'mongorestore --archive --nsFrom="stylo.*" --nsTo="stylo-prod.*"' < stylo-prod.dump

Apply migration script

docker cp migrate-data.js mongodb-stylo:/migrate-data.js
docker-compose exec mongodb-stylo mongo stylo-prod /migrate-data.js