intermine/staircase

Name: staircase

Owner: InterMine

Description: The webapp serving intermine steps

Created: 2014-04-09 00:37:22.0

Updated: 2015-05-15 09:27:46.0

Pushed: 2016-01-04 12:17:25.0

Homepage: http://staircase.herokuapp.com

Size: 1867

Language: Clojure

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

staircase

The webapp that serves the step-based data-flow interface to the InterMine system. You can view a running version on [Heroku][http://staircase.herokuapp.com] and see the documentation [here][http://alexkalderimis.github.io/staircase/latest/index.html].

Quick Start

Assuming leingingen, postgres and nodejs are installed (see dependencies below):

rt PORT=3000 \
   DB_USER=YOU \
   SECRET_KEY_PHRASE="some long and unguessable phrase" \
   WEB_AUDIENCE=http://localhost:$PORT
tedb staircase  # Creates database using the default name
install         # installs js dependencies
 run            # installs server dependencies, runs server

Heroku Quick Start

Heroku is a fantastic service for hosting webapps. You can run an instance of this application for free to get started with staircase.

To deploy to heroku you will need to create a new heroku app (see heroku docs), provision a postgres DB and set the following environment variables:

ku config:set DB_PASSWORD=$YOUR_PASSWD \
              DB_USER=$YOUR_USER \
              DB_SUBNAME=//$HOST/$DBNAME \
              DB_PORT=$DB_PORT \
              WEB_AUDIENCE=$URL \ 
              WEB_DEFAULT_SERVICE=flymine \
              SECRET_KEY_PHRASE="long key phrase" \
              WEB_MAX_AGE=300

With that configured, you can launch a staircase by pushing to your repo:

push heroku master

The key-phrase can be any string, but it should be kept secure. The audience must be the same as the public URL of the site, or else Persona login will not work. Additional setting can be provided as follows:

tivate google analytics
ku config:set CLIENT_GA_TOKEN=$YOUR_TOKEN
able the clojure repl for debugging access
ku config:set WEB_REPL_USER=$YOU WEB_REPL_PWD=$YOUR_PWD

We build with the buildpack-multi buildpack, since we have a two-stage nodejs/clojure build. This is set in the .env file.

Prerequisites and Dependencies

You will need Leiningen 2.0 or above installed (2.4+ to use the web-repl). This handles all dependencies. As clojure is a JVM language, this requires a JDK (1.6+) be installed; please see your friendly java vendor for details.

A node-js environment is also required, which handles the installation of the javascript dependencies using npm and Bower.

This application also makes use of a postgres database. So you will need postgres installed and configured. We use the uuid-ossp psql extension, which is available by default on Heroku, and needs installing if you are setting up your own database. Luckily this is a standard extension, and is generally available in the contrib packages from your vendor, eg. in Ubuntu run:

 apt install postgresql-contrib

Configuration

You must configure the database and add a secrets file before you can run the application.

The secrets file is needed to sign authentication tokens. You can use private/public key pairs, or simply provide a key phrase for HMAC hashing. In the latter case, add a resources/secrets.edn file which defines a key-phrase:

ey-phrase "some utterly random and unguessable key phrase"

The database and the toolset are configured using Environ, which has a flexible configuration system. Most settings are to be found in profiles.clj.

It is recommended that DB authentication settings do not live in source controlled files, but should instead be configured through environment variables or in the user config (~./lein/profile.clj). See the heroku section above for details on the use of environment variables for this purpose.

The following configuration values are recognized, here presented as you might configure them in a profiles.clj file:

:user {
    :env {
        :db-user "DB-USER"     ;; The db user (optional)
        :db-password "DB-PASS" ;; The db-password (optional)
        :db-subname "//host/dbname" ;; The db host and name
                                    ;; see profiles.clj for
                                    ;; default values.
    }
}

These values can be configured through environment variables (see Environ for details), eg:

SER=$PSQL_USER

Running

To start a web server for the application, run:

 ring server

To run the tests, you will need a test database (by default named staircase-test) and be able to access it. It is recommended you add configuration values to ~/.lein/profiles.clj for these properties, but this can also be configured in environment variables - see [Configuration][].

 test

To run the client side tests:

install
test

License

Copyright © 2014 Alex Kalderimis and InterMine