Ansible deployment of the Kolla containers
Go to file
Rafael Weingärtner f425c0678f Standardize use and construction of endpoint URLs
The goal for this push request is to normalize the construction and use
 of internal, external, and admin URLs. While extending Kolla-ansible
 to enable a more flexible method to manage external URLs, we noticed
 that the same URL was constructed multiple times in different parts
 of the code. This can make it difficult for people that want to work
 with these URLs and create inconsistencies in a large code base with
 time. Therefore, we are proposing here the use of
 "single Kolla-ansible variable" per endpoint URL, which facilitates
 for people that are interested in overriding/extending these URLs.

As an example, we extended Kolla-ansible to facilitate the "override"
of public (external) URLs with the following standard
"<component/serviceName>.<companyBaseUrl>".
Therefore, the "NAT/redirect" in the SSL termination system (HAproxy,
HTTPD or some other) is done via the service name, and not by the port.
This allows operators to easily and automatically create more friendly
 URL names. To develop this feature, we first applied this patch that
 we are sending now to the community. We did that to reduce the surface
  of changes in Kolla-ansible.

Another example is the integration of Kolla-ansible and Consul, which
we also implemented internally, and also requires URLs changes.
Therefore, this PR is essential to reduce code duplicity, and to
facility users/developers to work/customize the services URLs.

Change-Id: I73d483e01476e779a5155b2e18dd5ea25f514e93
Signed-off-by: Rafael Weingärtner <rafael@apache.org>
2020-08-19 07:22:17 +00:00
ansible Standardize use and construction of endpoint URLs 2020-08-19 07:22:17 +00:00
contrib Update tacker CLI to openstack CLI in cleanup-tacker 2019-01-16 21:12:48 +08:00
deploy-guide/source Fix pygments style 2020-05-19 20:08:46 +02:00
doc Deploy neutron-mlnx-agent and neutron-eswitchd containers 2020-08-13 23:33:57 +01:00
etc/kolla Merge "Add Keep Alive Timeout for httpd" 2020-08-13 15:27:39 +00:00
kolla_ansible Merge "Fix kolla_address in IPv6 fully-routed topo case" 2020-08-01 04:14:34 +00:00
releasenotes Merge "Deploy neutron-mlnx-agent and neutron-eswitchd containers" 2020-08-17 19:02:45 +00:00
roles CI: Refactor VXLAN overlay setup 2020-02-20 12:24:05 +01:00
specs Adding support for multiple globals files 2020-06-18 17:33:51 +00:00
tests Merge "ubuntu: move to 20.04 Focal" 2020-08-11 15:26:39 +00:00
tools Merge "Performance: Run common role in a separate play" 2020-07-17 15:43:22 +00:00
zuul.d Merge "ubuntu: move to 20.04 Focal" 2020-08-11 15:26:39 +00:00
.ansible-lint CI: Add ansible-lint to tox 2020-05-17 17:02:38 +02:00
.gitignore Ignore .vscode/ in Git 2020-04-10 15:55:42 +02:00
.gitreview OpenDev Migration Patch 2019-04-19 19:29:02 +00:00
.stestr.conf Add custom filters for checking services 2019-09-16 12:48:52 +00:00
.yamllint Fix CI failures 2019-10-15 13:27:55 +01:00
bindep.txt CI: Remove dbus from bindep and playbooks 2020-02-20 16:50:43 +00:00
CONTRIBUTING.rst [Community goal] Update the contributor guide 2020-05-20 17:55:57 +02:00
LICENSE Add ASL license 2014-09-20 17:29:35 -07:00
lower-constraints.txt Remove mox3 from lower-constraints.txt 2020-06-23 10:04:46 +08:00
README.rst Remove the congress roles since it has been retired 2020-06-20 01:51:03 +00:00
requirements.txt Cleanup py27 support 2020-04-26 12:16:44 +02:00
setup.cfg Add py38 package metadata 2020-07-15 15:05:58 +08:00
setup.py Cleanup py27 support 2020-04-26 12:16:44 +02:00
test-requirements.txt Skip broken ansible-lint 2020-08-19 09:20:11 +02:00
tox.ini CI: Add ansible-lint to tox 2020-05-17 17:02:38 +02:00

Kolla-Ansible

image

The Kolla-Ansible is a deliverable project separated from Kolla project.

Kolla-Ansible deploys OpenStack services and infrastructure components in Docker containers.

Kolla's mission statement is:

To provide production-ready containers and deployment tools for operating
OpenStack clouds.

Kolla is highly opinionated out of the box, but allows for complete customization. This permits operators with little experience to deploy OpenStack quickly and as experience grows modify the OpenStack configuration to suit the operator's exact requirements.

Getting Started

Learn about Kolla-Ansible by reading the documentation online Kolla-Ansible.

Get started by reading the Developer Quickstart.

OpenStack services

Kolla-Ansible deploys containers for the following OpenStack projects:

Infrastructure components

Kolla-Ansible deploys containers for the following infrastructure components:

Directories

  • ansible - Contains Ansible playbooks to deploy OpenStack services and infrastructure components in Docker containers.
  • contrib - Contains demos scenarios for Heat, Magnum and Tacker and a development environment for Vagrant
  • doc - Contains documentation.
  • etc - Contains a reference etc directory structure which requires configuration of a small number of configuration variables to achieve a working All-in-One (AIO) deployment.
  • kolla_ansible - Contains password generation script.
  • releasenotes - Contains releasenote of all features added in Kolla-Ansible.
  • specs - Contains the Kolla-Ansible communities key arguments about architectural shifts in the code base.
  • tests - Contains functional testing tools.
  • tools - Contains tools for interacting with Kolla-Ansible.
  • zuul.d - Contains project gate job definitions.

Getting Involved

Need a feature? Find a bug? Let us know! Contributions are much appreciated and should follow the standard Gerrit workflow.

  • We communicate using the #openstack-kolla irc channel.
  • File bugs, blueprints, track releases, etc on Launchpad.
  • Attend weekly meetings.
  • Contribute code.

Contributors

Check out who's contributing code and contributing reviews.

Notices

Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. in the United States and/or other countries. Docker, Inc. and other parties may also have trademark rights in other terms used herein.