Flannel Cookbook

This is a library cookbook that provides resources for setting up flannel instances.

Requirements

Chef 12.5.0 or higher.
Network accessible web server hosting the flannel binaries.

Platform Support

Tested on the following platforms with test-kitchen:

debian-8.4
centos-7.2
ubuntu-16.04

Usage

Add depends 'flannel', '~> 0.3' to your cookbook's metadata.rb.
Use the resources shipped in this cookbook.

Custom Resources

flannel_service

flannel_service

Downloads pre-compiled Go binaries of flanneld onto disk.

The :create action downloads the pre-compiled go binary of flanneld onto disk.
The :configure action connects to etcd and loads the flanneld configuration to it.
The :start action runs flanneld as a systemd service

It has the following properties corresponding to flannel's commandline options

public_ip
etcd_endpoints
etcd_prefix
etcd_keyfile
etcd_certfile
etcd_cafile
iface
subnet_file
ip_masq
listen
remote
remote_keyfile
remote_certfile
networks
v or log_level

Another property called config corresponds to flannel's etcd-stored configuration

Additionally, if you are using TLS with etcd, you can pass extra options to the etcdctl tool using the etcdctl_options property

Helper

The libraries/subnet_parser.rb file extends the flannel_service resource to read and parse the subnet file. An example approach on integrating with the docker cookbook is found in test/cookbooks/flannel_test/recipes/docker.rb.