README
¶
gopher-net
A collection of routing daemons written in Go.
Configure and Run
The packet library for the bgp portion uses the great work from the osrg monitoring bgp implementation along with the config options. This enables speaker initiation and ephemeral route caching. Still needs lots of work, feel free to run with any pieces of it. Also need a Dijkstra algorithm to be implemented (e.g. OSPF, ISIS best path selection).
This project isn't affiliated w/ any company, just network nerds hacking on prototypes using routing protocols in Go.
You can either define peers using the sample configuration in the root ./bgpd.conf or add the neighbor using the API listed below.
Run w/ sudo privileges or as root in order to bind to 179
sudo -E go run main.go -f bgpd.conf
To run with the logs set to debug use:
sudo -E go run main.go -f bgpd.conf -l debug
You can point two bgpd.go processes at one another or run against Quagga.
Example API usage
A Postman import is located in the ./api directory.
curl -i -X GET http://127.0.0.1:8080/v1/bgp/neighbor/172.16.86.134
curl -i -X GET http://172.16.86.135:8080/v1/bgp/routes
curl -i -X GET http://127.0.0.1:8080/v1/bgp/routes
curl -i -X GET http://127.0.0.1:8080/v1/bgp/neighbor/172.16.86.134/local-rib
curl -i -X GET http://127.0.0.1:8080/v1/bgp/routes/local-rib
curl -i -X GET http://172.16.86.1:8080/v1/bgp/routes/routes-in
curl -i -X GET http://127.0.0.1:8080/v1/bgp/routes/routes-out
curl -X "POST" "http://172.16.86.1:8080/v1/bgp/routes/add" \
-d $'{
"ip_prefix": "1.1.1.1",
"ip_nexthop": "172.16.86.13",
"ip_mask": 32,
"source_as": 7675,
"route_family": "RF_IPv4_UC"
}'
curl -X "POST" "http://172.16.86.135:8080/v1/bgp/routes/add" \
-d $'{
"ip_prefix": "2.2.2.2",
"ip_nexthop": "172.16.86.13",
"ip_mask": 32,
"source_as": 7675,
"route_family": "RF_IPv4_UC"
}'
curl -X "POST" "http://172.16.86.135:8080/v1/bgp/routes/add" \
-d $'{
"ip_prefix": "2.2.2.2",
"ip_nexthop": "172.16.86.13",
"ip_mask": 32,
"source_as": 7675,
"extended_community": "POLICY"
}'
There is a race condition bug here that will blow up the FSM in some cases :)
curl -X "POST" "http://127.0.0.1:8080/v1/bgp/neighbor/add" \
-d $'{
"neighbor_as":7675,
"neighbor_ip":"172.16.86.135"
}'
curl -X "POST" "http://127.0.0.1:8080/v1/bgp/neighbor/add" \
-d $'{
"neighbor_as":7675,
"neighbor_ip":"172.16.86.135"
}'
curl -X "POST" "http://172.16.86.1:8080/v1/bgp/routes/add" \
-d $'{
"ip_prefix": "2.2.2.2",
"ip_nexthop": "172.16.86.13",
"ip_mask": 32,
"source_as": 7675,
"route_family": "RF_IPv4_UC"
}'
BGP Prefix Update Events and BGP Node Events
These callbacks are located in bgp_event_callbacks.go as an example of how to get notified of a new prefix (or MAC if we get around to evpn etc) or even opaque community strings eventually would be cool. This could be a new VM, new container or anything else being advertised in BGP updates. Would ideally be migrated to an interface watch pub/sub as for a more decoupled update notification.
A New Node/Neighbor goes into an Established BGP FSM state. This means its ready to send and receive prefix (container updates).
INFO[0001] Container Event: New Neighbor Added
INFO[0001] Container Event: Established Neighbor IP address -> [ 7675 ]
INFO[0001] Container Event: Established Neighbor IP address -> [ 172.16.86.134 ]
INFO[0001] Container Event: Established Neighbor FSM State -> [ BGP_FSM_ESTABLISHED ]
An existing Node/Neighbor is no longer in an Established BGP FSM state. This means it is no longer receiving prefix (container) updates.
INFO[0163] Container Event: Neighbor Removed (FSM Idle)
INFO[0163] Container Event: Idle Neighbor IP address -> [ 7675 ]
INFO[0163] Container Event: Neighbor Removed Idle Neighbor IP address -> [ [ 172.16.86.134 ] ]
New Prefix/Containers are updated. A forwarding entry needs to be added to a TEP for the new Prefix using the route.GetNexthop() value as the destination TEP.
INFO[0002] Container Event: Route Added Notification
INFO[0002] Container Event: Prefix Added: -> [ 10.201.108.0/24 ]
INFO[0002] Container Event: Prefix Nexthop: -> [ 172.16.86.134 ]
INFO[0002] Container Event: All NLRI:
[
{
"Network": "10.201.108.0/24",
"Nexthop": "172.16.86.134",
"Attrs": [
{
"Type": "BGP_ATTR_TYPE_ORIGIN",
"Value": 0
},
{
"Type": "BGP_ATTR_TYPE_AS_PATH",
"AsPath": [
]
},
{
"Type": "BGP_ATTR_TYPE_NEXT_HOP",
"Nexthop": "172.16.86.134"
},
{
"Type": "BGP_ATTR_TYPE_MULTI_EXIT_DISC",
"Metric": 0
},
{
"Type": "BGP_ATTR_TYPE_LOCAL_PREF",
"Pref": 100
}
],
"Best": "false"
}
]
Existing Prefix/Containers are Withdrawn/Removed from the BGP tables. Existing entries needs to be removed for the Prefix
INFO[0065] Container Event: Route Added Notification
INFO[0065] Container Event: Prefix Added: -> [ 10.205.222.5/32 ]
INFO[0065] Container Event: Prefix Nexthop: -> [ <nil> ]
INFO[0065] Container Event: All NLRI:
[
{
"Network": "10.205.222.5/32",
"Nexthop": "\u003cnil\u003e",
"Attrs": null,
"Best": "false"
}
]
## Running the tests
To run only unit tests:
make test
Dependency Management
We use godep for dependency management with rewritten import paths.
This allows the repo to be go getable.
To bump the version of a dependency, follow these instructions
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Godeps
|
|
|
_workspace/src/code.google.com/p/gcfg
Package gcfg reads "INI-style" text-based configuration files with "name=value" pairs grouped into sections (gcfg files).
|
Package gcfg reads "INI-style" text-based configuration files with "name=value" pairs grouped into sections (gcfg files). |
|
_workspace/src/code.google.com/p/gcfg/scanner
Package scanner implements a scanner for gcfg configuration text.
|
Package scanner implements a scanner for gcfg configuration text. |
|
_workspace/src/code.google.com/p/gcfg/token
Package token defines constants representing the lexical tokens of the gcfg configuration syntax and basic operations on tokens (printing, predicates).
|
Package token defines constants representing the lexical tokens of the gcfg configuration syntax and basic operations on tokens (printing, predicates). |
|
_workspace/src/code.google.com/p/gcfg/types
Package types defines helpers for type conversions.
|
Package types defines helpers for type conversions. |
|
_workspace/src/github.com/dmcgowan/go/codec
High Performance, Feature-Rich Idiomatic Go encoding library for msgpack and binc .
|
High Performance, Feature-Rich Idiomatic Go encoding library for msgpack and binc . |
|
_workspace/src/github.com/docker/libchan/spdy
Package spdy provides a libchan implementation using spdy 3.
|
Package spdy provides a libchan implementation using spdy 3. |
|
_workspace/src/github.com/gorilla/context
Package context stores values shared during a request lifetime.
|
Package context stores values shared during a request lifetime. |
|
_workspace/src/github.com/gorilla/mux
Package gorilla/mux implements a request router and dispatcher.
|
Package gorilla/mux implements a request router and dispatcher. |
|
_workspace/src/github.com/jessevdk/go-flags
Package flags provides an extensive command line option parser.
|
Package flags provides an extensive command line option parser. |
|
_workspace/src/github.com/stretchr/testify/assert
A set of comprehensive testing tools for use with the normal Go testing system.
|
A set of comprehensive testing tools for use with the normal Go testing system. |
|
_workspace/src/gopkg.in/tomb.v2
The tomb package handles clean goroutine tracking and termination.
|
The tomb package handles clean goroutine tracking and termination. |
|
_workspace/src/gopkg.in/v1/yaml
Package yaml implements YAML support for the Go language.
|
Package yaml implements YAML support for the Go language. |
|
third-party
|
|