dockhand 0.3.1

FORK

Dockhand is forked from Shipright, as I need these new features now! All of the commands etc, are exactly as in Shipright.

Shipwright builds shared Docker images within a git repository in the right order and publishes them tagged with git’s revision/branch information so you’ll never loose track of an image’s origin.

It’s the perfect tool for building and publishing your images to places like Docker Hub or your own private registry. Have a look at our motivation to see why we built it and the pain points it solves for you.

$ pip install shipwright

{
  "version": 1.0,
  "namespace": "[your docker hub name or private repository]"
}

{
  "version": 1.0,

  "namespace": "shipwright",
  "names": {
    "/": "shipwright/shared",
    "/foo": "shipwright/awesome_sauce"
}

$ shipwright

Working example

We have a sample shipwright project you can use if you want to try this out right away.

$ git clone https://github.com/6si/shipwright-sample.git
$ cd shipwright-sample
$ shipwright

NOTE: you can use any username you’d like while building locally. In the above example we use ``shipwright``. Nothing is published unless you use the ``push`` command. For your own projects, substitute ``shipwright`` in the above example with your (or your organizations) official docker hub username or private repository.

Notice that if you run the shipwright a second time it will return immediately without doing anything. Shipwright is smart enough to know nothing has changed.

Shipwright really shines when you switch git branches.

$ git checkout new_feature
$ shipwright

Notice that shipwright only rebuilt the shared library and service1, ignoring the other projects because they have a common git ancestry. Running docker images however shows that all the images in the git repository have been tagged with the latest git revision, branch and latest.

In fact, as Shipwright builds containers it rewrites the Dockerfiles so that they require the base images with tags from the current git revision. This ensures that the entire build is deterministic and reproducible.

$ shipwright <namespace>/some_image

$ shipwright push

$ shipwright push --no-build

$ shipwright build
$ shipwright push -e <namespace>/public_image

0.3.1 (2016-06-06)

• Fix issue when images are built, but not in git.

0.3.0 (2016-06-06)

• Support .dockerignore files on Py3k

• shipwright ‘build’ sub-command is no-longer optional

• Support extra tags with ‘-t’

• Continue the build on failure, defer sys.exit until the end of the build.

• Support shor names in TARGETS.

0.2.0 (2016-05-19)

• Removed @curry decorator.

• Removed shipwright.version module.

• Removed purge command.

• Fixed various Python 3 bugs.

0.1.0 (2016-05-13)

• First version of dockhand that can be installed from PyPI