Tuesday the 12th May is two weeks after announcing deprecation of the
install-* roles [1] and the date we should starting throwing an error
message to direct the user to use the renamed ensure-* role instead.
[1]
http://lists.zuul-ci.org/pipermail/zuul-announce/2020-April/000071.html
Change-Id: Ie2474c5c0704aa44f51bdd5d7afddb8c7e4e578b
This change fixes this upcoming deprecation warning:
[DEPRECATION WARNING]: Using tests as filters is deprecated. Instead of using
`result|skipped` instead use `result is skipped`. This feature will be removed
in version 2.9.
Change-Id: Ic0c93f2ea896ead76922694e6150882d8a280daf
The first version of this change was broken, fix it with updating
roles/ensure-sphinx/tasks/main.yaml to run the test-requirements check
really on the remove node.
This reverts commit 68ded2251f.
Change-Id: I481e032834fdbf674157b2c9a8fa6f95fc570ddb
Some projects, such as Zuul itself, need to use python3 to build docs.
This adds a new parameter, sphinx_python, which defines the version
of python to build documentation with. The default is python2 and
projects can choose python3 on a need basis.
Remove the comment about the need for a leading comment, since there
is now a real need for the leading comment anyway.
Replace a few direct references to {{ ansible_user_dir }}/.venv that
should have been using zuul_work_virtualenv.
Update sphinx invocation to source the virtualenv activate first.
Some sphinx modules, such as sphinxcontrib.programoutput, attempt to
execute programs and only invoking sphinx-build with the relative
path causes the paths to not be set up properly.
Co-Authored-By: David Moreau Simard <dmsimard@redhat.com>
Change-Id: Ie5e2c93f88465f4aa746827ff88a585dbaa44fd5
We install projects if they are python in the sphinx jobs because
autodoc needs to be able to import the package. Also, for pbr projects,
many projects have links to ChangeLog in the docs, which is generated by
pbr on install and sdist. Installing with pip install --no-deps does not
cause the ChangeLog to be generated, so trigger it via an sdist build
first.
Change-Id: I4528cc7f322d1fc753eb5bc259f70c47ee9d1d80
Sphinx jobs and reno jobs need basically the same thing for
dependencies. So make a new role, ensure-sphinx, which is
parameterizable enough that it can be used by both reno and sphinx jobs.
Make build jobs for both releasenotes and sphinx docs, as both of these
things are perfectly valid things to do in both OpenStack and
non-OpenStack contexts. We'll add an openstack specific job in
openstack-zuul-jobs that uses these as parents but adds the requirements
repo and constraints file settings.
Some of the pip commands here can be improved once
https://github.com/ansible/ansible/pull/33098 lands and is released,
which would allow specifying --user and -c as parameters to the pip
module.
Change-Id: Idd7caf7d88b56d61872906027b4ce7d743572ded
Needed-By: I57de14580f39b9e1c11a587b51b44b61b02c84da
vass