57e5ecd013
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
69 lines
2.0 KiB
ReStructuredText
69 lines
2.0 KiB
ReStructuredText
Zuul
|
|
====
|
|
|
|
Zuul is a project gating system.
|
|
|
|
The latest documentation for Zuul v3 is published at:
|
|
https://docs.openstack.org/infra/zuul/
|
|
|
|
If you are looking for the Edge routing service named Zuul that is
|
|
related to Netflix, it can be found here:
|
|
https://github.com/Netflix/zuul
|
|
|
|
If you are looking for the Javascript testing tool named Zuul, it
|
|
can be found here:
|
|
https://github.com/defunctzombie/zuul
|
|
|
|
Getting Help
|
|
------------
|
|
|
|
There are two Zuul-related mailing lists:
|
|
|
|
`zuul-announce <http://lists.zuul-ci.org/cgi-bin/mailman/listinfo/zuul-announce>`_
|
|
A low-traffic announcement-only list to which every Zuul operator or
|
|
power-user should subscribe.
|
|
|
|
`zuul-discuss <http://lists.zuul-ci.org/cgi-bin/mailman/listinfo/zuul-discuss>`_
|
|
General discussion about Zuul, including questions about how to use
|
|
it, and future development.
|
|
|
|
You will also find Zuul developers in the `#zuul` channel on Freenode
|
|
IRC.
|
|
|
|
Contributing
|
|
------------
|
|
|
|
To browse the latest code, see: https://git.zuul-ci.org/cgit/zuul/tree/
|
|
To clone the latest code, use `git clone https://git.zuul-ci.org/zuul`
|
|
|
|
Bugs are handled at: https://storyboard.openstack.org/#!/project/679
|
|
|
|
Code reviews are handled by gerrit at https://review.openstack.org
|
|
|
|
After creating a Gerrit account, use `git review` to submit patches.
|
|
Example::
|
|
|
|
# Do your commits
|
|
$ git review
|
|
# Enter your username if prompted
|
|
|
|
Join `#zuul` on Freenode to discuss development or usage.
|
|
|
|
License
|
|
-------
|
|
|
|
Zuul is free software. Most of Zuul is licensed under the Apache
|
|
License, version 2.0. Some parts of Zuul are licensed under the
|
|
General Public License, version 3.0. Please see the license headers
|
|
at the tops of individual source files.
|
|
|
|
Python Version Support
|
|
----------------------
|
|
|
|
Zuul v3 requires Python 3. It does not support Python 2.
|
|
|
|
As Ansible is used for the execution of jobs, it's important to note that
|
|
while Ansible does support Python 3, not all of Ansible's modules do. Zuul
|
|
currently sets ``ansible_python_interpreter`` to python2 so that remote
|
|
content will be executed with Python 2.
|