/shipyard

Docker Management

Primary LanguagePython

Shipyard Stories in Ready

Shipyard is a web UI for http://docker.io

Quickstart

Use the Quickstart to get started.

Help

To report issues please use Github

There is also an IRC channel setup on Freenode: irc.freenode.net #shipyard

To run the latest version on port 8000:

docker run -p 8000:8000 shipyard/shipyard

Or to run on a custom port (leave the -p option off to get random port):

docker run -p 8005:8000 shipyard/shipyard

Username: admin Password: shipyard

Dev Setup

Shipyard needs Redis for caching and queueing. By default, it assumes Redis is running on localhost.

  • pip install -r requirements.txt
  • python manage.py syncdb --noinput
  • python manage.py migrate
  • python manage.py createsuperuser
  • python manage.py runserver
  • python manage.py celery worker -B --scheduler=djcelery.schedulers.DatabaseScheduler -E (in another terminal)
  • Open browser to http://localhost:8000
  • Add a host (i.e. 127.0.0.1 for local docker)

Alternate dev setup using vagrant (this will install all dependencies including docker itself for a self-contained dev environment):

  • vagrant up
  • vagrant ssh
  • python manage.py syncdb --noinput
  • python manage.py migrate
  • python manage.py createsuperuser
  • ./manage.py runserver 0.0.0.0:8000
  • ./manage.py celery worker -B --scheduler=djcelery.schedulers.DatabaseScheduler -E (in separate ssh session)
  • Open browser to http://localhost:8000

Features

  • Multiple host support
  • Create / Delete containers
  • View Images
  • Build Images (via uploaded Dockerfile or URL)
  • Import repositories
  • Private containers
  • Container metadata (description, etc.)
  • Applications: bind containers to applications that are setup with hipache
  • Attach container (terminal emulation in the browser)
  • Container recovery (mark container as "protected" and it will auto-restart upon fail/destroy/stop)
  • RESTful API
  • ...more coming...

Screenshots

Login

Containers

Container Details

Container Logs

Images

Applications

Hosts

Attach Container

  • Note: for attaching to containers you must have access to the docker host. This will change in the future.

API

Shipyard also has a RESTful JSON based API.

See https://github.com/shipyard/shipyard/wiki/API for API details.

Applications

Applications are groups of containers that are accessible by a domain name. The easiest way to test this is to add some local /etc/hosts entries for fake domains pointed to 10.10.10.25 (the vagrant vm). For example, add the following to /etc/hosts:

10.10.10.25 foo.local

Then you can create a new application with the domain foo.local. Attach one or more containers and then access http://foo.local in your browser and it should hit Hipache and be routed to the containers.

For more info on applications, see here

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.