zuul
/
zuul
Code Issues Proposed changes

Add generate-zuul-manifest to quick-start 

We need this role in order for the new log browsing features in
the web UI to work.

Also, update the text to account for multiple log storage systems
supported by zuul-jobs now.

Change-Id: Ieb542bb80d46f487b8f49b51fd0de8de2e4f2708
This commit is contained in:
James E. Blair 2020-03-23 15:55:01 -07:00
parent 70c70f8880
commit 88f0e2a4c7
2 changed files with 12 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
doc/source/examples/zuul-config/playbooks/base/post-logs.yaml
View File

@ -1,5 +1,6 @@
- hosts: localhost
gather_facts: False
roles:
- generate-zuul-manifest
- role: upload-logs
zuul_log_url: "http://localhost:8000"

17
doc/source/tutorials/quick-start.rst
View File

@ -459,6 +459,11 @@ create a second post-run playbook for it. Copy the following to
.. literalinclude:: /examples/zuul-config/playbooks/base/post-logs.yaml
:language: yaml
The first role in this playbook generates some metadata about the logs
which are about to be uploaded. Zuul uses this metadata in its web
interface to nicely render the logs and other information about the
build.
This tutorial is running an Apache webserver in a container which will
serve build logs from a volume that is shared with the Zuul executor.
That volume is mounted at `/srv/static/logs`, which is the default
@ -467,12 +472,12 @@ files to a remote server via SCP; see the role documentation for how
to configure it. For this simple case, the only option we need to
provide is the URL where the logs can ultimately be found.
.. note:: Zuul-jobs also contains a `role
<https://zuul-ci.org/docs/zuul-jobs/roles.html#role-upload-logs-swift>`_
to upload logs to an OpenStack Object Storage (swift)
container. If you create a role to upload logs to another
system, please feel free to contribute it to the zuul-jobs
repository for others to use.
.. note:: Zuul-jobs also contains `roles
<https://zuul-ci.org/docs/zuul-jobs/log-roles.html>`_ to
upload logs to a OpenStack Object Storage (swift) or Google
Cloud Storage containers. If you create a role to upload
logs to another system, please feel free to contribute it to
the zuul-jobs repository for others to use.
.. _upload-logs: https://zuul-ci.org/docs/zuul-jobs/roles.html#role-upload-logs