Installs/Configures Docker. Please see COMPATIBILITY.md for more information about Docker versions that are tested and supported by cookbook versions along with LWRP features.

This cookbook was inspired by @thoward's docker-cookbook: https://github.com/thoward/docker-cookbook

• Ubuntu 12.04
• Ubuntu 12.10
• Ubuntu 13.04

Opscode Cookbooks

• apt
• git

Third-Party Cookbooks

• golang
• lxc
• modules

These attributes are under the node['docker'] namespace.

These attributes are under the node['docker']['binary'] namespace.

These attributes are under the node['docker']['package'] namespace.

These attributes are under the node['docker']['source'] namespace.

• recipe[docker] Installs/Configures Docker
• recipe[docker::aufs] Installs/Loads AUFS Linux module
• recipe[docker::binary] Installs Docker binary
• recipe[docker::package] Installs Docker via package
• recipe[docker::source] Installs Docker via source
• recipe[docker::upstart] Installs/Starts Docker via Upstart

Run a container:

docker_container "busybox" do
  command "sleep 9999"
  detach true
end

Stop a running container:

docker_container "busybox" do
  command "sleep 9999"
  action :stop
end

Start a stopped container:

docker_container "busybox" do
  command "sleep 9999"
  action :start
end

Restart a container:

docker_container "busybox" do
  command "sleep 9999"
  action :restart
end

Remove a container:

docker_container "busybox" do
  command "sleep 9999"
  action :remove
end

Pull latest image:

docker_image "busybox"

Pull tagged image:

docker_image "bflad/test" do
  tag "not-latest"
end

Remove image:

docker_image "busybox" do
  action :remove
end

• Add recipe[docker] to your node's run list

Here's how you can quickly get testing or developing against the cookbook thanks to Vagrant and Berkshelf.

vagrant plugin install vagrant-berkshelf
vagrant plugin install vagrant-omnibus
git clone git://github.com/bflad/chef-docker.git
cd chef-docker
vagrant up BOX # BOX being ubuntu1204, ubuntu1210, or ubuntu1304

You can then SSH into the running VM using the vagrant ssh BOX command.

The VM can easily be stopped and deleted with the vagrant destroy command. Please see the official Vagrant documentation for a more in depth explanation of available commands.

Please see documentation in: TESTING.md

Please use standard Github issues/pull requests and if possible, in combination with testing on the Vagrant boxes or Test Kitchen suite.

• Brian Flad ([email protected])