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

Select Status

RSS

swarm (4) Versions 0.2.1

Installs/Configures Docker Swarm

Policyfile
Berkshelf
Knife
cookbook 'swarm', '~> 0.2.1', :supermarket
cookbook 'swarm', '~> 0.2.1'
knife supermarket install swarm
knife supermarket download swarm
README
Dependencies
Changelog
Quality 33%

Swarm Cookbook

Chef cookbook for configuring Docker Swarm nodes.

Recipes

manager.rb

Runs a swarm container in "manage" mode

worker.rb

Runs a swarm container in "join" mode

service.rb

Uses the Docker cookbook resource to ensure that the Docker engine is installed and running

_image.rb

Pulls the swarm image only, not intended for direct use. See manager.rb and worker.rb

Attributes

See Docker docs for explanation of Swarm arguments: https://docs.docker.com/swarm/overview/

Attribute Default Value Description
['swarm']['swarm_version'] 'latest' Version of the Swarm container to use
['swarm']['image']['read_timeout'] 180 Timeout for image pull
['swarm']['discovery']['provider'] 'token' Swarm discovery provider type to use. Valid values are token, consul, etcd, zk, file
['swarm']['discovery']['token'] nil Discovery token to use, only used with provider "token"
['swarm']['discovery']['file_path'] nil Path to discovery file. Only used for provider "file"
['swarm']['discovery']['host'] nil Specify a host running the discovery service for the Swarm cluster. If not specified then a search will be run instead. Only used with provider "consul", "etcd" or "zk"
['swarm']['discovery']['port'] nil Specify a port for your discovery service. This can be used in combination with ['swarm']['discovery']['host'] or with search. It need not be used at all if your discovery provider is running on standard ports that can be inferrred from the protocol
['swarm']['discovery']['query'] "role:swarm-discovery AND chef_environment:#{node.chef_environment}" When a discovery host is not specified the cookbook will attempt to find a discovery provider using the specified query. Only used with provider "consul", "etcd" or "zk"
['swarm']['discovery']['path'] nil Path to append to the end of the key value store URL. Only used with provider "consul", "etcd" or "zk"
['swarm']['restart_policy'] 'on-failure' Swarm container restart policy
['swarm']['discovery_options'] [] Discovery options passed in to the swarm containers
['swarm']['manager']['bind'] '0.0.0.0'
['swarm']['manager']['port'] 3376
['swarm']['manager']['advertise'] node['ipaddress']
['swarm']['manager']['strategy'] 'spread'
['swarm']['manager']['replication'] false
['swarm']['manager']['replication_ttl'] '30s'
['swarm']['manager']['heartbeat'] nil
['swarm']['manager']['cluster_driver'] 'swarm'
['swarm']['manager']['cluster_options'] [] Cluster driver options
['swarm']['manager']['additional_options'] {} Hook for adding additional arguments to the swarm manage command. Specified as a Hash of argument names to values
['swarm']['worker']['advertise'] node['ipaddress']
['swarm']['worker']['ttl'] nil
['swarm']['worker']['heartbeat'] nil
['swarm']['worker']['delay'] nil
['swarm']['worker']['additional_options'] {} Hook for adding additional arguments to the swarm join command. Specified as a Hash of argument names to values

Usage

To create a managing node include swarm::manager in your node's run list
To create a worker node include swarm::worker in your node's run list

Both of the above recipes assume that the Docker engine will be installed and running.
swarm::service can be included if the engine is not managed through some other cookbook

Engine

A simple recipe is provided for installing and running the Docker engine. The recipe makes use of the docker\_service
resource provided by the Docker Cookbook. For advanced configuration
you can set up the engine within your own wrapper cookbook and only use the manager and worker recipes here

TLS

This cookbook makes no effort to manage certificates, instead the certs should be placed on the instance by your wrapper
cookbook. To enable TLS validation for your Swarm the appropriate arguments should be added to
['swarm']['manager']['additional_options']. See Docker's documentation for configuration details

License

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

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

docker ~> 2.6

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

0.2.1

  • Allow discovery port to be specified via attribute

0.2.0

  • Refactor image pull into it's own recipe

0.1.2

  • Add attribute for worker advertise address
  • Bind service to 0.0.0.0:2376
  • Additional testing and documentation

0.1.0

Inital release

Collaborator Number Metric
            

0.2.1 failed this metric

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

Contributing File Metric
            

0.2.1 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 https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Foodcritic Metric
            

0.2.1 failed this metric

FC066: Ensure chef_version is set in metadata: swarm/metadata.rb:1
FC069: Ensure standardized license defined in metadata: swarm/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric
            

0.2.1 passed this metric

Testing File Metric
            

0.2.1 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 https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

0.2.1 passed this metric