zuul/zuul-jobs
Code Issues Proposed changes

upload-artifactory: documentation fix

Browse Source 
Change-Id: I1457ddff87dec3c3e2acb0b2efe6098b1a820b65
This commit is contained in:
Albin Vass 2020-05-27 13:32:39 +02:00
parent 0a02594e6f
commit 506db4d538
1 changed files with 35 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

65
roles/upload-artifactory/README.rst
View File

@ -40,49 +40,54 @@ Upload artifacts specified from the executor to artifactory.
Set to ``true`` if the instance requires basic auth to be used. Set to ``true`` if the instance requires basic auth to be used.
.. zuul:rolevar:: artifacts .. zuul:rolevar:: upload_artifactory_manifest
Variable that contains a manifest of the artifacts that should be Dictionary of types of items to upload.
uploaded to a specific instance of artifactory. This is expected to Currently only supports ``artifacts``.
be set during the build as a cached fact.
.. code-block:: yaml .. zuul:rolevar:: artifacts
artifacts: Variable that contains a manifest of the artifacts that should be
- name: tarball uploaded to a specific instance of artifactory. This is expected to
src: artifact.tar.gz be set during the build as a cached fact.
dest: /destination/to/put/artifact/artifact.tar.gz
instance: artifact-server1
headers:
Content-Type: application/gzip
The attributes available on an artifact are the following. .. code-block:: yaml
.. zuul:rolevar:: name artifacts:
- name: tarball
src: artifact.tar.gz
dest: /destination/to/put/artifact/artifact.tar.gz
instance: artifact-server1
headers:
Content-Type: application/gzip
Name of the artifact. The attributes available on an artifact are the following.
This will be displayed in the build page.
.. zuul:rolevar:: src .. zuul:rolevar:: name
Path relative to ``{{ zuul.executor.work_root }}/artifacts/``. Name of the artifact.
This will be displayed in the build page.
.. zuul:rolevar:: dest .. zuul:rolevar:: src
Destination where the artifact should be put in. Path relative to ``{{ zuul.executor.work_root }}/artifacts/``.
.. zuul:rolevar:: instance .. zuul:rolevar:: dest
Artifactory instance to place the artiface in, this is to Destination where the artifact should be put in.
choose which entry in :attr:`upload_artifactory_instances` to upload
the artifact to.
.. zuul:rolevar:: headers .. zuul:rolevar:: instance
Any headers that should be passed to ansibles uri module Artifactory instance to place the artiface in, this is to
when uploading. choose which entry in :attr:`upload_artifactory_instances` to upload
the artifact to.
.. zuul:rolevar:: metadata .. zuul:rolevar:: headers
Any metadata that should be returned to Zuul together with the Any headers that should be passed to ansibles uri module
artifact link. when uploading.
.. zuul:rolevar:: metadata
Any metadata that should be returned to Zuul together with the
artifact link.