mirror of
https://github.com/Unleash/unleash.git
synced 2024-12-28 00:06:53 +01:00
127 lines
3.6 KiB
Markdown
127 lines
3.6 KiB
Markdown
---
|
|
id: getting_started
|
|
title: Getting Started
|
|
---
|
|
|
|
> This section only applies if you plan to self-host Unleash. If you are looking for our hosted solution you should head over to [Unleash-hosted.com](https://www.unleash-hosted.com)
|
|
|
|
## Requirements
|
|
|
|
You will need:
|
|
|
|
- [Node.js](https://nodejs.org/en/download/) (version 12 or later)
|
|
- [PostgreSQL](https://www.postgresql.org/download/) (version 10 or later)
|
|
- [Create an unleash user and database](/docs/developer_guide).
|
|
|
|
## Start Unleash server
|
|
|
|
Whichever option you choose to start Unleash, you must specify a database URI (it can be set in the environment variable DATABASE_URL).
|
|
|
|
Once the server has started, you will see the message:
|
|
|
|
```sh
|
|
Unleash started on http://localhost:4242
|
|
```
|
|
|
|
### Option one - use Docker
|
|
|
|
**Useful links:**
|
|
|
|
- [Docker image on dockerhub](https://hub.docker.com/r/unleashorg/unleash-server/)
|
|
- [Unleash Helm Chart on artifacthub](https://artifacthub.io/packages/helm/unleash/unleash)
|
|
|
|
**Steps:**
|
|
|
|
1. Create a network by running `docker network create unleash`
|
|
2. Start a postgres database:
|
|
|
|
```sh
|
|
docker run -e POSTGRES_PASSWORD=some_password \
|
|
-e POSTGRES_USER=unleash_user -e POSTGRES_DB=unleash \
|
|
--network unleash --name postgres postgres
|
|
```
|
|
|
|
3. Start Unleash via docker:
|
|
|
|
```sh
|
|
docker run -p 4242:4242 \
|
|
-e DATABASE_HOST=postgres -e DATABASE_NAME=unleash \
|
|
-e DATABASE_USERNAME=unleash_user -e DATABASE_PASSWORD=some_password \
|
|
--network unleash unleashorg/unleash-server
|
|
```
|
|
|
|
#### Docker-compose
|
|
|
|
1. Clone the [unleash-docker](https://github.com/Unleash/unleash-docker) repository.
|
|
2. Run `docker-compose build` in repository root folder.
|
|
3. Run `docker-compose up` in repository root folder.
|
|
|
|
### Option two - from Node.js
|
|
|
|
1. Create a new folder/directory on your development computer.
|
|
2. From a terminal/bash shell, install the dependencies:
|
|
|
|
```sh
|
|
npm init
|
|
npm install unleash-server --save
|
|
```
|
|
|
|
3. Create a file called _server.js_, paste the following into it and save.
|
|
|
|
```js
|
|
const unleash = require('unleash-server');
|
|
|
|
unleash
|
|
.start({
|
|
databaseUrl: 'postgres://unleash_user:password@localhost:5432/unleash',
|
|
port: 4242,
|
|
})
|
|
.then(unleash => {
|
|
console.log(
|
|
`Unleash started on http://localhost:${unleash.app.get('port')}`,
|
|
);
|
|
});
|
|
```
|
|
|
|
4. Run _server.js_:
|
|
```sh
|
|
node server.js
|
|
```
|
|
|
|
### Option three - from a terminal/bash shell
|
|
|
|
_(deprecated)_
|
|
|
|
```sh
|
|
npm install unleash-server -g
|
|
unleash -d postgres://unleash_user:password@localhost:5432/unleash -p 4242
|
|
```
|
|
|
|
## Test your server and create a sample API call
|
|
|
|
Once the Unleash server has started, go to [localhost:4242](http://localhost:4242) in your browser. If you see a list of example feature toggles, try modifying one of them with [curl](https://curl.se/) from a terminal/bash shell:
|
|
|
|
```
|
|
curl --location --request PUT 'http://localhost:4242/api/admin/features/Feature.A' --header 'Content-Type: application/json' --data-raw '{\
|
|
"name": "Feature.A",\
|
|
"description": "Dolor sit amet.",\
|
|
"type": "release",\
|
|
"enabled": false,\
|
|
"stale": false,\
|
|
"strategies": [\
|
|
{\
|
|
"name": "default",\
|
|
"parameters": {}\
|
|
}\
|
|
]\
|
|
}'\
|
|
```
|
|
|
|
## Version check
|
|
|
|
- Unleash checks that it uses the latest version by making a call to https://version.unleash.run.
|
|
- This is a cloud function storing instance id to our database for statistics.
|
|
- This request includes a unique instance id for your server.
|
|
- If you do not wish to check for upgrades define the environment variable `CHECK_VERSION` to anything else other than `true` before starting, and Unleash won't make any calls
|
|
- `export CHECK_VERSION=false`
|