From 1237417ea30fb87757ea21b9009c664ba4def803 Mon Sep 17 00:00:00 2001 From: Andreas Jaeger Date: Fri, 31 Jan 2020 08:33:38 +0100 Subject: [PATCH] Update upload-afs README Explain the intention of this role and the details of .root-marker, some of it is copied verbatim from the infra-specs repository design document. Change-Id: I6d9124c7eafadc4b53626ff2fef6be6399f61947 --- roles/upload-afs/README.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/roles/upload-afs/README.rst b/roles/upload-afs/README.rst index d684e0fc9..819f38174 100644 --- a/roles/upload-afs/README.rst +++ b/roles/upload-afs/README.rst @@ -1,5 +1,20 @@ Copy contents from ``{{ zuul.executor.work_root }}/artifacts/`` to AFS +This is intented for documentation publishing, it deletes files that +do not exist in the content from the source. + +Before the job rsyncs the build into its final location, it must first +create a list of directories that should not be deleted. This way if +an entire directory is removed from a document, it will still be +removed from the website, but directories which are themselves roots +of other documents (for example, the stein branch) are not removed. A +marker file, called `.root-marker`, at the root of each such directory +will accomplish this; therefore each build job should also ensure that +it leaves such a marker file at the root of its build. The job will +find each of those in the destination hierarchy and add their +containing directories to a list of directories to exclude from +rsyncing. + **Role Variables** .. zuul:rolevar:: afs_source