Go to file
2018-02-23 11:06:45 +08:00
assets Update Font Awesome to v5 2018-01-26 13:10:54 +08:00
biz Add task logs page 2018-02-23 11:06:45 +08:00
config Show update status 2018-01-19 15:51:25 +08:00
controller Add task logs page 2018-02-23 11:06:45 +08:00
dao Change mgo pkg 2018-01-19 16:21:46 +08:00
docs/images Replace dashboard image for reducing file size 2017-11-08 18:50:12 +08:00
misc Add task logs page 2018-02-23 11:06:45 +08:00
model Show update status 2018-01-19 15:51:25 +08:00
views Add task logs page 2018-02-23 11:06:45 +08:00
.gitattributes Add codes 2017-09-26 20:50:09 +08:00
.gitignore Add codes 2017-09-26 20:50:09 +08:00
compose.yml Add compose file 2018-01-04 15:54:28 +08:00
Dockerfile Update Font Awesome to v5 2018-01-26 13:10:54 +08:00
Gopkg.lock Change mgo pkg 2018-01-19 16:21:46 +08:00
Gopkg.toml Change mgo pkg 2018-01-19 16:21:46 +08:00
LICENSE Initial commit 2017-09-25 03:43:54 -05:00
main.go Update Font Awesome to v5 2018-01-26 13:10:54 +08:00
README.md Add compose file 2018-01-04 15:54:28 +08:00

SWIRL

Swirl

Swirl is a web management tool for Docker, focused on swarm cluster.

Features

  • Swarm components management
  • Image and container management
  • Compose management with deployment support
  • LDAP authentication support
  • Full permission control based on RBAC model
  • Scale out as you want
  • Multiple language support
  • And more...

Snapshots

Dashboard

Dashboard

Service list

Service list

Compose list

Compose list

Role editing

Role editing

Settings

Setting

Configuration

With config file

All options can be set with config/app.yml.

name: swirl
banner: false

web:
  address: ':8001'
  authorize: '?'

swirl:
  db_type: mongo
  db_address: localhost:27017/swirl
#  docker_endpoint: tcp://docker-proxy:2375

log:
  loggers:
  - level: info
    writers: console
  writers:
  - name: console
    type: console
    layout: '[{L}]{T}: {M}{N}'

With environment variables

Only three main options can be set by environment variables for now.

Name Value
DB_TYPE mongo
DB_ADDRESS localhost:27017/swirl
DOCKER_ENDPOINT tcp://docker-proxy:2375

With swarm config

Docker support mounting configuration file through swarm from v17.06, so you can store your config in swarm and mount it to your program.

Deployment

Stand alone

Just copy the swirl binary and config/assets/views directories to the host, and run it.

./swirl

Docker

docker run -d -p 8001:8001 \
    --mount type=bind,src=/var/run/docker.sock,dst=/var/run/docker.sock \
    -e DB_TYPE=mongo \
    -e DB_ADDRESS=localhost:27017/swirl \
    --name=swirl \
    cuigh/swirl

Docker swarm

docker service create \
  --name=swirl \
  --publish=8001:8001/tcp \
  --env DB_ADDRESS=localhost:27017/swirl \
  --constraint=node.role==manager \
  --mount=type=bind,src=/var/run/docker.sock,dst=/var/run/docker.sock \
  cuigh/swirl

Docker compose

docker stack deploy -c compose.yml swirl

Build

Swirl use dep as dependency management tool. You can build Swirl

$ dep ensure
$ go build

License

This product is licensed to you under the MIT License. You may not use this product except in compliance with the License. See LICENSE and NOTICE for more information.