zuul-jobs/roles/upload-afs-synchronize/README.rst
Ian Wienand cd258e5a1d upload-afs: rename to upload-afs-roots; add afs-upload-synchronize
The upload-afs role is actually fairly specialised for uploading docs
with its root-marker scheme.  As we're moving more parts of our
infrastructure to publish via AFS I think it's worth making this quite
explicit by renaming the upload-afs role to upload-afs-roots.  This
should be transparent as we call the renamed role, and once callers
have been migrated we can use the usual deprecation process.

Add a partner role, upload-afs-synchronize, which is more of a
straight copy with options to synchronize.  This will be suitable for
uploading tarball and release artifacts.  This is similar in concept
to the promotion job used by zuul [1], but in this case will be
focused on the extant publishing jobs in project-config which don't
currently use the artifact-reporting/promote process.

[1] https://opendev.org/opendev/base-jobs/src/branch/master/playbooks/artifacts/promote.yaml#L39

Change-Id: I493d8829e3fd98e84f1b8f0e776e7ba41abf16c2
Story: #2006598
Task: #38600
2020-02-04 07:41:00 +11:00

20 lines
533 B
ReStructuredText

Copy contents from ``{{ zuul.executor.work_root }}/artifacts/`` to AFS
**Role Variables**
.. zuul:rolevar:: afs_source
Path to local source directory.
.. zuul:rolevar:: afs_target
Target path in AFS (should begin with '/afs/...').
.. zuul:rolevar:: afs_copy_only
:default: True
If set to `false`, this will specify `--delete-after` to remove
files on the remote side that do not exist on the copying side.
When set to `true` will act as a regular additive copy process and
will not remove any remote files.