Merge pull request #419 from asridharan/cnitool

Added documentation for `cnitool`

Documentation: Added documentation for `cnitool`.

Added documentation to simplify the usage of `cnitool` and the
settings expected to be used with `cnitool`.

spec/plugins: fix 'ip'->'ips' in the spec, bump to 0.3.1

Minor rewording about default config version

docs: table formatting is hard

docs: fill-out and correct version conversion table

docs: minor improvements to spec-upgrades

docs: add small upgrade instructions

docs: minor improvements to 0.3.0 upgrade guidance

docs: Edits to v0.3.0 upgrade guidance

docs: CNI versioning for 0.3.0 upgrade

docs: consolidate host-local documentation

- remove the README.md in the plugins/ipam/host-local (no other plugin
  has this)
- merge that info into the main Documentation/host-local.md

ipam/host-local: add ResolvConf argument for DNS configuration

This adds the option `resolvConf` to the host-local IPAM configuration.
If specified, the plugin will try to parse the file as a resolv.conf(5)
type file and return it in the DNS response.

flannel: rename stateDir to dataDir

Rename StateDir to DataDir for flannel CNI plugin

flannel: update flannel documentation

add optional 'stateDir' to flannel docs

Update ipvlan.md

invalid json format

docs/ptp: fix markdown formatting

Merge pull request #267 from rosenhouse/version-cmd

Adds VERSION command

documentation: add description for forceAddress parameter

docs: fix tuning doc, correct the result json

it does not report the version, it never did

bridge: add isDefaultGateway field

When isDefaultGateway is true it automatically sets isGateway to true.
The default route will be added via the (bridge's) gateway IP.
If a default gateway has been configured via IPAM in the same
configuration file, the plugin will error out.

Merge pull request #175.

plugins/bridge: add support to set hairpin mode

*: appc/cni -> containernetworking/cni

The project has been moved so internally we simply rename everything.
Consumers are recommended to update their vendored version of cni.

*: appc/cni -> containernetworking/cni

The project has been moved so internally we simply rename everything.
Consumers are recommended to update their vendored version of cni.

new plugin: tuning

Allow users to tune net network parameters such as somaxconn.

With this patch, users can add a new network configuration:

> {
>   "name": "mytuning",
>   "type": "tuning",
>   "sysctl": {
>           "net.core.somaxconn": "500"
>   }
> }

The value /proc/sys/net/core/somaxconn will be set to 500 in the network
namespace but will remain unchanged on the host.

Only sysctl parameters that belong to the network subsystem can be
modified.

Related to: https://github.com/coreos/rkt/pull/2140

docs/ptp: update example and DNS description

*: add "dns" field to the configuration

appc/cni#76 added a "dns" field in the result JSON. But before this
patch, the plugins had no way of knowing which name server to return.

There could be two ways of knowing which name server to return:
1. add it as an extra argument ("CNI_ARGS")
2. add it in the network configuration as a convenience (received via
   stdin)

I chose the second way because it is easier. In the case of rkt, it
means the user could just add the DNS name servers in
/etc/rkt/net.d/mynetwork.conf.

flannel: doc fix and check for missing subnet.env fields

- Document that flannel outputs FLANNEL_NETWORK b/c we use it
- Check and error out if expecited fields are missing in subnetEnv file

Fixes #72

update ptp docs to reflect changes in plugin

host-local: allow ip request via CNI_ARGS

A specific IP can now be requested via the environment variable CNI_ARGS, e.g.
`CNI_ARGS=ip=1.2.3.4`.
The plugin will try to reserve the specified IP.
If this is not successful the execution will fail.

Fix a few spelling mistakes in the docs

Merge pull request #34 from eyakubovich/document-plugins

Document the plugins

Rename veth plugin to ptp and add docs.

ptp (point-to-point) better describes the nature of the plugin
as veth pairs are also used by the bridge plugin.

Document the plugins

Adds a .md file to the Documentation/ folder for each plugin.

Fixes #16

add flannel plugin

This introduces a notion of a "meta" plugin. A meta plugin
is one that delegates the actual work of setting up the interface
to the main plugin. The meta plugin is used to select and dynamically
configure the main plugin. The sequence of events, is as follows:

Given netconf like:

    {
"name": "mynet",
"type": "flannel",
"delegate": {
    "type": "bridge"
}
    }

flannel fills in values like "mtu", "ipam.subnet" and delegates to
"bridge" main plugin. "bridge" plugin will operate as usual, calling
into ipam module for IP assignment.

Delegate dictionary should not contain "name" field as it will be
filled in by the flannel plugin.