flannel #450

Supports: xenial bionic
Add to new model

Description

it is a generic overlay network that can be used as a simple alternative to existing software defined networking solutions


Flannel Charm

Flannel is a virtual network that gives a subnet to each host for use with container runtimes.

This charm will deploy flannel as a background service, and configure CNI for use with flannel, on any principal charm that implements the kubernetes-cni interface.

Usage

The flannel charm is a subordinate. This charm will require a principal charm that implements the kubernetes-cni interface in order to properly deploy.

juju deploy flannel
juju deploy etcd
juju deploy kubernetes-master
juju deploy kubernetes-worker
juju add-relation flannel etcd
juju add-relation flannel kubernetes-master
juju add-relation flannel kubernetes-worker

Configuration

iface The interface to configure the flannel SDN binding. If this value is empty string or undefined the code will attempt to find the default network adapter similar to the following command:

route | grep default | head -n 1 | awk {'print $8'}

cidr The network range to configure the flannel SDN to declare when establishing networking setup with etcd. Ensure this network range is not active on the vlan you're deploying to, as it will cause collisions and odd behavior if care is not taken when selecting a good CIDR range to assign to flannel.

nagios_context A string that will be prepended to instance name to set the host name in nagios.If you're running multiple environments with the same services in them this allows you to differentiate between them. Used by the nrpe subordinate charm.

nagios_servicegroups The comma-separated list of servicegroups that the generated Nagios checks will belong to.

Known Limitations

This subordinate does not support being co-located with other deployments of the flannel subordinate (to gain 2 vlans on a single application). If you require this support please file a bug.

This subordinate also leverages juju-resources, so it is currently only available on juju 2.0+ controllers.

Further information


Configuration

cidr
(string) Network CIDR to assign to Flannel
10.1.0.0/16
iface
(string) The interface to bind flannel overlay networking. The default value is the interface bound to the cni endpoint.
nagios_context
(string) Used by the nrpe subordinate charms. A string that will be prepended to instance name to set the host name in nagios. So for instance the hostname would be something like: juju-myservice-0 If you're running multiple environments with the same services in them this allows you to differentiate between them.
juju
nagios_servicegroups
(string) A comma-separated list of nagios servicegroups. If left empty, the nagios_context will be used as the servicegroup