diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/sources/evpn.md | 206 |
1 files changed, 199 insertions, 7 deletions
diff --git a/docs/sources/evpn.md b/docs/sources/evpn.md index f4e6ee07..2ae75c68 100644 --- a/docs/sources/evpn.md +++ b/docs/sources/evpn.md @@ -1,17 +1,24 @@ # Ethernet VPN (EVPN) This page explains an configuration for EVPN. Note that the feature is -still very experimental. This example uses [BaGPipe -BGP](https://github.com/Orange-OpenSource/bagpipe-bgp), which only OSS -BGP implementation supporting EVPN as far as we know. GoBGP receives -routes from one BaGPipe peer and advertises it to another BaGPipe -peer. +still very experimental. + +## Contents + +- [BaGpipe](#bagpipe) +- [YABGP](#yabgp) + +## <a name="bagpipe"> BaGPipe + +This example uses [BaGPipe +BGP](https://github.com/Orange-OpenSource/bagpipe-bgp). GoBGP receives +routes from one BaGPipe peer and advertises it to another BaGPipe peer. If you don't want to install [BaGPipe BGP](https://github.com/Orange-OpenSource/bagpipe-bgp) by hand, you can use [Our BaGPipe BGP Docker image](https://registry.hub.docker.com/u/yoshima/bagpipe-bgp/). -## Configuration +### Configuration BaGPipe supports only iBGP. GoBGP peer connects to two BaGPipe peers. Two BaGPipe peers are not connected. It's incorrect from the @@ -65,7 +72,7 @@ dataplane_driver = DummyDataplaneDriver ``` 10.0.255.254 is GoBGP peer's address. -## Advertising EVPN route +### Advertising EVPN route As you expect, the RIBs at 10.0.255.2 peer has nothing. @@ -106,3 +113,188 @@ match:L2VPN/evpn,*: route_targets: * target:65000:77 ``` + +## <a name="yabgp"> YABGP + +Just like the last example, this example uses [YABGP](https://github.com/smartbgp/yabgp). GoBGP receives +routes from one YABGP peer and advertises it to another YABGP peer. + +### Configuration + +Gobgp configuration: + +```toml +[global.config] +as = 100 +router-id = "192.168.1.2" +local-address-list = ["10.79.45.72"] + +[[neighbors]] +[neighbors.config] +neighbor-address = "10.75.44.10" +peer-as = 300 +[[neighbors.afi-safis]] +[neighbors.afi-safis.config] +afi-safi-name = "l2vpn-evpn" +[neighbors.transport.config] +local-address = "10.79.45.72" +[neighbors.ebgp-multihop.config] +enabled = true + +[[neighbors]] +[neighbors.config] +neighbor-address = "10.75.44.11" +peer-as = 200 +[[neighbors.afi-safis]] +[neighbors.afi-safis.config] +afi-safi-name = "l2vpn-evpn" +[neighbors.transport.config] +local-address = "10.79.45.72" +[neighbors.ebgp-multihop.config] +enabled = true +``` + +`10.75.44.10` and `10.75.44.11` is the address of YABGP peers. We start two YABGP agents like this: + +```bash +python yabgp/bin/yabgpd --bgp-local_as=300 --bgp-remote_addr=10.79.45.72 --bgp-remote_as=100 --bgp-local_addr=10.75.44.10 --bgp-afi_safi=evpn +``` +``` bash +python yabgp/bin/yabgpd --bgp-local_as=200 --bgp-remote_addr=10.79.45.72 --bgp-remote_as=100 --bgp-local_addr=10.75.44.11 --bgp-afi_safi=evpn +``` + +From gobgp CMD: + +``` bash +$ gobgp neighbor +Peer AS Up/Down State |#Advertised Received Accepted +10.75.44.10 300 00:01:23 Establ | 0 0 0 +10.75.44.11 200 00:02:26 Establ | 0 0 0 +``` + +### Advertising EVPN route + +We can advertise EVPN routes from YABGP 10.75.44.11 through its REST API, +the `Authorization` header is `admin/admin`, and the `Content-Type` is `application/json`. + +``` bash +POST http://10.75.44.11:8801/v1/peer/10.79.45.72/send/update +``` + + +We will run this API four times, each time's POST data is: + +EVPN type 1: + +``` json +{ + "attr":{ + "1": 0, + "2": [], + "5": 100, + "14": { + "afi_safi": [25, 70], + "nexthop": "10.75.44.254", + "nlri": [{ + "type": 1, + "value": { + "rd": "1.1.1.1:32867", + "esi": 0, + "eth_tag_id": 100, + "label": [10] + } + }]}, + "16":[[1537, 0, 500]] +}} +``` + +EVPN type 2: + +``` json +{ + "attr":{ + "1": 0, + "2": [], + "5": 100, + "14": { + "afi_safi": [25, 70], + "nexthop": "10.75.44.254", + "nlri": [ + { + "type": 2, + "value": { + "eth_tag_id": 108, + "ip": "11.11.11.1", + "label": [0], + "rd": "172.17.0.3:2", + "mac": "00-11-22-33-44-55", + "esi": 0}}]}, + "16":[[1536, 1, 500]] +}} +``` + +EVPN type 3: + +``` json +{ + "attr":{ + "1": 0, + "2": [], + "5": 100, + "14": { + "afi_safi": [25, 70], + "nexthop": "10.75.44.254", + "nlri": [ + { + "type": 3, + "value": { + "rd": "172.16.0.1:5904", + "eth_tag_id": 100, + "ip": "192.168.0.1" + } + } + ] + } +}} +``` +EVPN type 4: + +``` json +{ + "attr":{ + "1": 0, + "2": [], + "5": 100, + "14": { + "afi_safi": [25, 70], + "nexthop": "10.75.44.254", + "nlri": [ + { + "type": 4, + "value": { + "rd": "172.16.0.1:8888", + "esi": 0, + "ip": "192.168.0.1" + } + } + ] + }, + "16":[[1538, "00-11-22-33-44-55"]] +}} +``` +GoBGP will received these four routes and readvertise them to peer 10.75.44.10 + +``` bash +$ gobgp monitor adj-in +[ROUTE] [type:A-D][rd:1.1.1.1:32867][esi:single-homed][etag:100][label:161] via 10.75.44.254 aspath [] attrs [{Extcomms: [esi-label: 8001]} {Origin: i} {LocalPref: 100}] +[ROUTE] [type:macadv][rd:172.17.0.3:2][esi:single-homed][etag:108][mac:00:11:22:33:44:55][ip:11.11.11.1][labels:[0]] via 10.75.44.254 aspath [] attrs [{Extcomms: [mac-mobility: 500, sticky]} {Origin: i} {LocalPref: 100}] +[ROUTE] [type:multicast][rd:172.16.0.1:5904][etag:100][ip:192.168.0.1] via 10.75.44.254 aspath [] attrs [{Origin: i} {LocalPref: 100}] +[ROUTE] [type:esi][rd:172.16.0.1:8888][esi:{0 [0 0 0 0 0 0 0 0 0]}][ip:192.168.0.1] via 10.75.44.254 aspath [] attrs [{Extcomms: [es-import rt: 00:11:22:33:44:55]} {Origin: i} {LocalPref: 100}] +``` + +``` bash +$ gobgp neighbor +Peer AS Up/Down State |#Advertised Received Accepted +10.75.44.10 300 00:21:00 Establ | 4 0 0 +10.75.44.11 200 00:22:03 Establ | 0 4 4 +``` |