Ansible deployment of the Kolla containers
Go to file
Rafael Weingärtner 15f2fdcd5d Make setup module arguments configurable
Ansible facts can have a large impact on the performance of the Ansible
control host. This patch introduces some control over which facts are
gathered (kolla_ansible_setup_gather_subset) and which facts are stored
(kolla_ansible_setup_filter). By default we do not change the default
values of these arguments to the setup module. The flexibility of these
arguments is limited, but they do provide enough for a large performance
improvement in a typical moderate to large OpenStack cloud.

In particular, the large complex dict fact for each interface has a
large effect, and on an OpenStack controller or hypervisor there may be
many virtual interfaces. We can use the kolla_ansible_setup_filter
variable to help:

    kolla_ansible_setup_filter: 'ansible_[!qt]*'

This causes Ansible to collect but not store facts matching that
pattern, which includes the virtual interface facts. Currently we are
not referencing other facts matching the pattern within Kolla Ansible.
Note that including the 'ansible_' prefix causes meta facts module_setup
and gather_subset to be filtered, but this seems to be the only way to
get a good match on the interface facts. To work around this, we use
ansible_facts rather than module_setup to detect whether facts exist in
the cache.

The exact improvement will vary, but has been reported to be as large as
18x on systems with many virtual interfaces.

For reference, here are some other tunings tried:

* Increased the number of forks (great speedup depending of the size of
  the deployment)
* Use `strategy = mitogen_linear` (cut processing time in half)
* Ansible caching (little speed up)
* SSH tunning (little speed up)

Co-Authored-By: Mark Goddard <mark@stackhpc.com>
Closes-Bug: #1921538
Change-Id: Iae8ca4aae945892f1dc65e1b10381d2e26e88805
2021-07-02 10:30:35 -03:00
ansible Make setup module arguments configurable 2021-07-02 10:30:35 -03:00
contrib Update docs for Ubuntu 20.04 2020-11-20 08:40:36 +00:00
deploy-guide/source [docs] Unify project's naming convention 2021-01-27 20:08:41 +01:00
doc Make setup module arguments configurable 2021-07-02 10:30:35 -03:00
etc/kolla Make setup module arguments configurable 2021-07-02 10:30:35 -03:00
kolla_ansible Use ansible_facts to reference facts 2021-06-23 10:38:06 +01:00
releasenotes Make setup module arguments configurable 2021-07-02 10:30:35 -03:00
roles Merge "CI: fix backups Ceph pool name" 2021-07-01 17:57:44 +00:00
specs [docs] Unify project's naming convention 2021-01-27 20:08:41 +01:00
tests Merge "Update previous_release to Wallaby" 2021-07-01 10:31:44 +00:00
tools Merge "Support editable installation in all cases" 2021-06-17 09:13:43 +00:00
zuul.d Merge "Update previous_release to Wallaby" 2021-07-01 10:31:44 +00:00
.ansible-lint CI: Fix yamllint comments-indentation in .ansible-lint 2021-03-19 12:08:20 +01: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
README.rst Remove rally deployment 2021-06-16 09:12:34 +08:00
requirements.txt Cleanup py27 support 2020-04-26 12:16:44 +02:00
setup.cfg setup.cfg: Replace dashes with underscores 2021-05-05 10:01:15 +02:00
setup.py Cleanup py27 support 2020-04-26 12:16:44 +02:00
test-requirements.txt Bump up supported Ansible version to 2.10 2021-03-08 11:40:31 +00:00
tox.ini Merge "tox: Add find command to allowlist_externals list" 2021-06-17 08:43:30 +00: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.