zuul
/
zuul-jobs
Code Issues Proposed changes
zuul-jobs/roles/upload-afs-roots
History
James E. Blair 9e22cfdb0f Remove shebang from all python ansible modules 
This commit in Ansible:
9142be2f6c

now allows Python modules to specify their interpreter with the shebang.
We expect our roles to use the discovered python interpreter on remote
nodes, and on the executor, we need them to use the virtualenv.  Removing
the specific shebang accomplishes this under Ansible 6, and has no effect
under older versions of Ansible.

Without this, for example, the log upload roles would not have access to
their cloud libraries.

Also update our ansible/cli check in our module files.  Many of our modules
can be run from the command line for ease of testing, but the check that we
perform to determine if the module is being invoked from the command line
or Ansible fails on Ansible 5.  Update it to a check that should work in
all 4 versions of Ansible that Zuul uses.

Change-Id: I4e6e85156459cca032e6c3e1d8a9284be919ccca
 		2022-09-15 13:48:10 -07:00
..
defaults upload-afs: rename to upload-afs-roots; add afs-upload-synchronize 2020-02-04 07:41:00 +11:00
library Remove shebang from all python ansible modules 2022-09-15 13:48:10 -07:00
tasks upload-afs: rename to upload-afs-roots; add afs-upload-synchronize 2020-02-04 07:41:00 +11:00
README.rst upload-afs: rename to upload-afs-roots; add afs-upload-synchronize 2020-02-04 07:41:00 +11:00
__init__.py upload-afs: rename to upload-afs-roots; add afs-upload-synchronize 2020-02-04 07:41:00 +11:00

README.rst

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

Path to local source directory.

Target path in AFS (should begin with '/afs/...').