DEPLOY.md

Ursa deployment guide

Preparation

Prerequicites:

sudo su -
apt install nginx build-essential python3-pip postgresql libpq-dev redis-server

Python3.6

apt build-dep python3.5
cd /tmp
wget https://www.python.org/ftp/python/3.6.4/Python-3.6.4.tar.xz
tar -xvf Python-3.6.*.tar.xz
cd Python-3.6.*
./configure
make -j4
make altinstall

Install setuptoolswheel

pip3.6 install -U pip setuptools wheel

Setup Database

echo 'CREATE USER root' | sudo -u postgres psql
echo 'CREATE DATABASE ursa WITH owner root' | sudo -u postgres psql

Config file

Create a file /etc/ursa.yml with this contents:

db:
  url: postgresql+psycopg2://root:@/ursa

  echo: false
application:
  welcome_url: http://localhost:8081/welcome
    
network:
  interfaces_dir:  /etc/network
  interfaces_file: /etc/network/interfaces
  default_interface: enp0s3

Copy your project to /usr/local/ursa

cd /usr/local/ursa
pip3.6 install -e .

Install Network Interfaces

Copy network-interfaces.tar.gz project to /tmp

pip3.6 install /tmp/network-interfaces.tar.gz 

Database objects

ursa --config-file /etc/ursa.yml admin setup-db
ursa --config-file /etc/ursa.yml admin base-data

Systemd

/etc/systemd/system/ursa.service:

[Unit]
Description=ursa API daemon
Requires=ursa.socket
After=network.target

[Service]
PIDFile=/run/ursa/pid
User=root
WorkingDirectory=/usr/local/ursa/
ExecStart=/usr/local/bin/gunicorn -w 1 --pid /run/ursa/pid -b unix:/run/ursa.socket wsgi_production:app
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true

[Install]
WantedBy=multi-user.target

/etc/systemd/system/ursa.socket:

Description=ursa socket

[Socket]
ListenStream=/run/ursa.socket

[Install]
WantedBy=sockets.target

/usr/lib/tmpfiles.d/ursa.conf:

d /run/ursa 0755 root root -

Next enable the services so they autostart at boot:

systemd-tmpfiles --create
systemctl daemon-reload
systemctl enable ursa.socket
service ursa start

Either reboot, or start the services manually:

systemctl start ursa.socket

NGINX

/etc/nginx/sites-available/ursa

upstream ursa_webapi {
    # fail_timeout=0 means we always retry an upstream even if it failed
    # to return a good HTTP response
    server unix:/run/ursa.socket fail_timeout=0;
}


server {
    listen 80;
    
    root /usr/local/octopus;
    index index.html;
    
    location / {
      try_files $uri $uri/ @rewrites;
    }
    
    location ~ /static/(.*) {
      include /etc/nginx/mime.types;
      alias /usr/local/octopus/static/$1;
    }

    location @rewrites {
      rewrite ^(.+)$ /index.html last;
    }

    location /apiv1/ {
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_redirect off;
      proxy_pass http://ursa_webapi;
    }

    
}

Restart Nginx

rm /etc/nginx/sites-enabled/default
ln -s /etc/nginx/sites-available/ursa /etc/nginx/sites-enabled/
service nginx restart

Reboot the device!

reboot