summaryrefslogtreecommitdiff
path: root/README.rst
Commit message (Collapse)AuthorAgeFilesLines
* Update README to point to Matrix, not IRCTim Burke2022-11-081-3/+4
| | | | Change-Id: I30344782fe1d65edd7f2985097ab040c51820097
* Support nodes setting 'auto' python-pathIan Wienand2019-09-191-5/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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 I02a1a618c8806b150049e91b644ec3c0cb826ba4. 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) [1] https://bugzilla.redhat.com/show_bug.cgi?id=1696404 [2] https://docs.ansible.com/ansible/2.8/reference_appendices/interpreter_discovery.html Change-Id: I2b3bc6d4f873b7d653cfaccd1598464583c561e7
* Switch to review.opendev.org for README.rstPaul Belanger2019-08-141-1/+1
| | | | | | | This is the shiny new address for gerrit. Change-Id: I255b5827add555d4b7b46f583218b840f2c100b9 Signed-off-by: Paul Belanger <pabelanger@redhat.com>
* Update references for opendevMonty Taylor2019-04-241-3/+3
| | | | Change-Id: I3c1ac5478efed4dee1d525deb036d457287fa136
* Add instructions for reporting vulnerabilitiesJeremy Stanley2018-12-051-0/+4
| | | | | | | | | | 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
* Switch storyboard url to be by nameMonty Taylor2018-08-031-1/+1
| | | | | | Storyboard can have project name in a url now. It's prettier. Change-Id: I070acacd7c73b2bd1fea34ac78313332f3bb2350
* Update documentation URLsPaul Belanger2018-05-021-1/+1
| | | | | | | Switch to use https://zuul-ci.org/docs/ for documentation links. Change-Id: Ie52f025994e982ff2298696f79e8f0718946e7b3 Signed-off-by: Paul Belanger <pabelanger@redhat.com>
* Use git.zuul-ci.orgJames E. Blair2018-03-281-2/+2
| | | | | | | We now have a git mirror at git.zuul-ci.org with only the Zuul git repos. Update references to git.openstack.org to use that. Change-Id: I3e7b3b2e19468521548cc5179bbb2bf6d037ddf0
* Update README and add GPL licenseJames E. Blair2018-03-191-129/+28
| | | | | | | | | | 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
* Remove feature/zuulv3 references from READMEJames E. Blair2018-01-181-5/+4
| | | | Change-Id: I8ad2fe1f5f7c948f32381af86cdc39e65020b880
* Disambiguate with Netflix and Javascript zuulClint Byrum2018-01-041-0/+8
| | | | | | | There are two other projects named zuul. Let's make sure we disambiguate so users aren't confused. Change-Id: I6c459d062970e2abcbb890d626297595d979d324
* Add link to Zuul v3 docs to the READMEMonty Taylor2017-07-101-0/+3
| | | | | | Put it in up high so that people can see it. Change-Id: Ib80a636330749a4ef6c7327fde22293d7f54155e
* Add note to README about Python3Monty Taylor2017-06-161-0/+10
| | | | | | | Tell people that we're Python3 only, but also call out how that interacts with Ansible. Change-Id: I1d2b22cd32857f26abc85cdd8a2f3310d3c5e37b
* Fix dev doc link in README.rstDavid Shrewsbury2017-03-281-1/+1
| | | | | | Fix bad link to the developer documentation. Change-Id: I5d4b48ada4959dda735d5ea050c663f0d6ede621
* Fix testtools.run syntax for README.rstPaul Belanger2017-03-181-1/+1
| | | | | Change-Id: I7762bc1954258eaa932239421a832fb7dc95d16e Signed-off-by: Paul Belanger <pabelanger@redhat.com>
* Rename zuul-launcher to zuul-executorPaul Belanger2017-03-151-1/+1
| | | | | | | | To avoid confusion with nodepool-launcher, we've decided to rename zuul-launcher to zuul-executor. Change-Id: I7d03cf0f0093400f4ba2e4beb1c92694224a3e8c Signed-off-by: Paul Belanger <pabelanger@redhat.com>
* Zuul v3 readme updatesJames E. Blair2017-03-071-4/+9
| | | | | | | | | | 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 expected). Change-Id: Ibd56f61a0b7b5a48c048c2277e7d050dd8ebf9c6
* Add roadmap to READMEJames E. Blair2016-12-061-0/+17
| | | | Change-Id: I80431df3341206284df04d7ab5f70fe91339fe61
* Update storyboard links in READMEJames E. Blair2016-12-051-6/+4
| | | | Change-Id: I1948f661e8ce1d2f2386d55b8d31c876ba3ac191
* Merge branch 'master' into workingv3Joshua Hesketh2016-11-221-0/+5
|\ | | | | | | | | | | | | | | This includes forward-porting changes to launcher/server.py 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
| * Add a note to README.rst about contributing to Zuul v3James E. Blair2016-10-121-0/+5
| | | | | | | | Change-Id: Ie81a393900bb8fe057836ba6e13099c0f0e39e57
| * Tidy up README.rstJames E. Blair2016-10-121-4/+5
| | | | | | | | | | | | | | Some minor changes to clean up the existing version in preparation for expanding the content. Change-Id: I1cb97286ad91e8491b98c825ff26c37aa756c0b0
* | Add information on how to contribute to Zuulv3James E. Blair2016-10-121-0/+102
| | | | | | | | | | | | | | | | | | | | | | 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
* | Tidy up README.rstJames E. Blair2016-10-121-4/+5
|/ | | | | | | Some minor changes to clean up the existing version in preparation for expanding the content. Change-Id: I1cb97286ad91e8491b98c825ff26c37aa756c0b0
* Switched documentation to point to storyboard.Michael Krotscheck2014-11-111-1/+1
| | | | | | We've migrated this project to storyboard, I'm updating the documentation links. Change-Id: I32ca3ee67ba78cd8f2daf1247488264647e44617
* Update the url for the zuul git repoAnita Kuno2013-12-311-1/+2
| | | | | | The git repos are at git.openstack.org. This patch reflects that. Change-Id: I364e5e341635933b69133aaf60aa5e3f4b7ef71b
* Drop Jenkins.getBestBuildURL() methodOri Livneh2013-05-051-1/+1
| | | | | | | | | | | | | | | | | | 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-on: https://review.openstack.org/28128 Reviewed-by: James E. Blair <corvus@inaugust.com> Approved: Clark Boylan <clark.boylan@gmail.com> Reviewed-by: Clark Boylan <clark.boylan@gmail.com> Tested-by: Jenkins
* Convert README to reStructuredTextPaul Belanger2013-04-081-0/+20
Change-Id: Iceb9049640aa3e0ff5c030fa5b93225e1e8ff887 Signed-off-by: Paul Belanger <paul.belanger@polybeacon.com> Reviewed-on: https://review.openstack.org/26381 Reviewed-by: James E. Blair <corvus@inaugust.com> Approved: Monty Taylor <mordred@inaugust.com> Reviewed-by: Monty Taylor <mordred@inaugust.com> Tested-by: Jenkins