openstack
/
tricircle
Code Issues Proposed changes

Update README and setup description after splitting 

1. What is the problem?
After splitting, the Tricircle will be dedicated for
networking automation across Neutron, so the README.rst
and setup.cfg need to be updated

2. What is the solution to the problem?
Update README.rst and setup.cfg file in the github.

3. What the features need to be implemented to the Tricircle to realize
the solution?
No new features.

Change-Id: I92c525feb6ff059ae59e82b3f54fedd5f14789a5
Signed-off-by: joehuang <joehuang@huawei.com>
This commit is contained in:
joehuang 2016-09-22 23:29:27 -04:00 committed by Chaoyi Huang
parent 9d9c69ee48
commit 92bc914fc5
2 changed files with 29 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
README.rst
View File

@ -2,33 +2,40 @@
Tricircle Tricircle
========= =========
The Tricircle provides an OpenStack API gateway and networking automation The purpose of the Tricircle project is to provide networking automation
funtionality to allow multiple OpenStack instances, spanning in one site or across Neutron servers in multi-region OpenStack clouds deployment.
multiple sites or in hybrid cloud, to be managed as a single OpenStack cloud.
The Tricircle and these managed OpenStack instances will use shared KeyStone Each OpenStack cloud includes its own Nova, Cinder and Neutron, the Neutron
(with centralized or distributed deployment) or federated KeyStones for servers in these OpenStack clouds are called local Neuron servers, all these
identity management. local Neutron servers will be configured with the Tricircle Local Neutron
Plugin. A seperate Neutron server will be installed and run standalone as
the coordinator of networking automation across local Neutron servers, this
Neutron server will be configured with the Tricircle Central Neutron Plugin,
and is called central Neutron server.
The Tricircle presents one big region to the end user in KeyStone. And each Leverage the Tricircle Central Neutron Plugin and the Tricircle Local Neutron
OpenStack instance called a pod is a sub-region of the Tricircle in Plugin configured in these Neutron servers, the Tricircle can ensure the
KeyStone, and usually not visible to end user directly. IP address pool, IP/MAC address allocation and network segment allocation
being managed globally without conflict, and the Tricircle handles tenant
oriented data link layer(Layer2) or network layer(Layer3) networking
automation across local Neutron servers, resources like VMs, bare metal or
containers of the tenant can communicate with each other via Layer2 or Layer3,
no matter in which OpenStack cloud these resources are running on.
The Tricircle acts as OpenStack API gateway, can handle OpenStack API calls, Note: There are some our own definitions of Layer2/Layer3 networking
schedule one proper OpenStack instance if needed during the API calls handling, across Neutron. To make sure what they are, please read our design
forward the API calls to the appropriate OpenStack instance, and deal with documentation, especially "6.5 L2 Networking across Neutron". The wiki and
tenant level L2/L3 networking across OpenStack instances automatically. So it design documentation are linked below.
doesn't matter on which bottom OpenStack instance the VMs for the tenant are
running, they can communicate with each other via L2 or L3.
The end user can see avaialbility zone(AZ) and use AZ to provision The Tricircle and multi-region OpenStack clouds will use shared
VM, Volume, even Network through the Tricircle. One AZ can include many KeyStone(with centralized or distributed deployment) or federated KeyStones.
OpenStack instances, the Tricircle can schedule and bind OpenStack instance
for the tenant inside one AZ. A tenant's resources could be bound to multiple The Tricircle source code is distributed under the terms of the Apache
specific bottom OpenStack instances in one or multiple AZs automatically. License, Version 2.0. The full terms and conditions of this license are
detailed in the LICENSE file.
* Free software: Apache license * Free software: Apache license
* Design documentation: `Tricircle Design Blueprint <https://docs.google.com/document/d/18kZZ1snMOCD9IQvUKI5NVDzSASpw-QKj7l2zNqMEd3g/>`_ * Design documentation: `Tricircle Design Blueprint <https://docs.google.com/document/d/1zcxwl8xMEpxVCqLTce2-dUOtB-ObmzJTbV1uSQ6qTsY/>`_
* Wiki: https://wiki.openstack.org/wiki/tricircle * Wiki: https://wiki.openstack.org/wiki/tricircle
* Installation with DevStack: https://github.com/openstack/tricircle/blob/master/doc/source/installation.rst * Installation with DevStack: https://github.com/openstack/tricircle/blob/master/doc/source/installation.rst
* Tricircle Admin API documentation: https://github.com/openstack/tricircle/blob/master/doc/source/api_v1.rst * Tricircle Admin API documentation: https://github.com/openstack/tricircle/blob/master/doc/source/api_v1.rst

2
setup.cfg
View File

@ -1,6 +1,6 @@
[metadata] [metadata]
name = tricircle name = tricircle
summary = the Tricircle provides an OpenStack API gateway and networking automation to allow multiple OpenStack instances, spanning in one site or multiple sites or in hybrid cloud, to be managed as a single OpenStack cloud summary = The Tricircle is to provide networking automation across Neutron in multi-region OpenStack deployments.
description-file = README.rst description-file = README.rst
author = OpenStack author = OpenStack
author-email = openstack-dev@lists.openstack.org author-email = openstack-dev@lists.openstack.org