https://github.com/logingood/bagpipe-cni
CNI plugin for BaGPipe BGP
https://github.com/logingood/bagpipe-cni
bgp cni-plugin docker evpn kubernetes vxlan
Last synced: 4 months ago
JSON representation
CNI plugin for BaGPipe BGP
- Host: GitHub
- URL: https://github.com/logingood/bagpipe-cni
- Owner: logingood
- License: apache-2.0
- Created: 2016-04-18T03:45:38.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2016-05-26T06:17:31.000Z (about 10 years ago)
- Last Synced: 2024-06-20T12:07:25.907Z (almost 2 years ago)
- Topics: bgp, cni-plugin, docker, evpn, kubernetes, vxlan
- Language: Go
- Size: 307 KB
- Stars: 16
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BaGPipe BGP CNI plugin
## Overview
This plugins allows to confiure container networking with VXLAN and advertise container's network as VXLAN + IP + Mac object using EVPN BGP route.
You must have bagpipe-bgp installed on the host machine:
[BaGPipe BGP](https://github.com/Orange-OpenSource/bagpipe-bgp)
Probably have a route reflector (BGP router that supports AFI=25 SAFI=70) because bagpipe-bgp allows only to run two nodes without RR.
Nice example of go-based RR: [GoBGP](http://osrg.github.io/gobgp/) and EVPN lab example can be found here [EVPN with BaGPipe BGP and GoBGP RR](https://github.com/osrg/gobgp/blob/master/docs/sources/evpn.md)
## Install
### Option 1
Use go get:
````
go get github.com/murat1985/bagpipe-cni
````
package would be installed into your $GOBIN path, e.g.:
```
/usr/local/go/bin
```
Bare in mind if you are going to use it with Kubernetes plugin should reside in ```/opt/cni/bin```
### Option 2
The second way to install plugin altogether with other CNI plugins and IPAM plugins. Clone CNI repositority: [CNI](https://github.com/containernetworking/cni)
Make sure that GOPATH environment variable is set
```
cd $GOPATH
git clone https://github.com/containernetworking/cni
cd cni/plugins/main
```
Clone bagpipe CNI plugin into plugins/main/bagpipe
```
git clone https://github.com/murat1985/bagpipe-bgp bagpipe
cd ../../
```
Build plugins
```
./build
```
## Example configuration
Supported IP manager plugins:
* [host-local IP address manager](https://github.com/containernetworking/cni/tree/master/plugins/ipam/host-local)
* [consul IP address manager](https://github.com/murat1985/cni-ipam-consul)
Just put the example below in file /etc/cni/net.d/10-mynet.conf
```
{
"name": "mynet",
"type": "bagpipe",
"importrt": "64512:90",
"exportrt": "64512:90",
"isGateway": false,
"ipMasq": false,
"mtu": "1500",
"ipam": {
"type": "host-local",
"subnet": "10.1.2.0/24",
"routes": [
{ "dst": "0.0.0.0/0" }
]
}
}
```
## Network configuration reference
* `name` (string, required): the name of the network.
* `type` (string, required): "bagpipe".
* `importrt` (string, required): import community
* `exportrt` (string, required): export community
* `mtu` (integer, optional): explicitly set MTU to the specified value. Defaults to the value chosen by the kernel.
## Usage with Kubernetes
I have published a blog post, where described [PoC: BaGPipe CNI and Kubernetes](http://murat1985.github.io/kubernetes/cni/2016/05/15/kubernetes.html)
## Usage with Docker
Assuming that cni installed in the $GOPATH/cni and bagpipe CNI plugin is installed in plugins/main/bagpipe
docker-run.sh script could be found in scripts directory of [CNI](https://github.com/containernetworking/cni/blob/master/scripts/docker-run.sh) repository
```
cd $GOPATH/cni
CNI_PATH=`pwd`/bin
./build; cd scripts; CNI_PATH=$CNI_PATH ./docker-run.sh busybox ifconfig eth0 ; cd ..
```
Adding and Deleting of bagpipe tunnels along with container links fully implemented.
## Diagram
## TODO
1. GW allocation (relying on BaGPipe BGP as it is responsible to create a bridge and vxlan interfaces)