[all][infra] Changes to docs publishing (promote pipeline)

Andreas Jaeger aj at suse.com
Tue Aug 20 14:12:16 UTC 2019

We have set up in Zuul a new way of publishing artifacts and are
beginning to use that now for documentation jobs [1]: The documents
built in the gate queue are published as is with just copying over to
our webserver in the promote pipeline.

The jobs for building are still the same name (small implementation
change), only the publish job has changed: It's now in the promote
pipeline. There's no need for you to do anything.

This work has been done for openstack-tox-docs (used by most OpenStack
projects), api-ref and api-guide jobs, and for openstack-manuals and

To iterate the old way was:
1) Build docs in gate pipeline
2) Merge
3) Build docs in post pipeline (same git tree!)
4) Publish

Now we do:
1) Build docs in gate pipeline
2) Merge
3) Take logs from gate pipeline and publish them

You will notice a changed behaviour: The promote pipeline reports to
gerrit - unlike the post one. So, you see that in the review and also
get notified via email.

Note that changes currently in gate pipeline might have used the
previous openstack-tox-docs implemention and will fail since the promote
job needs the changed implementation. The next publish will work.

If you have any questions, please ask on #openstack-infra IRC channel.

[1] https://review.opendev.org/677009
 Andreas Jaeger aj at suse.com Twitter: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Felix Imendörffer, Mary Higgins, Sri Rasiah
       HRB 21284 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126

More information about the openstack-discuss mailing list