Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 256 Commits
.travis		.travis
examples		examples
.gitignore		.gitignore
.travis.yml		.travis.yml
Dockerfile		Dockerfile
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
TODO.md		TODO.md
acl.go		acl.go
acl_test.go		acl_test.go
address_set.go		address_set.go
address_set_test.go		address_set_test.go
apis.go		apis.go
chassis.go		chassis.go
chassis_encap_test.go		chassis_encap_test.go
chassis_private.go		chassis_private.go
chassis_private_test.go		chassis_private_test.go
chassis_test.go		chassis_test.go
client.go		client.go
client_test.go		client_test.go
common.go		common.go
config.go		config.go
dhcp_options.go		dhcp_options.go
dhcp_options_test.go		dhcp_options_test.go
encap.go		encap.go
gateway_chassis.go		gateway_chassis.go
global_common.go		global_common.go
go.mod		go.mod
go.sum		go.sum
load_balancer.go		load_balancer.go
load_balancer_test.go		load_balancer_test.go
logical_router.go		logical_router.go
logical_router_load_balancer_test.go		logical_router_load_balancer_test.go
logical_router_policy.go		logical_router_policy.go
logical_router_policy_test.go		logical_router_policy_test.go
logical_router_port.go		logical_router_port.go
logical_router_port_test.go		logical_router_port_test.go
logical_router_static_route.go		logical_router_static_route.go
logical_router_static_route_test.go		logical_router_static_route_test.go
logical_router_test.go		logical_router_test.go
logical_switch.go		logical_switch.go
logical_switch_load_balancer_test.go		logical_switch_load_balancer_test.go
logical_switch_port.go		logical_switch_port.go
logical_switch_port_test.go		logical_switch_port_test.go
logical_switch_test.go		logical_switch_test.go
meter.go		meter.go
meter_test.go		meter_test.go
nat.go		nat.go
nat_test.go		nat_test.go
nb_global.go		nb_global.go
nb_global_test.go		nb_global_test.go
ovnimp.go		ovnimp.go
ovnimp_test.go		ovnimp_test.go
ovnnotify.go		ovnnotify.go
port_group.go		port_group.go
port_group_test.go		port_group_test.go
qos.go		qos.go
qos_test.go		qos_test.go
sb_global.go		sb_global.go
sb_global_test.go		sb_global_test.go
test_common.go		test_common.go
uuid.go		uuid.go

Repository files navigation

GO OVN

A Go library for OVN DB access using native OVSDB protocol.It is based on theOVSDB Library, but used own forkhttps://github.com/ebay/libovsdb.git with patches.

What is OVN?

OVN (Open Virtual Network) is a SDN solution built on top of OVS (Open vSwitch).The interface of OVN is its northbound DB which is an OVSDB database.

What is OVSDB?

OVSDB is a protocol for managing the configuration of OVS.It's defined inRFC 7047.

Why native OVSDB protocol?

There are projects accessing OVN DB based on the ovn-nbctl/sbctl CLI, which has someproblems. Here are the majors ones and how native OVSDB protocol based approachsolves them:

Performance problem. Every CLI command would trigger a separate OVSDB connection setup/teardown,initial OVSDB client cache population, etc., which would impact performance significantly. Thislibrary uses OVSDB protocol directly so that the overhead happens only once for all OVSDB operations.
Caching problem. When there is a change in desired state, which requires updates in OVN, we needto figure out first what's the current state in OVN, which requires either maintaining a clientcache or executing a "list" command everytime. This library maintains an internal cache and ensuresit is always up to date with the remote DB with the help of native OVSDB support.
String parsing problem. CLI based implementation needs extra conversion from the string outputto Go internal data types, while it is not necessary with this library since OVSDB JSON RPC takescare of it.