28 Commits

Author SHA1 Message Date
Guilherme Steinmüller
924bf29c3d Fix installation docs
It should point to opendev. As well as
untrusted-projects to zuul/zuul-jobs.

Change-Id: Ic4095fa9a3c207a9854d802908a5470170683ae5
2019-06-14 18:08:48 +00:00
Sorin Sbarnea
1211185f3b Adds tox-molecule job
This adds job definition for running Ansible Molecule testing framework
from inside tox.

This would ease use of molecule testing for any projects that
want to use by avoiding the need to duplicate the setup code across
each repository.

It uses tox `molecule` environment.

Change-Id: I8df4df5448a78b9e21f45fac12d534eb84b29d3d
Needed-By: https://review.opendev.org/#/c/663599/
Needed-By: https://review.opendev.org/#/c/651772/
Needed-By: https://review.opendev.org/#/c/663336/
2019-06-11 16:25:24 +00:00
James E. Blair
e23ece5e55 Return javascript content artifact records to Zuul
When producing javascript content tarballs, return artifact records
to Zuul.

Add a new job, build-javascript-content-tarball, which includes the
role to fetch javascript content tarballs.

Change-Id: Ia247054d0523b81916815151fd57138469f634e0
2019-06-06 06:17:47 +00:00
James E. Blair
2f2d6ce3f7 Add a registry test job
This exercises the intermediate and buildset registry roles.

Change-Id: Ic0da2d6b48a7b9f9b616033c70db471ba98181b4
2019-06-03 09:03:35 -07:00
Ian Wienand
e6ca2e7c84 validate-zone-db : add job and make more generic
There was a request in If3dc95d1348553e5b43683f6a36d324fb978fbed to
make the role more generic so it could handle different layouts of
zone.db files.  Make it so the role can take a list of tuples (domain,
path/to/zone.db) so that we can handle any layouts, and modify the
default searching to build this from the source directory.

Reviews in https://review.opendev.org/660888 suggested making this
defined as a generic job, so a validate-zone-db job is added.

Change-Id: I56cbc027f63787f90eef283eeb2fbb81486dcaf5
2019-05-24 10:00:49 +10:00
Ian Wienand
42b9c209ab Zone file validation role
This role uses named-checkzone to validate Bind zone.db files it finds
in the specified directory.  Helps to avoid committing broken DNS
configurations.

Needed-By: https://review.opendev.org/660888

Change-Id: If3dc95d1348553e5b43683f6a36d324fb978fbed
2019-05-23 20:32:41 +10:00
Monty Taylor
47ceef043a Shift doc requirements to doc/requirements.txt
We have doc requirements in the normal test-requirements list.
This is causing problems for some sphinx related things which
want python3 conflicting with our py27 test job.

Change-Id: I1c4ddba56377097f1ebf39051a496577d38f0494
2019-05-09 13:58:56 +00:00
Monty Taylor
20c7a54390 Update more urls for opendev
Change-Id: I6a29bfb583078497ceaaf2dda047ebfb92642b24
2019-04-21 14:01:15 +00:00
Paul Belanger
ed1323d096 Add tox-py37 job
This is helpful for people that would like to use the py37 target for
tox.

Change-Id: I03eb4a8164a8e6fe5f75bd5cacc7c95f5428adca
Signed-off-by: Paul Belanger <pabelanger@redhat.com>
2019-04-11 18:48:15 -04:00
David Moreau Simard
4e951c6af4
Add a job that runs the upload-git-mirror role
This new job can be used by projects to mirror their repository to a
remote git server.

Change-Id: I6c51a6152f546dfdad2d0bfe260e8864e1803f8c
2019-03-28 10:39:25 -04:00
David Moreau Simard
614c6c043e Add a role to mirror a git repository to a remote git server
This role is meant to replicate a successfully tested git repository
to a remote git server over SSH during the POST pipeline.

Change-Id: I562802ede7358c809c915f09f229884d81cc5b31
Depends-On: https://review.openstack.org/643435
2019-03-26 09:24:19 -07:00
James E. Blair
4b3adfeea6 Organize documentation by subject area
This splits all of the current job and role documentation into
files by subject area so that jobs and roles are easier for users to
find.

This will require that any future new jobs or roles add a line to the
appropriate area of the documentation, since that can no longer be
done automatically.  A linter check is added to ensure that every
job and role continue to be documented.

After this refactor, we can begin to enhance the documentation pages
so that they include narrative documentation and subsections.

Change-Id: Ia6f0e89b57e3cb0d7d1745206384c946506d7ea0
2019-03-25 14:21:04 -07:00
James E. Blair
a84583eed2 Minor improvements to docker-image doc structure
Add a local table of contents and adjust the outline so that
it makes sennse.

Change-Id: I10fab5eb05e5823b405f4efd410df0f66b58c537
2019-03-22 14:49:29 -07:00
James E. Blair
e620f0b74e Document how to build a buildset registry
Change-Id: I57e6ace5f6731045b8043995b18835a499d2250c
2019-03-15 08:37:37 -07:00
mhuin
00bf7b806a Propose some job writing guidelines
In order to see more consistency and good practices in zuul-jobs,
suggest some guidelines regarding OS and containers support, and
dealing with roles dependencies.

Change-Id: Iad001766a56833094ac8703fca11559265b6f914
2019-01-21 22:40:57 +01:00
Ian Wienand
990fe95337 Add a note on testing trusted roles
Add a general note on testing, and specifically on how to use test
roles for testing trusted roles in the gate.

Change-Id: Idf84bc56effbb21f7b7a82703f398fb203c3694b
2018-12-18 07:39:19 +11:00
Ian Wienand
c9b4b01187 Add guidelines on variable naming
This captures some discussion over the scoping of variable names
during some recent role development.  It tries to provide some
guidelines to prefixing of global variable names in roles and
"module-like" roles.

Since "deprecation.rst" is now holding a few different things, it
makes more sense as "policy.rst".

Reorganise to be nested in one more level, and add a contents section
to help find sections easier.

Change-Id: I0d551eefd33744ffa23418d0780769a7e52fe9cf
2018-08-31 09:28:34 +10:00
Ian Wienand
eee316ce7b Enable Python 2.7 unit tests
Add a testenv:py27 environment that overrides basepython to 2.7

Unfortunately implicit namespace packages are a Python3 thing [1] so
we have to scatter a few __init__.py's around for the test loader
under python2 to be able to find the unit test directories.

Update documenation to mention this

Needed-By: https://review.openstack.org/592768

[1] https://www.python.org/dev/peps/pep-0420/

Change-Id: I9a653666e8a083fb7f3fbb92589fe0467a41e6e6
2018-08-17 10:23:20 +10:00
James E. Blair
a87a1db041 Add logo to docs
Change-Id: Ic39e19e4adca85ecf8d67b35de51d604ec2510be
2018-05-04 14:50:13 -07:00
James E. Blair
af0d8eb25b Add installation/deprecation documentation
Change-Id: I4db13e723c90628ef2e3a48ba5758a04d75b8d5c
2018-04-11 08:03:57 -07:00
Tristan Cacqueray
77886345df Fix pep8/yamllint errors
Change-Id: I1fdfc0e6a96a70623058139335a22325418a0fa4
2018-01-02 06:43:26 +00:00
James E. Blair
141921cc33 Update the zuul-sphinx extension config
Change-Id: I630e5dbd182d35f3ff58288a025615e9a8a0312c
2017-08-04 16:49:39 -07:00
James E. Blair
4e6c7ef6a5 Switch to using zuul-sphinx
Remove the internal zuul domain in favor of installing from
zuul-sphinx.

Change-Id: Ia3bc2e6ad38625afedb3abd925801e1bcb40eb9e
2017-08-01 09:44:18 -07:00
James E. Blair
59735b34fc Enhance sphinx plugin
Enhances support for auto documenting jobs, as well as adding
support for roles.

Change-Id: Id018d8d546884299a226e59d2afaf682becb2736
2017-06-12 10:42:15 -07:00
James E. Blair
639d10d5c4 Add Sphinx module for Zuul jobs
This adds a Sphinx module that includes the 'description' field of
a zuul job into the documentation.

Change-Id: Iaaf5d9c1013d6c1e788046db9dbf1278d786c01e
2017-06-09 09:03:15 -07:00
James E. Blair
7e0d13d1cb Add extra-test-setup role
Change-Id: Icad9896e524c69e92e9ceabd86c6ca28360887fa
Co-Authored-By: Paul Belanger <pabelanger@redhat.com>
2017-06-08 16:14:32 -07:00
James E. Blair
46684654cb Add revoke-sudo role
Also add a .gitignore and establish a documentation pattern.

Change-Id: Ib447ac13d03de4ab61171d50b19117ff654ad329
Co-Authored-By: Paul Belanger <pabelanger@redhat.com>
2017-06-08 15:19:43 -07:00
James E. Blair
e5ebc400cb Add initial license, docs, and other config
Change-Id: Ie016aa9a3494bea1e37b7eee4a970d5772317d47
2017-06-08 14:01:21 -07:00