From 89c3151167324edcf6d8d22e442feb67bb81010e Mon Sep 17 00:00:00 2001
From: Matt Martz <matt@sivel.net>
Date: Thu, 15 Jun 2017 09:51:34 -0500
Subject: [PATCH] Give example of empty _meta in dyanmic inventory (#24085)
---
docs/docsite/rst/dev_guide/developing_inventory.rst | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/docs/docsite/rst/dev_guide/developing_inventory.rst b/docs/docsite/rst/dev_guide/developing_inventory.rst
index 8945a7e8b1a..1a03f21706b 100644
--- a/docs/docsite/rst/dev_guide/developing_inventory.rst
+++ b/docs/docsite/rst/dev_guide/developing_inventory.rst
@@ -86,6 +86,18 @@ The data to be added to the top level JSON dictionary looks like this::
}
}
+To satisfy the requirements of using ``_meta``, to prevent ansible from calling your inventory with ``--host`` you must at least populate ``_meta`` with an empty ``hostvars`` dictionary, such as::
+
+ {
+
+ # results of inventory script as above go here
+ # ...
+
+ "_meta": {
+ "hostvars": {}
+ }
+ }
+
.. seealso::
:doc:`developing_api`