griff / boondock

Docker daemon API in Rust

Boondock: Rust library for talking to the Docker daemon

This is a work in progress!

This is a fork of Graham Lee's highly useful rust-docker library, with hyper support from Toby Lawrence and various other recent patches integrated.

It also adds:

• Partial support for Docker 1.12 (ongoing)
• Support for Windows (experimental)
• Support for building without OpenSSL
• Support for finding and connection to the daemon using the same DOCKER_HOST, DOCKER_CERT_PATH, etc. variables as the docker command line tool
• Consistent error-handling via error-chain

This library is used by the development tool cage to talk to the Docker daemon. You're welcome to use it for other things, and we're happy to accept pull requests!

(Also, the maintainers of rust-docker are totally welcome to use any code that they like from this fork. We're mostly maintaining this as a fork so that we can have very quick turnaround times when we need to fix an issue with cage, and we have no objections to this code being merged back upstream.)

Examples

For example code, see the examples directory.

OpenSSL

On the Mac, you can set up OpenSSL as follows:

brew install openssl
brew link --force openssl

export OPENSSL_INCLUDE_DIR=/usr/local/opt/openssl/include
export OPENSSL_ROOT_DIR=/usr/local/opt/openssl

Alternatively, you can build without OpenSSL by passing --no-default-features to cargo, or specifying default-features = false in a Cargo.toml file.

Contributing

1. Fork it
2. Create your a new remote upstream repository (git remote add upstream [email protected]:faradayio/boondock.git)
3. Commit your changes (git commit -m 'Add some feature')
4. Push to the branch (git push origin your-branch)
5. Create new Pull Request