openstack/openstack-ansible-os_designate - openstack-ansible-os_designate - OpenDev: Free Software Needs Free Tools

This patch adds a `pdf-docs` tox target that will build
PDF versions of our docs. As per the Train community goal:
 https://governance.openstack.org/tc/goals/selected/train/pdf-doc-generation.html
Add sphinxcontrib-svg2pdfconverter to doc/requirements.txt
to convert our SVGs.
Change-Id: I9912fa1937def7cca5805f865206a3e9337c56e8
Story: 2006105

Change-Id: Ia06f067b5bdd9fc6c29ebd49c699d49a83d9634e

We want to default to running all tox environments under python 3, so
set the basepython value in each environment.
We do not want to specify a minor version number, because we do not
want to have to update the file every time we upgrade python.
We do not want to set the override once in testenv, because that
breaks the more specific versions used in default environments like
py35 and py36.
Change-Id: Idf52b7aeecc46b3ff14cf9e2b3a7c4401987c574
Closes-Bug: #1801657 

We want to default to running all tox environments under python 3, so
set the basepython value in each environment.
We do not want to specify a minor version number, because we do not
want to have to update the file every time we upgrade python.
We do not want to set the override once in testenv, because that
breaks the more specific versions used in default environments like
py35 and py36.
Change-Id: I5aacd82f70daf8e2b40fac01d01e511e0cf6a531
Signed-off-by: Doug Hellmann <doug@doughellmann.com>

Now that we're using the general templates, we can slim down
the role test definitions. We can also remove tests which are
not being watched, or which are fundamentally broken. With
this we can also remove unused scripts/plays.
We do the following:
1. We remove the 'ssl' job, given that the person working on
 that is no longer doing so, and no-one else has picked up
 the work.
2. We promote the centos-7 distro_install job, given that it
 is now working.
Change-Id: I39058d02fabcc2801f3d3a8a5ac910668ad5c1f5

The TESTING_BRANCH environment variable is provided by the
run_tests.sh script and is derived from the .gitreview file.
This ensures that once the master branch becomes a stable
branch, the constraints from the stable branch in the
integrated repository will automatically get used once the
.gitreview file is updated.
To ensure that the required environment variables are present
we export them appropriately in run_tests.sh and modify the
tox configuration to pass them into the tox test.
Change-Id: I21d58858783b2c85e7f50e89d43ae58088913ae1
Needed-By: https://review.openstack.org/579371 

We want to default to running all tox environments under python 3, so
set the basepython value in each environment.
We do not want to specify a minor version number, because we do not
want to have to update the file every time we upgrade python.
We do not want to set the override once in testenv, because that
breaks the more specific versions used in default environments like
py35 and py36.
Change-Id: Ifd79dfdd9b5cd921f4175dbad6e27d6701372786

Using tox for requirements management requires in-repo
requirements files for all our repositories. Rather than
do that, we make use of the tests repo to capture our
common requirements and use this to install them.
This reduces our review requirement rate and simplifies
maintenance for us for the tox config. It also makes it
usable with 'Depends-On', which is marvellous!
The tox requirements definitions for docs/releasenotes
builds are left in-place as those are standard entries
across the community. If that changes at some point, we
can re-assess those entries too.
Depends-On: https://review.openstack.org/579208
Change-Id: I2374264953e2ad2eb10994cdbbac6bfc20c9bec0

Change-Id: Ia422fdf0924cdb5df856fdc9d1c378939361a3ab
Implements: blueprint openstack-distribution-packages

Distributions provide packages for the OpenStack services so we add
support for using these instead of the pip ones.
Change-Id: Iab155254fa3600e1b6b3e8992f7c1fdc6f710ed6
Implements: blueprint openstack-distribution-packages

Now that run_tests.sh handles the tests repo clone, we can
remove the use of the older tests-repo-clone.sh script.
Change-Id: If822729b14984ae2f654728ecf8ee528f023bffe

In order to allow the use of the environment variable which informs
Ansible which user executed the playbook, we pass the USER env var
into the environment that tox builds.
Change-Id: I2ac255650f775668424d15ec40589d0c8ae565b2
Implements: blueprint python-build-install-simplification
Signed-off-by: Jesse Pretorius <jesse.pretorius@rackspace.co.uk>

For compliance with the Project Testing Interface as described in:
https://governance.openstack.org/tc/reference/project-testing-interface.html
For more detials information, please refer to:
http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html
Change-Id: I3cc90d0248b9df347cc9170d5bc67ebf24e1337a

When 'designate_galera_use_ssl' is True, use an encrypted connection to
the database using either a self-signed or user-provided CA certificate.
A new non-voting test has been added to verify that the role remains
functional when enabling SSL features.
Change-Id: I0d8e3b685faa8d394fd56f8fbfd9b492d2c2cb60
Partial-Bug: 1667789

Currently the role tests use whatever versions of pip,
setuptools and wheel are already installed on the host.
When a version of these tools changes it often causes
problems for our testing.
This will ensure that we use a known good set of pins
which is maintained in the general SHA bumping process.
Change-Id: I2ca63fb8de5f44dbaad900860846657ca4e0595b

When executing the tests repo clone in OpenStack-CI,
use zuul-cloner instead of git to enable cross-repo
testing. This ensures that if a dependent patch from
the tests repo is noted using 'Depends-On: <change-id>'
in the commit message, that patch will be included.
Change-Id: Ia4d7c9674d96bf1e9d4e89362892084c801f2e92
Depends-On: Idce7abebf32f24c356a27e099fbca954d917402b

TrivialFix
Change-Id: I2c7487a71002314d5834e8ba5917be2a602ae8fc

Some hacking have been removed,so we can delete them.
More details:
 https://github.com/openstack-dev/hacking/blob/master/setup.cfg
Change-Id: Ic71e2bc211f72b38abca5ba5986752134be19095

With the implementation of https://review.openstack.org/388087 all
tox targets may now use upper constraints.
Change-Id: I9cbfb4cc6d65a673d9adc843a5157ef7eb8a40ad

This patch consumes the centralised Ansible test scripts
implemented in https://review.openstack.org/381853
Change-Id: I4932a1bf8a425623937e0fd7a4dfd1654e381465

Renamed in os_designate role repo
Changed test-vars.yml to os_designate-overrides.yml
Removed the test-vars.yml file
Change-Id: Ic3d5c3094d96cf0026564fcc8407157dfc87cec4
Partial-Bug: #1629284 

With https://review.openstack.org/381479 merged, setting this
variable in tox.ini via an extra var is unnecessary.
Change-Id: I2e572a0c8e158cfffaf415e09c7ab6a2e3de4536

This patch consumes the test scripts implemented by
https://review.openstack.org/375061 to ensure that
the tests and test preparation is consistent and
more maintainable.
Change-Id: I3a50b32bbb7bf724ccc446876755454b5cb24c89

Change-Id: I2db8435b0ae5b6004ebe1985c5606c0c39900a95
Signed-off-by: Kevin Carter <kevin.carter@rackspace.com>

The volume of logs we collect in CI jobs are extensive. This
patch ensures that the logs collected are compressed to reduce
the space taken in CI systems.
PYTHONUNBUFFERED is also set to ensure that the console log
from the CI jobs is recorded in the exact order of execution.
Change-Id: Ia8a9f927a6c86c5a1fca4faf4c08f57df334674e
Related-Bug: #1620849 

This change enables log collection within the gate so that further analysis
on gate tasks can be performed post build. This is very useful when
debugging problems.
Change-Id: I9e2a6eac052d175971bedd3e5f7a793ca3ab0934
Signed-off-by: Kevin Carter <kevin.carter@rackspace.com>

As per [1] all linting tests can now use upper-constraints. This patch
removes all instances of the install_command override relating to lint
testing which were needed to negate the use of upper-constraints.
[1] http://lists.openstack.org/pipermail/openstack-dev/2016-August/101474.html
Change-Id: I3785aa031abcfeb732c0a373775c479c004d4f21

The plugin repo needs to be cloned for ansible-lint to
understand ansible plugins. The commands currently
reside in tox.ini under the ansible section and are not
currently included. This commit fixes that error.
Change-Id: I395f70d69e6ef92782c5e99031360ffa357c6a92

The 'docs' tox target executes the doc8 lint test which may result in
failures when testing documentation builds, but OpenStack-CI does not
execute that tox target.
In order to ensure that we catch all standard documentation syntax
errors and prevent them from merging, this patch includes the docs
target in the 'linters' chain of tests.
Fixes for any failures which result from executing this test are also
included in the patch.
Change-Id: I56839e936a35a96a829716eb4686bd7fd0927469

With the implementation of https://review.openstack.org/321331 the
human_log callback plugin is now part of the plugins repo.
This patch removes the retrofitted version in tox in favor of using
the version from the plugins repo instead.
Change-Id: I8a0aaf157226f34712c40d5dcd091353fda0efc8

In order to prepare for the move of detailed configuration
content from the install guide to the roles, doc8 checks
are being implemented in the roles to ensure that any new
content submitted is properly checked.
Change-Id: I7db85f8f2d069ae94e5e7a254ad7ab737b66647a
Partially-Implements: blueprint osa-install-guide-overhaul

In order to prepare for implementing requirements management by the
OpenStack requirements management process, and to improve the
reliability and effectiveness of test execution, this patch implements
some changes to the tox configuration:
- The minimum tox version is increased in order to be able to use
 constraints for the python packages.
- The OpenStack upper-constraints are used when preparing the test
 venv for the linters checks.
- Any proxy environment variables set on the test host are passed
 into the venv to enable testing from behind a proxy.
- The environment variables used by Ansible tests are moved into
 a new venv called 'ansible' and this environment is inherited
 by all Ansible-related tests.
- The docs test will clean-up an existing build directory before
 executing the docs build.
- The releasenotes build cannot use upper-constraints at this point,
 so it doesn't.
- The Ansible role download will no longer ignore errors so that any
 problems discovered will result in a failed test.
- The human readable logging callback plugin is implemented for
 functional testing.
- The ansible test requirements are moved into tox.ini to ensure
 compliance for requirements.txt/test-requirements.txt for the
 global-requirements management contract.
- The ~/.ansible directory as a whole is not deleted. Instead only
 the plugins and roles folders are deleted to ensure that zuul's
 Ansible artifacts are left in-place.
- The ansible-lint version is updated to support execution against a
 folder, and the test now executes against the entire role to ensure
 that it captures all applicable files for lint testing.
This is a combined port of the following:
- https://review.openstack.org/323507
- https://review.openstack.org/338193
- https://review.openstack.org/332443
- https://review.openstack.org/338193
- https://review.openstack.org/339493
Change-Id: Iaa4e552560a2e4b2a0f5b4f61f189f6dbb9864e7

Change-Id: I9737a8bd143401ba76cb0d4d243d05c4473768bf

This patch implements a bunch of changes for easier debugging and to
make the deployment more functional.
 - All passwords are removed from defaults. The role must fail to
 complete all tasks if no password is provided.
 - The Designate Pool Configuration uuid's are provided with
 defaults and the vars are added to the user_secrets.yml file
 for easy implementation in OpenStack-Ansible.
 - The designate.conf template has been re-organised to closely
 match the sample file provided in the master branch of the
 OpenStack Designate repository. This makes it easier to compare
 for changes.
 - The PyMySQL driver is used for all MySQL connectivity, as is now
 the general standard for OpenStack Services.
 - The designate_pool_manager database is now setup.
 - The test playbook has the RabbitMQ & DB setup pre_tasks removed
 for now. These can move out again once functional testing is
 working.
 - The test playbook's LXC dhcp range is reduced to 50 hosts in
 order to ensure no conflicts with the test containers and also
 provide room for growth.
 - Add human readable logging callback plugin to functional test.
 - Restructure testing to make it easier to work with.

This patch includes the following:
 - Base configuration for OpenStack's CI Infrastructure.
 - Base documentation build configuration.
 - A Vagrantfile for local testing.
 - A base test configuration in order to execute a functional test.
 - An updated README, added LICENSE file and a CONTRIBUTING file.