zuul-jobs/roles/set-zuul-log-path-fact/README.rst
Clark Boylan b62efba8a4 Add option for object store friendly log paths
For logs stored in object storage services we want to be able to shard
into different containers. This improves scalability of the object
stores. To do this consistently we prefix all log paths with the first 3
characters of the build uuid. This way we get container names like
log_123, log_abc, and so on for a total of 4096 containers.

This behavior is off by default because users of filesystems stores
without a zuul dashboard may still want periodic/ to be filed into a top
level dir for browseability.

Change-Id: I8e72a6e587edcbdf89b793cad2d7c96c535601e7
2019-09-04 09:52:38 -07:00

13 lines
413 B
ReStructuredText

Sets a fact named ``zuul_log_path`` from zuul variables
**Role Variables**
.. zuul:rolevar:: zuul_log_path_shard_build
:type: bool
:default: False
Flag to specify whether or not paths that include a three character
prefix based on the build uuid should prefix the log path. This is
particularly useful for object storage systems where we want to
spread out the number of files per container.