Skip to content

ckanner/crane

 
 

Repository files navigation

Crane

Join the chat at https://gitter.im/Dataman-Cloud/crane Build Status

Crane

Crane, maintained by dataman-cloud, is a docker control panel based on latest docker release. Besides swarm features, Crane implements some badly needed functionalities by enterprise user, such as private registries authentation, ACL and application DAB(distributed application bundle) sharing. The smart fuzzy search function give user quickly access to the desired page. Crane can help storing registry auth pair, from where you can choose a predefined registry auth pair when deploying a DAB, without the need to docker login when access private image. Crane can also help sharing your private images with your coworkers easily.

Features

  • Swarm features: Portal every feature of swarm almost. Crane has highlighted the common swarm functions and improved the user experience through the friendly frontend.
  • Stack templates management: User can save the running stack as a template, then, others will deploy the template as soon as possible.
  • Image management: The private image pushed by the user can be publiced to others.
  • Fuzzy search: A in-memory index maintained by the backend serves the function.
  • Node operation: Crane is showing the detail infos about node such as kernel version, docker info, docker images or containers in the given node and so on.
  • Overlay network management: The overlay network CRUD.
  • Private registries authentation: User can save his/her private registry username and password to Crane, then, the to-be-deployed stack can use the registry-auth to pull private registry images.
  • Webssh: Command 'docker exec' is the magic.

Demo

TODO: Let's deploy the demo.

Installation

Prerequisites

Option 1: Stable version in one line

For Chinese guys (pull images from catalog.shurenyun.com):

cd release && ./install.sh v1.0.4

For others (pull images from hub.docker.com):

cd release && ./install.sh v1.0.4 2breakfast/

Option 2: Latest or development from docker build

CRANE_IP=192.168.59.105 ./bin/build-and-start.sh

CRANE_IP is the ip address(don't use 0.0.0.0 because we are using container in network bridge mode) of the running Crane host which is the swarm manager also.

How to use it

Browser http://$CRANE_IP ,

  • username: admin@admin.com
  • password: adminadmin

Please click Crane User Guide in Chinese for more details.

Convention

repo branch

  • master: development branch in active. PR will be merged into this master branch.
  • release: Released version control. Tagged commits or hotfix PR will be pushed here. Maintained by the repo owners.

TroubleShooting

Community

Gitter

wechat group: 数人云Crane技术交流群

Contribution

Both pull-request or issue are welcomed from the community.

License

Crane is available under the Apache 2 license.

About

Control plane based on docker built-in swarm

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 38.2%
  • HTML 28.2%
  • JavaScript 24.6%
  • Shell 3.9%
  • CSS 3.4%
  • Python 1.0%
  • Other 0.7%