Docker::Porcelain

Porcelain for the Docker API.

Installation

Add this line to your application’s Gemfile:

ruby gem 'docker-porcelain'

And then execute:

$ bundle

Or install it yourself as:

$ gem install docker-porcelain

Usage

There’s several styles of using docker-porcelain:

Monkey-patching (AKA global extensions)

Recommended for application code unless it causes problems.

```ruby require ‘docker/porcelain/extensions’

container = Docker::Container.create ‘Image’ => ‘alpine’ container.write ‘/tmp/foo’, ‘This is the foo file!’ ```

Note this will monkey patch docker-api classes, which might not be what you want (especially in a library).

Object extensions

You can extend individual objects (recommended for library code):

```ruby require ‘docker/porcelain’

container = Docker::Container.create ‘Image’ => ‘alpine’ container.extend Docker::Porcelain::Container container.write ‘/tmp/foo’, ‘This is the foo file!’ ```

Refinements

Not recommended, and it might not work as expected, but you can experiment:

```ruby require ‘docker/porcelain/refinements’

using Docker::Porcelain

container = Docker::Container.create ‘Image’ => ‘alpine’ container.write ‘/tmp/foo’, ‘This is the foo file!’ ```

Synopsis

```ruby container.write ‘/tmp/foo’, ‘This is the foo file!’ container.system ‘true’ or fail “there’s no truth in the container!” uptime = container.` ‘uptime’ container.delete! # force destroy

img = Docker::Image[‘image:tag’] # => #<Docker::Image:…> img.tags # => [‘image:tag’, ‘other:tag’] img.parent # => #<Docker::Image:…> img.tag ‘repo’, ‘tag’

Docker::Image.repository ‘image’ # => [#<Docker::Image:…>, …] ```

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake rspec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/conjurinc/docker-porcelain.

License

The gem is available as open source under the terms of the MIT License.