michak/pinata-boot2docker repository overview

⁠Pinata: an experimental standalone Docker client

This is an experimental project to develop a new client for Docker, separately from the daemon or any other backend component.

By maintaining a standalone client, the goal is to:

1. Allow for more rapid iteration on client functionality.
2. Improve compatibility between different versions of the client and daemon.
3. Add more features to the client without bloating the daemon-side components.
4. Pave the way to simplifying the daemon code base, improving its quality and making its maintenance easier.

⁠Versioning

The release cycle respects the following convention: vX-Y where:

• X is the version of the docker engine used as a base for the build. The build can be modified during the build process to fit better into the use-case of Docker.app (ie. it won't usually be a drop-in replacement, but we will try to upstream our patches as quickly as possible).
• Y is an incremental counter which let us release new version of Docker.app independently of the release cycle of docker engine.

For instance the first release of pinata (dubbed "alpha 0") has the version: v1.9.1-a0.

⁠INSTALL

⁠Through HockeyApp

See the Docker.app (alpha) installation guide.⁠

⁠Clone

Check that your GOPATH is correctly set-up and clone this repository in $GOPATH/src/github.com/docker/pinata.

⁠Dependencies

As prerequisites, you need to have Xcode, homebrew and go installed.

To minimize build times, the dependencies are cached with this command

You only need to run it once or when an external dependency was updated

At the root of this repository, type:

make depends

When you add a new go dependency, add it in the GO_DEPS variable of the toplevel Makefile.

⁠Build

After a successful make depends, type:

make

If you are asked for the password to the dockerbuilder keychain, it is docker4all.

⁠Run

After a successful make depends and make, type:

make run

You will see the logs on stdout

⁠Install

First, make sure you have uninstalled any previous installation of pinata with:

v1/mac/uninstall

Then, install with:

v1/mac/build/Docker.app/Contents/MacOS/docker-installer

⁠Tests

You can run the tests by doing:

make test

⁠Troubleshooting

If you have an issue, please report it to the bugtracker⁠ with the output of:

v1/mac/build/Docker.app/Contents/MacOS/docker-diagnose