Merge pull request #10 from CatalystCode/install-script

Add one-click install script for project

Author: c-w

README.md

@@ -1,57 +1,50 @@
-featureService
-==============
+# featureService #
 
-Development Setup
-=====
-In order to install on your local machine, you will need to install:
+## Development setup ##
 
-1. Postgres + postgis ([instructions for Ubuntu 16.04](http://www.gis-blog.com/how-to-install-postgis-2-3-on-ubuntu-16-04-lts/))
-2. Node ([instructions for Ubuntu 16.04](https://www.digitalocean.com/community/tutorials/how-to-install-node-js-on-ubuntu-16-04))
+### System dependencies ###
 
-Once those are installed, go open a bash shell on the project directory and type:
+In order to install on your local machine, you will need to install:
 
-```
-psql postgres
-```
+- Postgres + postgis ([instructions for Ubuntu 16.04](http://www.gis-blog.com/how-to-install-postgis-2-3-on-ubuntu-16-04-lts/))
+- Node ([instructions for Ubuntu 16.04](https://www.digitalocean.com/community/tutorials/how-to-install-node-js-on-ubuntu-16-04))
 
-You will be welcomed with the postgres prompt. Now, create the geofeatures database and switch to it:
+### Database setup ###
 
-```
-CREATE DATABASE geofeatures;
-\c geofeatures;
+Once the system dependencies are installed, go open a bash shell on the project directory and set up the database:
 
-CREATE USER frontend PASSWORD your_password_here;
+```sh
+cat << EOF | sudo -u postgres psql
+CREATE DATABASE features;
+CREATE USER frontend WITH login password 'your_password_here';
+CREATE USER ops WITH login password 'your_other_password_here';
+GRANT ops TO postgres;
+GRANT frontend TO postgres;
+EOF
+sudo -u postgres psql -d features < schema.sql
 ```
 
-Next, load the database schema:
+### Application setup ###
 
-```
-psql -d geofeatures < schema.sql
-```
-
-Make sure the frontend user has access to the geofeatures database:
+First, make sure the environment variables for the service are set:
 
-```
-GRANT ALL PRIVILEGES ON DATABASE geofeatures TO frontend;
-```
-
-Then, make sure the environment variable for the newly-created user is set:
-
-```
-export FEATURES_CONNECTION_STRING='postgres://frontend:[email protected]/geofeatures'
+```sh
+export FEATURES_CONNECTION_STRING='postgres://frontend:[email protected]/features'
 export PORT=3035
 ```
 
-Now, make sure the nodejs dependencies are installed:
+Now you're ready to install and start the service:
 
-```
+```sh
 npm install
+node server.js
 ```
 
-Running
-=======
-All you need to do is run:
+## Production setup ##
 
-```
-node server.js
-```
+You can run the script `scripts/install.sh` to set up a production machine with the featureService and all its dependencies. The script will:
+
+- Install postgres and postgis
+- Populate the postgres features database
+- Install the featureService
+- Autostart the featureService on port 80

scripts/install.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+
+# configuration
+SCHEMA_VERSION='327df67'
+DUMP_VERSION='v2'
+
+# setup
+build_dependencies='curl git build-essential'
+sudo apt-get update > /dev/null
+sudo apt-get install -y ${build_dependencies} > /dev/null
+
+# install postgres
+ops_password="$(< /dev/urandom tr -dc _A-Z-a-z-0-9 | head -c32)"
+frontend_password="$(< /dev/urandom tr -dc _A-Z-a-z-0-9 | head -c32)"
+sudo apt-get install -y postgresql postgis > /dev/null
+sudo systemctl enable postgresql
+sudo service postgresql start
+echo "CREATE DATABASE features;" | sudo -u postgres psql
+echo "CREATE USER ops WITH login password 'changeme';" | sudo -u postgres psql
+echo "CREATE USER frontend WITH login password 'changeme';" | sudo -u postgres psql
+echo "ALTER USER ops WITH password '${ops_password}';" | sudo -u postgres psql
+echo "ALTER USER frontend WITH password '${frontend_password}';" | sudo -u postgres psql
+echo "GRANT ops TO postgres;" | sudo -u postgres psql
+echo "GRANT frontend TO postgres;" | sudo -u postgres psql
+curl -sL "https://raw.githubusercontent.com/CatalystCode/featureService/${SCHEMA_VERSION}/schema.sql" | sudo -u postgres psql -qd features
+
+# populate postgres
+dbdump="$(mktemp)"
+time_download_start="$(date +%s)"; echo "Starting to populate features database, this may take a while"
+curl -Lo "${dbdump}.gz" "https://fortiscentral.blob.core.windows.net/locations/feature-service.${DUMP_VERSION}.sql.gz"; gunzip -f "${dbdump}.gz"
+time_download_end="$(date +%s)"; echo "Seconds to download dump: $((time_download_end-time_download_start))"
+sudo -u postgres psql -qd features < "${dbdump}"
+time_insert_end="$(date +%s)"; echo "Seconds to populate database: $((time_insert_end-time_download_end))"
+rm "${dbdump}"
+
+# install node
+curl -sL 'https://deb.nodesource.com/setup_6.x' | sudo -E bash -
+sudo apt-get install -y nodejs > /dev/null
+
+# enable binding to port 80
+sudo apt-get install -y authbind > /dev/null
+sudo touch '/etc/authbind/byport/80'
+sudo chown "${USER}:${USER}" '/etc/authbind/byport/80'
+sudo chmod 755 '/etc/authbind/byport/80'
+
+# install app
+if [ ! -d featureService ]; then
+  git clone --depth 1 'https://github.com/CatalystCode/featureService.git'
+  (cd featureService; npm install)
+fi
+
+# autostart app
+sudo apt-get install -y supervisor > /dev/null
+sudo systemctl enable supervisor
+sudo service supervisor start
+sudo tee '/etc/supervisor/conf.d/featureService.conf' > /dev/null << EOF
+[program:featureService]
+command=/usr/bin/authbind "$(which node)" "$(readlink -f featureService/server.js)"
+autostart=true
+autorestart=true
+startretries=3
+stderr_logfile=/tmp/featureService.err.log
+stdout_logfile=/tmp/featureService.out.log
+user=${USER}
+environment=PORT=80,FEATURES_CONNECTION_STRING="postgres://frontend:${frontend_password}@127.0.0.1/features"
+EOF
+sudo supervisorctl reread
+sudo supervisorctl update
+
+# cleanup
+sudo apt-get remove -y ${build_dependencies} > /dev/null
+sudo apt-get autoremove -y > /dev/null
+sudo apt-get upgrade -y