colouring-montreal/docs/setup-production-environment.md
2020-01-24 15:44:19 +00:00

7.0 KiB

Setting Up A Production Environment

Preliminaries

This guide assumes a virtual environment (VM) running Ubuntu 18_04.

Install updates to packages:

sudo apt-get update

sudo apt-get dist-upgrade

Install openSSH (if necessary)

sudo apt install openssh-server


Install Essential Components

Install some useful development tools

sudo apt-get install -y build-essential git vim-nox wget curl

Install Postgres and associated tools

sudo apt-get install -y postgresql postgresql-contrib libpq-dev postgis postgresql-10-postgis-2.4

sudo apt-get install -y gdal-bin libspatialindex-dev libgeos-dev libproj-dev

Install Nginx

sudo apt install nginx

Clone the remote Colouring London GitHub repository into /var/www

cd /var/www

sudo git clone https://github.com/tomalrussell/colouring-london.git

Create a system user (nodeapp) to chown the colouring-london directory

useradd -r -s /bin/nologin nodeapp

Add the current user to the nodeapp group

sudo usermod -a -G nodeapp <your_ubuntu_username>

Make the nodeapp user/group chown the colouring-london directory and its subdirectories

sudo chown -R nodeapp:nodeapp /var/www/colouring-london

Now set appropriate permissions on the colouring-london directory

sudo chmod -R 775 /var/www/colouring-london


Install Node.

First define a couple of convenience variables:

NODE_VERSION=v12.14.1

DISTRO=linux-x64

Get the Node distribution and install it

wget -nc https://nodejs.org/dist/$NODE_VERSION/node-$NODE_VERSION-$DISTRO.tar.xz

sudo mkdir /usr/local/lib/node

sudo tar xf node-$NODE_VERSION-$DISTRO.tar.xz -C /usr/local/lib/node

sudo mv /usr/local/lib/node/node-$NODE_VERSION-$DISTRO /usr/local/lib/node/node-$NODE_VERSION

rm node-$NODE_VERSION-$DISTRO.tar.xz

Export the NODE_JS_HOME variable to your bash profile

cat >> ~/.profile <<EOF
export NODEJS_HOME=/usr/local/lib/node/node-$NODE_VERSION/bin
export PATH=$NODEJS_HOME:$PATH
EOF

Reload your profile to ensure changes take effect

source ~/.profile


Configure Node

Now upgrade the npm package manager to the most recent release with global privileges. This needs to be performed as root user, so it is necessary to export the node variables to the root user profile.

sudo su root

export NODEJS_HOME=/usr/local/lib/node/node-v12.14.1/bin/

export PATH=$NODEJS_HOME:$PATH

npm install -g npm@next

exit

Now install the required Node packages as designated in package.json

cd /var/www/colouring-london/app && npm install


Configure Postgres

sudo service postgresql start

sudo locale-gen en_US.UTF-8

sudo sed -i "s/#\?listen_address.*/listen_addresses '*'/" /etc/postgresql/10/main/postgresql.conf

echo "host all all all md5" | sudo tee --append /etc/postgresql/10/main/pg_hba.conf > /dev/null

For production we do not want to use our Ubuntu username as the Postgres username. So we need to replace peer authentication with password authentication for local connections.

sudo sed -i 's/^local.*all.*all.*peer$/local all all md5/' /etc/postgresql/10/main/pg_hba.conf

Restart Postgres for the configuration changes to take effect

sudo service postgresql restart

Create a distinct Postgres user

sudo -u postgres psql -c "SELECT 1 FROM pg_user WHERE usename = '<postgres_username>';" | grep -q 1 || sudo -u postgres psql -c "CREATE ROLE <postgres_username> SUPERUSER LOGIN PASSWORD '<postgres_password>';"

Create default colouring london database

sudo -u postgres psql -c "SELECT 1 FROM pg_database WHERE datname = 'colouringlondondb';" | grep -q 1 || sudo -u postgres createdb -E UTF8 -T template0 --locale=en_US.utf8 -O <postgres_username> colouringlondondb

psql -d colouringlondondb -U <postgres_username> -c "create extension postgis;"

psql -d colouringlondondb -U <postgres_username> -c "create extension pgcrypto;"

psql -d colouringlondondb -U <postgres_username> -c "create extension pg_trgm;"

Import data from the most recent colouring london database dump

pg_restore --no-privileges --no-owner --username "<postgres_username>" --dbname "colouringlondondb" --clean "<path/to/database/dump/file>"


Configure NGINX

Configure linux firewall

sudo ufw allow 'Nginx HTTP'

sudo ufw allow OpenSSH

sudo ufw enable

We can check the status of the firewall with

sudo ufw status

Now edit sites-available/default to create a minimal Nginx configuration to test the installation

sudo nano /etc/nginx/sites-available/default

# Handle HTTP connections with redirect
server {
    listen 80 default_server;
    listen [::]:80 default_server;
    server_name colouring-london;
    
    location / {
            proxy_pass http://localhost:3000/;
            proxy_set_header X-Real-IP $remote_addr;
   }

}

Make sure you didn't introduce any syntax errors by typing:

sudo nginx -t

If all is well, restart Nginx

sudo systemctl restart nginx

Test out the configuration

cd /var/www/colouring-london/app

npm run build

PGPASSWORD=<postgres_password> PGDATABASE=colouringlondondb PGUSER=<postgres_username> PGHOST=localhost PGPORT=5432 APP_COOKIE_SECRET=<secret> npm run start:prod

Now open a browser window on a client machine and navigate to the IP Address of your VM

http://<ip_address_of_vm>

You should see the Colouring London homepage.


Set up PM2

Perform a global install of PM2

sudo su root

export NODEJS_HOME=/usr/local/lib/node/node-v12.14.1/bin/

export PATH=$NODEJS_HOME:$PATH

npm install -g pm2

exit

Create an ecosystem.config.js file from the template file

cd /var/www/colouring-london

nano ecosystem.config.template.js

// Template for production ecosystem file

// Copy this file and edit to set up pm2 config
// DO NOT COMMIT details to this file (publicly visible)
// See https://pm2.io/doc/en/runtime/guide/ecosystem-file/ for docs
module.exports = {
    apps: [
        {
            name: "colouringlondon",
            script: "./app/build/server.js",
            instances: 6,
            env: {
                NODE_ENV: "production",
                PGHOST: "localhost",
                PGPORT: 5432,
                PGDATABASE: "colouringlondondb",
                PGUSER: "<postgres_username>",
                PGPASSWORD: "<postgres_password>",
                APP_COOKIE_SECRET: "<longrandomsecret>",
                TILECACHE_PATH: "/var/www/colouring-london/app/tilecache"
            }
        }
    ]
}

Edit the above file as appropriate and save as ecosystem.config.js

Start the colouring-london app

cd /var/www/colouring-london

pm2 start ecosystem.config.js

Open a browser window on a client machine and navigate to the IP Address of your VM

http://<ip_address_of_vm>

You should see the Colouring London homepage.

To stop the colouring-london app type:

pm2 stop ecosystem.config.js


Set up SSL - TO DO

DON'T FORGET to open the Ubuntu firewall to HTTPS