Merge "Correct emergency file reference in launch script"

doc/source/sysadmin.rst

@@ -468,12 +468,12 @@ expected. Globs, group names and server UUIDs should all be acceptable input.
 
 If you need to disable a host immediately without waiting for a patch to land
 to `system-config`, there is a file on the bridge host,
-`/etc/ansible/hosts/emergency` that can be edited directly.
+`/etc/ansible/hosts/emergency.yaml` that can be edited directly.
 
-`/etc/ansible/hosts/emergency` is a file that should normally be empty, but
-the contents are not managed by puppet. It's purpose is to allow for disabling
-puppet at times when landing a change to the puppet repo would be either
-unreasonable or impossible.
+`/etc/ansible/hosts/emergency.yaml` is a file that should normally be empty,
+but the contents are not managed by puppet. It's purpose is to allow for
+disabling puppet at times when landing a change to the puppet repo would be
+either unreasonable or impossible.
 
 There are two sections in the emergency file, `disabled` and
 `disabled:children`. To disable a single host, put it in `disabled`. If you
@@ -492,12 +492,15 @@ Examples
 
 To disable an OpenStack instance called `amazing.openstack.org` temporarily
 without landing a puppet change, ensure the following is in
-`/etc/ansible/hosts/emergency`
+`/etc/ansible/hosts/emergency.yaml`
 
 ::
 
-  [disabled]
-  amazing.openstack.org
+  # Please add an inline comment so we know who added the host and why
+  plugin: yamlgroup
+  groups:
+    disabled:
+      - foo.opendev.org # 2020-05-23 bob is testing change 654321
 
 To disable a group of hosts in the emergency file, such as all of the pypi
 hosts.

launch/launch-node.py

@@ -180,7 +180,7 @@ def bootstrap_server(server, key, name, volume_device, keep,
             jobdir.inventory_root,
             '/opt/system-config/inventory/openstack.yaml',
             '/opt/system-config/inventory/groups.yaml',
-            '/opt/system-config/inventory/emergency.yaml',
+            '/etc/ansible/hosts/emergency.yaml',
         )
         inventory_cmds = [v for e in inventory_list for v in ('-i', e)]
         ansible_cmd = ['ansible-playbook', '--flush-cache' ] + \