Romana is a new network and security automation solution for Cloud Native applications. Romana automates the creation of isolated Cloud Native Networks and secures applications with a distributed firewall that applies access control policies consistently across all endpoints and services, wherever they run.
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.
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, local Vagrant VMs, or user-provided ("static") hosts.
- Romana on AWS EC2 with Kubernetes
- Romana on AWS EC2 with Devstack
- Romana on Vagrant VMs with Kubernetes
- Romana on Vagrant VMs with Devstack
- Romana on User-Provided Hosts
See the romana-setup page for details about the installer and the full set of command-line options available.
If you wish to install Romana as a Kubernetes add-on using kubeadm, or use kops for installation on EC2, see the README file in the containerize directory.
Additional installation platforms are being targeted. You can express your interest in specific platforms or get help with manually installing Romana by contacting us.
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.
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.
- By email: info@romana.io
- Via our Romana developer mailing list
- Via our Romana user mailing list
- On the Romana Slack channel. Please note that you will need an invite for this channel. Please contact us by email to request an invite