/romana

The Romana Project - Installation scripts, documentation, issue tracker and wiki. Start here.

Primary LanguageShellApache License 2.0Apache-2.0

The Romana Project

Romana is a new Software Defined Network solution specifically designed for Cloud Native applications. Romana allows multi-tenant cloud computing networks for OpenStack, Docker and Kubernetes to be built without encapsulation or a virtual network overlay.

Romana networks are less expensive to build, easier to operate and deliver higher performance than networks built using alternative overlay based SDN designs.

Code

This repository contains the installer and documentation. The Romana source code, however, is contained in these repositories:

  • core: A number of micro services written in Go, which comprise the core components of the Romana system.
  • kube: The Romana CNI plugin and Network Policy Agents for Kubernetes
  • networking-romana: The Romana ML2 plugin and IPAM driver for OpenStack

The READMEs of those repos contain more information about the source code and how to run and test it.

Installation

To get up and running with Romana, some scripts and Ansible playbooks have been provided to automate the setup and deployment. This can be used to set up a cluster for experimenting with Romana, exploring how it works and learning how it interacts with Kubernetes and/or Openstack.

The installer is currently capable of setting up a stand-alone Kubernetes or OpenStack-Devstack cluster. As deployment targets for those clusters, it supports Amazon EC2 or local Vagrant VMs.

Additional installation platforms are being targeted. You can express your interest in specific platforms or get help with manually installing Romana by contacting us.

Using Romana

Once you have Romana installed and running in a cluster, you might like to test its capabilities and see it in action. The two links below give you cluster specific suggestions of what to try and what to explore and look at.

Contact Us

There are a number of ways in which you can contact us if you have any questions about deploying or using Romana, or about contributing to our code.