Home OpenStack-Ansible Developer Documentation
The repository contains several helper scripts to manage gate jobs, install base requirements, and update repository information. Execute these scripts from the root of the repository clone. For example:
$ scripts/<script_name>.sh
The bootstrap-ansible.sh script installs Ansible including core and extras module repositories and Galaxy roles.
While there are several configurable environment variables which this script uses, the following are commonly used:
The script also creates the openstack-ansible wrapper tool that provides the variable files to match /etc/openstack_deploy/user_*.yml as arguments to ansible-playbook as a convenience.
The bootstrap-aio.sh script prepares a host for an All-In-One (AIO) deployment for the purposes of development and gating. The script creates the necessary partitions, directories, and configurations. The script can be configured using environment variables - more details are provided on the All-In-One page.
The run-playbooks script is designed to be executed in development and test environments and is also used for automated testing. It executes actions which are definitely not suitable for production environments and must therefore not be used for that purpose.
In order to scope the playbook execution there are several DEPLOY_ environment variables available near the top of the script. These are used by simply exporting an override before executing the script. For example, to skip the execution of the Ceilometer playbook, execute:
export DEPLOY_CEILOMETER='no'
The default MaxSessions setting for the OpenSSH Daemon is 10. Each Ansible fork makes use of a Session. By default Ansible sets the number of forks to 5, but the run-playbooks.sh script sets the number of forks used based on the number of CPU’s on the deployment host up to a maximum of 10.
If a developer wishes to increase the number of forks used when using this script, override the FORKS environment variable. For example:
export FORKS=20
The run-tempest.sh script runs Tempest tests from the first utility container. This is primarily used for automated gate testing, but may also be used through manual execution.
Configurable environment variables:
Python coding conventions are tested using PEP8, with the following convention exceptions:
Testing may be done locally by executing:
tox -e pep8
Bash coding conventions are tested using Bashate, with the following convention exceptions:
E003: Indent not multiple of 4. We prefer to use multiples of 2 instead.
and use jinja templating, this is very difficult to achieve. It is still considered a preference and should be a goal to improve readability, within reason.
as templates and use use jinja templating, this will often fail. This test is reasonably safely ignored as the syntax error will be identified when executing the resulting script.
Testing may be done locally by executing:
tox -e bashate
Ansible is lint tested using ansible-lint.
Testing may be done locally by executing:
tox -e ansible-lint
Ansible playbook syntax is tested using ansible-playbook.
Testing may be done locally by executing:
tox -e ansible-syntax
A consolidated set of all lint tests may be done locally by executing:
tox -e linters
Documentation is developed in reStructuredText (RST) and compiled into HTML using Sphinx.
Documentation may be built locally by executing:
tox -e docs
Every commit to OpenStack-Ansible is verified by OpenStack-CI through the following jobs:
gate-openstack-ansible-docs: This job executes the Documentation Build.
gate-openstack-ansible-linters: This job executes the Lint Tests.
gate-openstack-ansible-dsvm-commit: This job executes the gate-check-commit.sh script which executes a convergence test and then a functional test.
The convergence test is the execution of an AIO build which aims to test the primary code path for a functional environment. The functional test then executes OpenStack’s Tempest testing suite to verify that the environment that has deployed successfully actually works.
While this script is primarily developed and maintained for use in OpenStack-CI, it can be used in other environments.