Juniper/contrail

Name: contrail

Owner: Juniper Networks

Description: Contrail repo for core components (go based)

Created: 2017-12-05 17:09:07.0

Updated: 2018-03-31 22:40:11.0

Pushed: 2018-04-02 23:24:30.0

Homepage: null

Size: 36141

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

[POC] Go code base for Contrail projects

This repository holds Go implementation for Contrail projects. The goal of this project is to realize Go-based implementation & etcd based such as Kubernetes in order to improve performance, scale and ease operation.

We are planning to add following sub components.

• API Server ( python based VNC API Server equivalent)
• Sync (ifmap, rabbitMQ related code equivalent but depends on etcd)
• Agent (SchemaTransformer, Device Manager equivalent)
• Code generation tool (generateDS equivalent)

Currently, this project is POC stage so any external/internal API or design subject to change up to community discussion.

Development setup

Step1. Install Go and docker

• golang.org/doc/install
• docs.docker.com/install

Step2. Go get contrailutil

et -u github.com/Juniper/contrail/cmd/contrailutil

Note that go get -u github.com/Juniper/contrail fails because we don't commit generated code.

Step3. Install dependencies

 deps

Step4. Generate code

 generate

Step5. Install code

 install

Step6. Install test environment

tup testenv using docker
 testenv
u need wait db process up
 reset_db

Note that depending on your docker configuration you may need root permissions.

Try

• Run processes

  rail -c sample/contrail.yml run 
  

  Note that you can overwrite configuration parameters using environment variable with prefix “CONTRAIL_”

  For example CONTRAIL_DATABASE_DEBUG is overwriting database.debug value.

  RAIL_DATABASE_DEBUG=true contrail -c sample/contrail.yml process
  

• Run CLI

  rt CONTRAIL_CONFIG=sample/cli.yml
  ow Schema
  railcli schema virtual_network
  eate resources
  railcli sync sample/sample_resource.yml
  st resources
  railcli list virtual_network --detail
  lete resources
  railcli delete sample/sample_resource.yml
  

  For more cli command see CLI Usage,

Schema Files

Note that schema stored here is just a cache for helping development. Developers should make sure download latest schema from http://github.com/Juniper/contrail-api-client

JSON version stored in public/schema.json

Templates for code generation based on this schema are stored in tools/templates Template configuration You can add your template on template_config.yaml.

Testing

 test

You can print out full sql trace too.

RAIL_DATABASE_DEBUG=true make test

Commands

Repository holds source code for following CLI applications:

• contrail - contains API Server, Agent, Sync and API Server command line client
• contrailcli - contains API Server command line client
• contrailschema - code generator by schema definitions
• contrailutil - contains development utilities

Show possible commands of application:

rail -h

Show detailed information about specific command:

rail <command> -h

Keystone Support

API Server supports Keystone V3 authentication and RBAC. API Server has minimal Keystone API V3 support for standalone use case. See a configuration example

How to contribute

• Apply lint tools
• Follow best practices
• comply to Effective Go
• comply to Code review comments
• keep make lint output clean

We follow openstack way of review. https://docs.openstack.org/infra/manual/developers.html This is our review system. https://review.opencontrail.org

Step1.

Setup gerrit account. Sign CLA.

Step2.

Install git-review.

install git-review

Step3.

Send git review command.

review

Document

See docs folder.