Kubernetes CNI plugin based on the FD.io VPP
Clone or download
Latest commit 5ff9fd3 Dec 18, 2018

README.md

Contiv - VPP

Build Status Coverage Status Go Report Card GoDoc GitHub license

This Kubernetes network plugin uses FD.io VPP to provide network connectivity between PODs. Currently, only Kubernetes 1.9.X and higher versions are supported.

Quickstart

You can get started with Contiv-VPP in one of two ways:

  • Use the Contiv-VPP Vagrant Installation instructions to start a simulated Kubernetes cluster with a couple of hosts running in VirtualBox VMs. This is the easiest way to bring up a cluster for exploring the capabilities and features of Contiv-VPP.

  • Use the Contiv-specific kubeadm install instructions to manually install Kubernetes with Contiv-VPP networking on one or more bare-metal

  • Use the Arm64-specific kubeadm install instructions to manually install Kubernetes with Contiv-VPP networking on one or more bare-metal of Arm64 platform.

Configuration & Troubleshooting

Please refer to the Contiv-VPP configuration and troubleshooting document.

Reporting Bugs

In order to report a bug, please file an issue in GitHub. Please provide the information described in Bug Reports README.

Communication Channels

Slack Channel: https://contivvpp.slack.com/

Contributing

Contributions to VPP-Agent are welcome. We use the standard pull request model. You can either pick an open issue and assign it to yourself or open a new issue and discuss your feature.

In any case, before submitting your pull request please check the Coding style and cover the newly added code with tests and documentation (Contiv-VPP adopted the coding style used in the Ligato project). Upon submission, each patch is run through the go fmt and golint tools.

The tool used for managing third-party dependencies is Dep. After adding or updating a dependency in Gopkg.toml run make install-dep to download the specified dependencies into the vendor folder. Please make sure that each dependency in the Gopkg.toml has a specific version defined (a specific commit ID or a git tag).