mirror of
https://github.com/Unleash/unleash.git
synced 2024-12-28 00:06:53 +01:00
61 lines
2.1 KiB
Markdown
61 lines
2.1 KiB
Markdown
# unleash-server
|
|
|
|
[](https://travis-ci.org/finn-no/unleash) [](https://codeclimate.com/github/finn-no/unleash) [](https://coveralls.io/r/finn-no/unleash?branch=master) [](https://david-dm.org/finn-no/unleash) [](https://david-dm.org/finn-no/unleash#info=devD)
|
|
|
|
unleash-server is a place to ask for the status of features.
|
|
|
|
## Clients
|
|
|
|
In order to make use of unleash you will probably need a client implementation.
|
|
|
|
Known client implementations:
|
|
- [unleash-client-java](https://github.com/finn-no/unleash-client-java)
|
|
|
|
## Development
|
|
|
|
### Create a local unleash-db on postgres
|
|
|
|
```bash
|
|
$ psql postgres <<SQL
|
|
CREATE USER unleash_user WITH PASSWORD 'passord';
|
|
CREATE DATABASE unleash;
|
|
GRANT ALL PRIVILEGES ON DATABASE unleash to unleash_user;
|
|
SQL
|
|
```
|
|
|
|
Then set DATABASE_URI env var:
|
|
```
|
|
export DATABASE_URL=postgres://unleash_user:passord@localhost:5432/unleash
|
|
```
|
|
|
|
### Commands
|
|
|
|
```
|
|
// Install dependencies
|
|
npm install
|
|
|
|
// Make sure DATABASE_URL is set and run migrations in your local DB
|
|
export DATABASE_URL=postgres://unleash_user:passord@localhost:5432/unleash
|
|
./node_modules/.bin/db-migrate up
|
|
|
|
// Start server in dev-mode:
|
|
npm run dev
|
|
|
|
// Admin dashboard
|
|
http://localhost:4242
|
|
|
|
// Feature API:
|
|
http://localhost:4242/features
|
|
|
|
// Execute tests:
|
|
npm test
|
|
```
|
|
|
|
### Making a schema change
|
|
|
|
1. Create `migrations/sql/NNN-your-migration-name.up.sql` with your change in SQL.
|
|
2. Create `migrations/sql/NNN-your-migration-name.down.sql` with the rollback of your change in SQL.
|
|
3. Run `db-migrate create your-migration-name` and edit the generated file to have this line: `module.exports = require('../lib/migrationRunner').create('NNN-your-migration-name');`
|
|
4. Run `npm run db-migrate-up`.
|
|
5. Generate LB artifact using `scripts/generate-liquibase-artifact` (TODO: make this internal)
|