From 2e33459b3e8681fc5b19775d7ebe394237b102f9 Mon Sep 17 00:00:00 2001
From: Monty Taylor <mordred@inaugust.com>
Date: Fri, 21 Feb 2020 17:24:44 -0600
Subject: [PATCH] Add pause-buildset-registry role

This is a simple utility that provides the zuul_return functionality
for repos that need it encapsulating the existence of zuul_return.

For instance, system-config wanted to start doing this in a playbook
but linting the playbooks became super hard because of the new need
to have zuul installed for the zuul_return library. Just keep it here
in the family.

Change-Id: I6035009455f6434c2d6cfd976c7c6f414bdc2ae7
---
 doc/source/container-roles.rst                |  1 +
 roles/pause-buildset-registry/README.rst      | 10 ++++++++++
 roles/pause-buildset-registry/tasks/main.yaml | 10 ++++++++++
 3 files changed, 21 insertions(+)
 create mode 100644 roles/pause-buildset-registry/README.rst
 create mode 100644 roles/pause-buildset-registry/tasks/main.yaml

diff --git a/doc/source/container-roles.rst b/doc/source/container-roles.rst
index d2d7a7f3f..ac334b032 100644
--- a/doc/source/container-roles.rst
+++ b/doc/source/container-roles.rst
@@ -9,6 +9,7 @@ Container Roles
 .. zuul:autorole:: install-kubernetes
 .. zuul:autorole:: install-openshift
 .. zuul:autorole:: install-podman
+.. zuul:autorole:: pause-buildset-registry
 .. zuul:autorole:: promote-docker-image
 .. zuul:autorole:: pull-from-intermediate-registry
 .. zuul:autorole:: push-to-intermediate-registry
diff --git a/roles/pause-buildset-registry/README.rst b/roles/pause-buildset-registry/README.rst
new file mode 100644
index 000000000..695bb8858
--- /dev/null
+++ b/roles/pause-buildset-registry/README.rst
@@ -0,0 +1,10 @@
+Pause a buildset registry
+
+Utility role to pause a job providing a buildset registry.
+
+**Role Variables**
+
+.. zuul:rolevar:: buildset_registry
+
+   Location of external buildset registry. If this is defined,
+   the job will not pause.
diff --git a/roles/pause-buildset-registry/tasks/main.yaml b/roles/pause-buildset-registry/tasks/main.yaml
new file mode 100644
index 000000000..e7c1a26fa
--- /dev/null
+++ b/roles/pause-buildset-registry/tasks/main.yaml
@@ -0,0 +1,10 @@
+# If buildset_registry is defined, that means a parent job is running it;
+# only if it is not defined does it mean that we are running it.  If we
+# are running it, pause the job so that child jobs will automatically
+# use it.
+- name: Pause the job
+  when: buildset_registry is not defined
+  zuul_return:
+    data:
+      zuul:
+        pause: true