Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms


docker-platform (6) Versions 1.3.0

Use Docker ressources to install/configure Docker with attributes

cookbook 'docker-platform', '= 1.3.0'
cookbook 'docker-platform', '= 1.3.0', :supermarket
knife cookbook site install docker-platform
knife cookbook site download docker-platform
Quality 44%

Docker Platform Cookbook


Docker is an open-source project that automates the deployment of applications inside software containers, by providing an additional layer of abstraction and automation of operating-system-level virtualisation on Linux. Docker uses the resource isolation features of the Linux kernel such as cgroups and kernel namespaces, and a union-capable file system such as aufs and others to allow independent "containers" to run within a single Linux instance, avoiding the overhead of starting and maintaining virtual machines.

This cookbook provides recipes to install and configure Docker with configuration stored in attributes. It wraps docker cookbook resources to control Docker status and also provides resources to manager swarm cluster creation and volumes deployment.


Cookbooks and gems

Declared in metadata.rb and in Gemfile.


  • RHEL Family 7, tested on Centos

Note: by composing it with apt-docker cookbook, it should work fine on Debian / Ubuntu.



This cookbook is fully tested in test-kitchen, using the vagrant driver and serverspec verifier.

For more information, see .kitchen.yml and test directory.


Configuration is done by overriding default attributes. All configuration keys have a default defined in attributes/default.rb. Please read it to have a comprehensive view of what and how you can configure this cookbook behavior.

In addition, you can use attributes to define docker cookbook resources. All you have to do is to define an attribute of the same name as the resource you want to call containing the different instances of this resource. For instance:

"docker_volume": {
  "data": {
    "action": "create"
  "to_remove": {
    "action": "remove"

It creates a docker volume named data and remove the one called to_remove. The key of each sub hash table is the name attribute and the value is an hash table containing the resource configuration, mapping exactly the attribute name defined in docker cookbook documentation.

If you need multiple arguments for an attribute, you have to declare them in an array. If you need an array as single argument, add an extra array.

For instance:

"docker_container": {
  "my_alpine": {
    "container_name": "alpine",
    "repo": "alpine",
    "volumes": [["data:/data"]],
    "action": "run",
    "subscribes": ["redeploy", "docker_image[alpine]", "immediately"]

You can find other examples in .kitchen.yml file.



Include repository, package, service and docker recipes.


Configure and install official docker yum repository.


Install docker-engine package or upgrade it if attribute version is set to latest.


Enable and start docker service. Restart it if systemd config was updated.


Wrap all docker cookbook resources so it is possible to use them with attributes. Read attributes section for more details.


Create '/root/.docker/config.json' with authentication info declared in docker\_registry attributes. In other work, make registries login permanent.


Use cluster-search cookbook to determine which node should create and initialize the swarm.

Use docker_platform_swarm resource of the cookbook to initialize or join a swarm. See .kitchen.yml for examples.

Use docker_platform_service resource of the cookbook to create a service on a swarm manager.

The swarm will be initialized on predefined node using the cluster-search cookbook. The node id returned by cluster-search should be equal to the node['docker-platform']['initiator_id'] attribute.

The swarm join token is set in a consul backend after swarm initialization.

You need a consul cluster. This is not in the scope of this cookbook but if you need one, you should consider using Consul Platform.

Use cluster-search cookbook to determine consul cluster addresses. The join token will be requested by nodes before joining the swarm.



For instance:

Initialize a swarm and store token on consul:

"docker_platform": {
  "swarm": {
    "consul": {
      "hosts": "consul-swarm-host"
    "options": {
      "listen_addr": "",
      "action": "create"

Join an existing docker swarm with token stored on consul:

"docker_platform": {
  "swarm": {
    "consul": {
      "hosts": "consul-swarm-host"
    "action": ["join"]

Deploy 5 replicas of redis image on a docker swarm:

"docker_platform": {
  "services": {
    "redis": {
      "action": "create",
      "replicas": 5,
      "image": "redis:latest"


Available in


Please read carefully before making a merge request.

License and Author

Copyright (c) 2016-2017 Sam4Mobile, 2017

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

docker >= 0.0.0
cluster-search >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.




  • feat: add partial override of unit as default
    • You can override systemd unit of docker in two way:
    • merge (default), configure just the keys you want to add/modify
    • full, replace packaged unit completely
    • WARN: Before this patch, only full was available. By using merge as default, this introduces a potential breaking change.
  • feat: create auth file for registry attributes
    • Create '/root/.docker/config.json' with authentication info specified in 'docker_registry' attributes.
  • feat: update pkg & repo info to get latest version
    • Docker repositories and package name change after the 17.05 version. This patch updates the default info and allows a better configuration.
  • feat: monkey patches docker to fix ip_address bug
    • ip_address value is not returned correctly by load_current_value. This causes the resource to run each time, destroying and restarting containers with fixed ip at each run.
    • This patch monkey-patches docker cookbook to fix this bug. When the bug will be resolved upstream, a warning will be outputted.


  • fix: use new_resource prefix in swarm resource



  • feat(swarm): get managers from search
    • Nodes are separated in two roles, managers and workers:
    • managers are found by a search on a role
    • workers are the other nodes
    • Upload to consul both manager and worker token
  • feat: remove the need to define an initiator
    • Before this version, an initiator would have to be defined to perform all swarm admin action like init, network, etc. By using Consul and its distributed lock feature, we remove the need to set an initiator: admin ops can be done by any manager
    • Also fixes many other problems, basically because the initiator was a SPOF:
    • the rejoin of a previously initiator (which was trying to recreate a cluster)
    • the join of any node if the initiator was down (because all nodes tried to join by contacting the initiator)
  • refactor: add swarm in default, refact resources
    • Set swarm recipe in default recipe, before calling docker cookbook resources. Add a flag "enabled?" (default to false) for stand-alone nodes.
  • remove network resource as it can be done by docker_network.
  • fix against latest version of diplomat (consul gem)
  • fix chef 13 when package_retries is nil (default)
  • refactor: move swarm config in consul to swarm sub-key
  • fix #1: wait for docker to be ready after start it
  • fix: merge init_opts with join_opts for swarm init


  • use most recent image and add build_pull
  • fix consul config, improve errors output
  • reduce wait times and scaling requirement
  • add info while waiting, betting balancing
  • use .gitlab-ci.yml template [20170731]
  • use 3 manager nodes and 1 worker
  • check each node status in the cluster
  • separate test of standalone suite from swarm
  • check redis image after rebalancing


  • handover maintainance to, fix metadata
  • style: fix rubocop offenses: %i stuff
  • fix: move consul dependency to tests
  • fix(gemfile): add linter, force molinillo version
  • refactor: change wording, master to manager
  • style: fix indentation in .kitchen.yml
  • style(rubocop): fix heredoc delimiters
  • docs: use karma for git format in contributing


Add swarm creation support and service deployment by using custom resources


  • Fix versionning of package


  • Initial version for Centos 7

Collaborator Number Metric

1.3.0 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

1.3.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Foodcritic Metric

1.3.0 failed this metric

FC108: Resource should not define a property named 'name': docker-platform/resources/service.rb:18
Run with Foodcritic Version 12.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

License Metric

1.3.0 passed this metric

No Binaries Metric

1.3.0 passed this metric

Publish Metric

1.3.0 passed this metric

Supported Platforms Metric

1.3.0 passed this metric

Testing File Metric

1.3.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

1.3.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must include a tag that matches this cookbook version number