- assure all jobs are using centos-8
- fixed broken role-addition caused by partial centos-8 migration
- assure that touching molecule.yaml file tests role-addition, so
we avoid future regressions
Change-Id: I18dfce4ef4d8c3bd3b73b2447fc6807047186f61
The contributor guide has a nice section on how to install dependencies
required to develop roles for tripleo-ansible. This commit includes a
reference to an additional requirements file for molecule dependencies.
Change-Id: Ib838c0527c33534cbf9f3bc8d69b9e5daf585607
This change adds documentation for all of the plugins currently
found in the tripleo-ansible repo. This will provide for much
greater visability into what we're providing and will allow
users and developers to better understand how to consume
the available resources.
Change-Id: I2f5813095cbadd999bc68235278a9da1f883e01e
Signed-off-by: Kevin Carter <kecarter@redhat.com>
The zuul job parent was not correct and if someone was following
the documentation importing or creating a new role, manually or
using the automation, their initial commit would not work. This
change updates the parent job name so that its functional on day
one.
Change-Id: Ic614d166451032c1b7b650a4d37a4e3a89afa629
Signed-off-by: Kevin Carter <kecarter@redhat.com>
This change converts the TripleO-Ansible test process to using native zuul.
After a long discussion about the current test process [0] it has been
determined that most folks using tox do so on a local workstation and
would not expect the local system to be modified when envoked.
To ensure we're not creating a situation where a developer runs tox with a
job that may require modifications of the system the current test
structure has been replaced with a native zuul `base` job.
> This change opens the door for us to add tox jobs later which may be
added in support of the native jobs we're running now.
> The test_json_error role was updated to set required configuration
for that specific role, which was being passed in via tox before.
Documentation has been added to the contributing section to highlight
the role development process and how folks can test things locally using
a script which will mimic the zuul job runtime.
[0] - http://eavesdrop.openstack.org/irclogs/%23tripleo/latest.log.html#t2019-06-27T14:01:13
Change-Id: Ia1f3d479f3ac447d125169d08c78aaccfeacea3a
Signed-off-by: Kevin Carter <kecarter@redhat.com>
The upstream OpenStack gate installs docker using the "install-docker"
from within the zuul-jobs repository. To ensure we're able to test role
consistently this change removes our internal docker install tasks
and simply uses the role as provided by zuul.
All of the requirements we were installing for molecule via built in
tox configuration have all been moved to the unmanaged requirements
file, "molecule-requirements.txt". This file will ensure anything we
install in a virtual-environment is consistent throughout our stack.
The `run-local-test` script has been added to the scripts directory
allowing local development to be setup and executed with minimal,
to no, pre-configuration or setup. This script and its usage has
been documented in the contributing guide.
Change-Id: If7d1ba7e59a1d6918d9606c9df8bfad21c0c47da
Signed-off-by: Kevin Carter <kecarter@redhat.com>
This change adds contributing documentation to illustrate how
developers can test roles using molecule on local machines.
To assist in local testing an rc environment file has been
added to the project root which will ensure ansible is
configured to use resources out of this project.
Change-Id: I237f743aa85fac9eb56a4c7aac54a7545cc125db
Signed-off-by: Kevin Carter <kevin@cloudnull.com>
The contributing docs have been updated to correct the file name pathing
and to update the basic noted job structure so that it matches what is
currently being executed.
Role title names have been adjusted to make them all uniform.
Change-Id: I6250a6dcf33caef599fe2bc25f90eea3b8d53d1e
Signed-off-by: Kevin Carter <kecarter@redhat.com>
The package action plugin has been imported from tripleo common.
This plugin acts as a shim allowing tripleo to control package
installations within ansible using a global variable.
The action plugin will now have tests to ensure that it is
functioning as expected within ansible.
* The default scenario will run the test role normally ensuring
that the plugin does not interfer with normal operations.
* The negative scenario will run the test role with the global
option `tripleo_enable_package_install` set to false. This will
ensure that no package is installed.
* The positive scenario will run the test role with the global
option `tripleo_enable_package_install` set to true, which
will ensure the expect package is installed.
All three scenarios have been added as jobs which run when
this role or plugin has been changed.
Because this job will run three different molecule scenarios
a change has been made to the pytest setup which will allow
us to pass in command line arguments to the job function.
This update will allow us to now set the command line option
`--scenario` when running tests. This new argument has been
documented in the `contributing.rst` file.
Change-Id: I096d6332f8231620e39ead557e7c9598adad66dd
Signed-off-by: Kevin Carter <kecarter@redhat.com>
When new roles are created following the contributing process,
documentation will now be automatically generated using the
role itself as content.
The automatic documentation process has been added to the
role-addition.yml playbook making it easy for developers to
get started.
Change-Id: Idba128e441a1a4fdff30ff1b9105f7ca8d199345
Signed-off-by: Kevin Carter <kecarter@redhat.com>
This change adds documentation and releaseonte jobs which will
validate docs written and publish them as needed.
Change-Id: Ic517ec411fe031101f2fac96a5c5f831f203ac40
Signed-off-by: Kevin Carter <kecarter@redhat.com>
A playbook has been added to the root of the project which will assist
developers in adding new roles to the project. The playbook will generate
a new role, create a tox entry, and setup zuul for independent CI.
This new playbook capability has been added to the contributing docs.
Change-Id: I726740e1c95b2f38fe7bae2e9a8f1e35feb5a7bf
Signed-off-by: Kevin Carter <kecarter@redhat.com>
A basic skeleton and molecule has been added to the project which
should assist folks looking to contribute roles to the effort. The
basic skeleton will initialize the all new roles to test with
molecule and provides access to a simple interface develoeprs can
leverage to add new roles into the project.
A minimal implementation of sphinx docs has been added to the project
in support of the new role skeleton.
Change-Id: I7a0fea87226b73b72b40e831922183a527ce901a
Signed-off-by: Kevin Carter <kecarter@redhat.com>
Sorin Sbarnea