cookbook 'flannel', '~> 1.1.1'
flannel (7) Versions 1.1.1 Follow0
A library cookbook to setup flanneld
cookbook 'flannel', '~> 1.1.1', :supermarket
knife supermarket install flannel
knife supermarket download flannel
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'smetadata.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
orlog_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](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](test/cookbooks/flannel_test/recipes/docker.rb).
License
Copyright 2016 Allan Espinosa
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
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
1.1.1
- Add documents and metadata to pass Supermarket quality metrics.
1.1.0
- Add etcdctl_options as a resource parameter.
1.0.0
- Move out etcd backend configuration to the
:configure
action.
0.3.1
- Mostly test and tooling enhancements.
- Fix problem of not invoking flanneld with the proper flags.
0.3.0
- Add resource properties to customize flanneld's invocation.
0.2.0
- Add
:start
action to launch flannel as a systemd service. - Provide helpers to parse the subnet file.
0.1.0
- Basic layout of the
flannel_service
resource. - A
:create
action to install flanneld.
Collaborator Number Metric
1.1.1 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
1.1.1 failed this metric
Foodcritic Metric
1.1.1 passed this metric
1.1.1 passed this metric
No Binaries Metric
1.1.1 passed this metric
1.1.1 passed this metric