oomag/swanager

A high-level Docker Services management tool built on top of Swarm

swanager

Development

Golang (1.7.5+) needs to be installed and set up

$ git clone [email protected]:dokkur/swanager.git && cd swanager
$ go get -u
$ go run swanager.go

Build

Simple:

./build.sh

Full:

TAG=latest DELETE_BUILD_IMAGE=0 GOLANG_BUILD_IMAGE=golang:1.8 ./build.sh

All params are optional.

Param	Default value	Description
TAG	latest	Tag of resulting image swanager:TAG
DELETE_BUILD_IMAGE	1	Whether of not, delete golang build image
GOLANG_BUILD_IMAGE	golang:1.8	Golang build image

Run

Docker container

docker run -d -v /var/run/docker.sock:/var/run/docker.sock swanager

Required mounted resource is a docker socket to manage docker.

Configure swanager container:

Env vars	Default value	Description
SWANAGER_PORT	4945	API port
SWANAGER_LOG	stdout	Logfile
SWANAGER_MONGO_URL	mongodb://127.0.0.1:27017/swanager	mongodb url
SWANAGER_DB_NAME	swanager	Mongodb database name
SWANAGER_PATH_PREFIX	/data	Service mount points root
SWANAGER_LOCAL_SECRET_KEY	-	Secret key, to authenticate local services (if none, won't be authenticated)

Docker stack file

You may want to store mongodb to mounted volume, just check swanager.yml

Start

docker stack deploy --compose-file swanager.yml swanager

Stop

docker stack rm swanager

swanager's Issues

Уникальность email для пользователя

Сейчас получилось создать 2х пользователей с одним имеилом.
Считаю, что надо сделать email уникальным полем.
@da4nik как думаешь?

формат ответа /api/v1/session

приходит такое:

{"token":{"token":"f2be4174-ac8a-1e68-df0b-fcfbdfa0c4a2d886ec5dbff7fd27","last_used":"2017-03-18T15:16:38.180540736Z"}}

@da4nik так и планировалось, чтобы был ключ token внутри объекта token?

published port

Предложение:

1. запретить принудительно указывать, какой порт должен быть открыт снаружи
2. в эндпоинт /services в объектах Service брать фактический экспоуженный published_ports Docker-ом (сейчас если при создании передать туда 0 в качестве External Port, swarm сам выберет внешний порт, но его потом никак получить нельзя)