Developer Guide

PostgreSQL

To run and develop unleash you need to have PostgreSQL databse (PostgreSQL v.9.5.x or newer) locally.

Create a local unleash databases in postgres

$ psql postgres <<SQL
CREATE USER unleash_user WITH PASSWORD 'passord';
CREATE DATABASE unleash;
GRANT ALL PRIVILEGES ON DATABASE unleash to unleash_user;
CREATE DATABASE unleash_test;
GRANT ALL PRIVILEGES ON DATABASE unleash_test to unleash_user;
SQL

Then set env vars:

(Optional as unleash will asume these as default values).

export DATABASE_URL=postgres://unleash_user:passord@localhost:5432/unleash
export TEST_DATABASE_URL=postgres://unleash_user:passord@localhost:5432/unleash_test

PostgreSQL with docker

If you dont want to install PostgreSQL locally you can spin up an instance with docker. We have created a script to ease this process: scripts/docker-postgres.sh

Commands

// Install dependencies
npm install

// Build unleash-frontend 
// (yes this is a bit wierd and be easier when we have a release of the frontend artifact).
// You can of course "npm link unleash-frontend" instead 
cd node_modules/unleash-frontend && npm install

// Start server in development
npm start:dev

// Admin dashboard
http://localhost:4242

// Feature API:
http://localhost:4242/api/features

// Execute tests in all packages:
npm test

Database changes

We use database migrations to track database changes.

Making a schema change

In order to run migrations you will set the environment variable for DATABASE_URL

export DATABASE_URL=postgres://unleash_user:passord@localhost:5432/unleash

Use db-migrate to create new migrations file.

> npm run db-migrate -- create YOUR-MIGRATION-NAME

All migrations requires on up and one down method.

Example of a typical migration:

/* eslint camelcase: "off" */
'use strict';

exports.up = function (db, cb) {
    db.createTable('examples', {
        id: { type: 'int', primaryKey: true, notNull: true },
        created_at: { type: 'timestamp', defaultValue: 'now()' },
    }, cb);
};

exports.down = function (db, cb) {
    return db.dropTable('examples', cb);
};

Test your migrations:

> npm run db-migrate -- up
> npm run db-migrate -- down

Publishing / Releasing new packages

Please run npm run nsp nad npm run test checks before publishing.

Run npm run publish to start the publishing process.

npm run publish:dry

2.4 KiB Raw Blame History