From 3beb50a3b37a2b3d733af96664389edd0bb93084 Mon Sep 17 00:00:00 2001 From: Clark Boylan Date: Thu, 11 Jun 2020 13:54:19 -0700 Subject: [PATCH] Add bit more info on disabling ansible runs We've got a section on using the emergency file and disabled ansible group. Add info about the special DISABLE-ANSIBLE file there to help make that info easier to find. Change-Id: I2e750b9b87ca7a4f800d3ac161a195d49543a7da --- doc/source/sysadmin.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/source/sysadmin.rst b/doc/source/sysadmin.rst index 06759b3ff6..b93cc3ff2b 100644 --- a/doc/source/sysadmin.rst +++ b/doc/source/sysadmin.rst @@ -467,6 +467,13 @@ attempting to run it during the regular zuul jobs. If you choose to run puppet manually on a host, take care to ensure that it has not been disabled at the bridge level first. +If you need to pause all execution of ansible playbooks by Zuul you can +run the utility script ``disable-ansible``. The script touches the file +``/home/zuul/DISABLE-ANSIBLE`` on bridge.openstack.org. Doing +this forces the Zuul jobs that run ansible for us to wait until that file is +removed. This acts like a global pause. The script exists to prevent admins +from misspelling the name of the file and is recommended. + Examples --------