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/

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.