add 'jobs update' and 'repos clone' to readme

Change-Id: I6d23c260d3cba666b79a9c50cc9f0b02f3855bd5
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
This commit is contained in:
Doug Hellmann 2018-07-11 07:52:49 -04:00
parent c0f61d5c55
commit a867a24ed4
1 changed files with 23 additions and 0 deletions

View File

@ -48,5 +48,28 @@ and prints the settings that need to stay in
$ tox -e venv -- python3-first jobs retain --project-config ../project-config \
openstack-dev/devstack
The ``jobs update`` command will modify the zuul settings in a
repository to include all of the settings shown by ``jobs extract``.
.. code-block:: console
$ git clone git://git.openstack.org/openstack/oslo.config
$ cd oslo.config
$ git checkout -b python3-first
$ cd ../goal-tools
$ tox -e venv -- python3-first jobs update --project-config ../project-config \
../oslo.config
The ``repos clone`` command will use the project governance data to
find a list of all of the git repositories managed by a project team
and then clone local copies of all of them. This makes it easier to
work on all of the projects for a single team as a batch.
.. code-block:: console
$ mkdir Oslo
$ cd goal-tools
$ tox -e venv -- python3-first repos clone ../Oslo Oslo
Use the ``-v`` option to python3-first to see debug information on
stderr (allowing stdout to be redirected to a file safely).