Contiv Installation for Docker Swarm & Kubernetes 1.4+

Install Contiv on your Docker Swarm or Kubernetes cluster.

Docker Swarm Installation

Prerequisites

CentOS 7.x operating system.
Python installed on the master and worker nodes.
Docker installed on the host where you are running the installer.
Install a Docker Swarm cluster in either legacy swarm mode or native swarm mode (requires 17.03+ version of Docker engine where swarm functionality is inbuilt). Alternatively, use the Contiv installer to setup docker and legacy swarm stack on cluster nodes.

Contiv Installation with Legacy Swarm Mode

The Contiv Docker Swarm installer is launched from a host external to the cluster. All the nodes must be accessible to the Contiv Ansible-based installer host through SSH.

Download the installer bundle:
curl -L -O https://github.com/contiv/install/releases/download/$VERSION/contiv-$VERSION.tgz
If your access to the Internet is limited or slow and you want to download the full Contiv install, choose
contiv-full-$VERSION.tgz
Note: The full image contains only Contiv components. Installing Docker Swarm will need Internet connectivity.
Extract the install bundle
tar oxf contiv-$VERSION.tgz.
Change directories to the extracted folder
cd contiv-$VERSION
To install Contiv with Docker Legacy Swarm:
./install/ansible/install_swarm.sh -f cfg.yml -e <ssh key> -u <username> -i
To install Contiv with Docker Legacy Swarm and ACI:
./install/ansible/install_swarm.sh -f aci_cfg.yml -e <ssh key> -u <username> -i -m aci
Example host config files are available at install/ansible/cfg.yml and install/ansible/aci_cfg.yml
To see additional install options and examples, run
./install/ansible/install_swarm.sh -h.

Contiv Installation with Native Swarm Mode

Docker swarm cluster must be already setup (see details). Installer only sets up Contiv v2plugin and dependencies. The Contiv installer can be run from a host in cluster itself.

Download the installer bundle:
curl -L -O https://github.com/contiv/install/releases/download/$VERSION/contiv-$VERSION.tgz
If your access to the Internet is limited or slow and you want to download the full Contiv install, choose
contiv-full-$VERSION.tgz
Note: The full image contains only Contiv components.
Extract the install bundle
tar oxf contiv-$VERSION.tgz.
Change directories to the extracted folder
cd contiv-$VERSION
To install Contiv v2plugin:
./install/ansible/install_swarm.sh -f cfg.yml -e <ssh key> -u <username> -p
Example host config files are available at install/ansible/cfg.yml and install/ansible/aci_cfg.yml
To see additional install options and examples, such as adding arguments to ansible for verbose output and proxy settings, run
./install/ansible/install_swarm.sh -h.

Removing Contiv

If you need to remove Contiv from Docker Swarm and return to your original state, you can uninstall Contiv with the following commands:

To uninstall Contiv and Docker Legacy Swarm:
./install/ansible/uninstall_swarm.sh -f cfg.yml -e <ssh key> -u <username> -i
To uninstall Contiv and Docker Legacy Swarm with ACI support:
./install/ansible/uninstall_swarm.sh -f aci_cfg.yml -e <ssh key> -u <username> -i -m aci
To uninstall Contiv and not Docker Legacy Swarm:
./install/ansible/uninstall_swarm.sh -f cfg.yml -e <ssh key> -u <username>
To uninstall Contiv v2plugin:
./install/ansible/uninstall_swarm.sh -f cfg.yml -e <ssh key> -u <username> -p
Note: Adding the -r flag, will cleanup any Contiv state.
To see additional install options and examples, such as adding arguments to ansible for verbose output and proxy settings, run
./install/ansible/uninstall_swarm.sh -h.

Kubernetes Installation

Prerequisites

Kubernetes 1.6.2+, and 1.8.4+ are supported with the following instructions.
CentOS 7.x operating system
Install Kubernetes:
1. kubeadm installs the latest Kubernetes version.
  For Kubernetes 1.6, see an example script here. For Kubernetes 1.8, see an example script here.
2. Replace step (3/4) in the kubeadm install guide with the following Contiv Installation Instructions. Contiv installation can be done after completing step (4/4).
3. Instructions to install Kubernetes are available here.