Commit Graph

28 Commits (master)

Author SHA1 Message Date
Tim Burke b775e317e3 Update README to point to Matrix, not IRC
Change-Id: I30344782fe1d65edd7f2985097ab040c51820097
2022-11-08 22:25:10 -08:00
Ian Wienand 93d1d3be17 Support nodes setting 'auto' python-path
The nodepool "python-path" config variable makes it's way through from
the node arguments and ends up as the "ansible_python_interpreter"
variable for the inventory when running the job.

Notably, Python 3 only distributions require this to be set to
/usr/bin/python3 to avoid what can often be confusing red-herring
errors (e.g. things like dnf packages incorrectly appearing to be
missing on Fedora, for example [1]).

Upstream is aware of this often confusing behaviour and has made an
"ansible_python_interpreter" value of "auto" to, essentially, "do the
right thing" [2] and choose the right python for the target
environment.  This is available in Ansible >=2.8 and will become
default in 2.12.

This allows, and defaults to, an interpreter value of "auto" when
running with Ansible >=2.8.  On the supported prior Ansible releases,
"auto" will be translated into "/usr/bin/python2" to maintain
backwards compatability.  Of course a node explicity setting
"python-path" already will override this.

Nodepool is updated to set this by default with

I think this is much more user friendly as it puts the work of
figuring out what platform has what interpreter into Ansible.  It
alleviates the need for admins to know anything at all about
"python-path" for node configurations unless they are actually doing
something out of the ordinary like using a virtualenv.  At the moment,
if you put a modern Python-3 only distro into nodepool, Zuul always
does the wrong thing by selecting /usr/bin/python2; you are left to
debug the failures and need to know to go and manually update the
python-path to Python 3.

Documentation is updated.  Detailed discussion is moved into the
executor section; the README is simplified a bit to avoid confusion.

A release note is added.

A test-case is added.  Note that it is also self-testing in that jobs
using Ansible 2.8 use the updated value
(c.f. I7cdcfc760975871f7fa9949da1015d7cec92ee67)


Change-Id: I2b3bc6d4f873b7d653cfaccd1598464583c561e7
2019-09-19 10:28:53 +10:00
Paul Belanger 381ed1a26b Switch to for README.rst
This is the shiny new address for gerrit.

Change-Id: I255b5827add555d4b7b46f583218b840f2c100b9
Signed-off-by: Paul Belanger <>
2019-08-14 20:00:01 -04:00
Monty Taylor b0252eef9d Update references for opendev
Change-Id: I3c1ac5478efed4dee1d525deb036d457287fa136
2019-04-24 12:59:17 +00:00
Jeremy Stanley ddd8594a3c Add instructions for reporting vulnerabilities
Prominently in the Zuul User Guide, include a brief overview of
preferred methods for reporting suspected security vulnerabilities.
Also link to it from the README in such a way that the same
reference can be reused in other related Zuul repositories following
the same policy.

Change-Id: I2bd13bd13372f26c328cd7d6b5618ee8edffe490
2018-12-05 16:12:30 +00:00
Monty Taylor 018a4fd6fb
Switch storyboard url to be by name
Storyboard can have project name in a url now. It's prettier.

Change-Id: I070acacd7c73b2bd1fea34ac78313332f3bb2350
2018-08-03 10:18:12 -05:00
Paul Belanger 7d95d0b1cb
Update documentation URLs
Switch to use for documentation links.

Change-Id: Ie52f025994e982ff2298696f79e8f0718946e7b3
Signed-off-by: Paul Belanger <>
2018-05-02 19:05:12 -04:00
James E. Blair 57e5ecd013 Use
We now have a git mirror at with only the Zuul
git repos.  Update references to to use that.

Change-Id: I3e7b3b2e19468521548cc5179bbb2bf6d037ddf0
2018-03-28 09:41:44 -07:00
James E. Blair 09ef12843b Update README and add GPL license
Update the README to mention that some files are licensed under
the GPL.  Include a copy of the GPL in the repo.

Also update the README to reflect the state of the project now that
we are approaching the v3 release.

Change-Id: I572dc565bf5cc1a89af476c7461236aa325a7bd6
2018-03-19 09:25:52 -07:00
James E. Blair 00c67aa5f2 Remove feature/zuulv3 references from README
Change-Id: I8ad2fe1f5f7c948f32381af86cdc39e65020b880
2018-01-18 13:05:44 -08:00
Clint Byrum f491d06843 Disambiguate with Netflix and Javascript zuul
There are two other projects named zuul. Let's make sure we disambiguate
so users aren't confused.

Change-Id: I6c459d062970e2abcbb890d626297595d979d324
2018-01-04 20:57:29 -08:00
Monty Taylor 6529375db0
Add link to Zuul v3 docs to the README
Put it in up high so that people can see it.

Change-Id: Ib80a636330749a4ef6c7327fde22293d7f54155e
2017-07-10 17:22:52 -05:00
Monty Taylor 9c817e9885
Add note to README about Python3
Tell people that we're Python3 only, but also call out how that
interacts with Ansible.

Change-Id: I1d2b22cd32857f26abc85cdd8a2f3310d3c5e37b
2017-06-16 15:43:14 -05:00
David Shrewsbury 49bee7b6c6 Fix dev doc link in README.rst
Fix bad link to the developer documentation.

Change-Id: I5d4b48ada4959dda735d5ea050c663f0d6ede621
2017-03-28 14:28:02 -04:00
Paul Belanger 6a1825d073 Fix syntax for README.rst
Change-Id: I7762bc1954258eaa932239421a832fb7dc95d16e
Signed-off-by: Paul Belanger <>
2017-03-18 12:41:01 -04:00
Paul Belanger 174a8274d0 Rename zuul-launcher to zuul-executor
To avoid confusion with nodepool-launcher, we've decided to rename
zuul-launcher to zuul-executor.

Change-Id: I7d03cf0f0093400f4ba2e4beb1c92694224a3e8c
Signed-off-by: Paul Belanger <>
2017-03-15 12:21:24 -04:00
James E. Blair 903a7466fb Zuul v3 readme updates
Adds a link to a storyboard search for low-hanging-fruit.

Updates the roadmap to reflect some tasks having been completed,
and one re-ordered (we were able to run jobs on zuul earlier than

Change-Id: Ibd56f61a0b7b5a48c048c2277e7d050dd8ebf9c6
2017-03-07 09:28:40 -08:00
James E. Blair a3c03edfcb Add roadmap to README
Change-Id: I80431df3341206284df04d7ab5f70fe91339fe61
2016-12-06 10:55:55 -08:00
James E. Blair d5dcaa1313 Update storyboard links in README
Change-Id: I1948f661e8ce1d2f2386d55b8d31c876ba3ac191
2016-12-05 13:39:30 -08:00
Joshua Hesketh 3f7def3424 Merge branch 'master' into workingv3
This includes forward-porting changes to launcher/ with the
exception of the pre/post playbooks changes which will be done in a
follow up commit as they have deviated.

Change-Id: I13aa229c1460b748745babe178c0a745e52f841c
2016-11-22 11:15:24 +11:00
James E. Blair 1a426409f5 Add a note to README.rst about contributing to Zuul v3
Change-Id: Ie81a393900bb8fe057836ba6e13099c0f0e39e57
2016-10-12 15:17:37 -07:00
James E. Blair 4c91765f94 Tidy up README.rst
Some minor changes to clean up the existing version in preparation
for expanding the content.

Change-Id: I1cb97286ad91e8491b98c825ff26c37aa756c0b0
2016-10-12 15:15:58 -07:00
James E. Blair 75260741be Add information on how to contribute to Zuulv3
Some of this is temporary and reflects how Zuul v3 development
work is proceeding at this moment.  It will eventually be simplified
or removed.

The rest probably needs to eventually move into a more substantial
contributing section in the documentation.

Change-Id: I2b9109aa2c0bfbb865893bd59bdeb9ea4c03fff2
2016-10-12 15:12:06 -07:00
James E. Blair 4c3e0a3205 Tidy up README.rst
Some minor changes to clean up the existing version in preparation
for expanding the content.

Change-Id: I1cb97286ad91e8491b98c825ff26c37aa756c0b0
2016-10-12 14:15:20 -07:00
Michael Krotscheck 8c81dc3fa9 Switched documentation to point to storyboard.
We've migrated this project to storyboard, I'm updating the documentation links.

Change-Id: I32ca3ee67ba78cd8f2daf1247488264647e44617
2014-11-11 15:59:24 -08:00
Anita Kuno 84ed8cd68d Update the url for the zuul git repo
The git repos are at This patch reflects that.

Change-Id: I364e5e341635933b69133aaf60aa5e3f4b7ef71b
2013-12-31 09:30:01 -05:00
Ori Livneh 7191ee881d Drop Jenkins.getBestBuildURL() method
The ability to configure success and failure URL patterns (cf.
'success-pattern' and 'failure-pattern') obsoletes the need to
guess-by-fetching an appropriate link for the build status, which can be
extremely expensive. (Wikimedia's Zuul instance makes three HTTP requests per
invocation -- 'testReport', which 302s to 'testReport/', which 404s, and then
'consoleFull', which often runs to hundreds of kilobytes.)

Also corrects a small typo in README.rst.

Change-Id: Ib222f544c98253152a5e787ec0cdf28fa2d80cf6
Reviewed-by: James E. Blair <>
Approved: Clark Boylan <>
Reviewed-by: Clark Boylan <>
Tested-by: Jenkins
2013-05-05 21:58:29 +00:00
Paul Belanger 82595109b5 Convert README to reStructuredText
Change-Id: Iceb9049640aa3e0ff5c030fa5b93225e1e8ff887
Signed-off-by: Paul Belanger <>
Reviewed-by: James E. Blair <>
Approved: Monty Taylor <>
Reviewed-by: Monty Taylor <>
Tested-by: Jenkins
2013-04-08 18:52:52 +00:00