GoVPP

From fd.io
Jump to: navigation, search
GoVPP Facts

Project Lead:
Committers:

  • Jan Medved
  • Rastislav Szabo
  • Jozef Slezak
  • Keith Burns
  • Nikos Bregiannis

Repository: git clone https://gerrit.fd.io/r/govpp
Mailing List: govpp-dev@lists.fd.io
Jenkins: jenkins silo
Gerrit Patches: code patches/reviews
Bugs: GOVPP bugs

Intro

GoVPP is a Golang toolset for VPP management. It consists of a set of Golang packages that provide the API for VPP management based on the Go bindings generated from the VPP binary APIs. It can be used as the foundation for any VPP management/control plane written in Go.

Apart from the packages providing the API and tools allowing to write VPP management applications in Go from scratch, the project also aims to provide a cloud-native VPP management agent that can be used in VPP-based container infrastructure.

Project Contact Name and Email

Scope

GoVPP project scope:

  1. Go bindings generator:
    • generates Go structs from binary API definitions in JSON
    • annotates the generated Go bindings so they can be marshalled / unmarshalled to/from binary data as understood by VPP
  2. GoVPP API packages:
    • api: high-level API for communication with govpp core using Go channels
    • core: main functionality of the govpp, sends and receives the messages to/from VPP using the adapter, marshalls/unmarshalls them and forwards them between the client Go channels and the VPP
    • adapter: the adapter between the govpp core and the VPP, responsible for sending and receiving binary-encoded data via shared memory, leverages VPP pneum library
  3. Other code to ease the adoption of fd.io by Go users
  4. Supporting code:
    • examples
    • unit tests

Out of scope:

  1. Generator of JSON definitions of VPP binary APIs
  2. vppapiclient (former pneum) library used to send & receive binary-encoded data to/from VPP


Devel

  • Go-getting the code:
go get git.fd.io/govpp.git
  • Installing the binary API generator:
go install git.fd.io/govpp.git/cmd/binapi-generator
 //go:generate binapi_generator --input-file=/usr/share/vpp/api/vpe.api.json --output-dir=./bin_api
  • Auto-generated documentation on GoDoc