diff options
author | Dag Wieers <dag@wieers.com> | 2019-01-23 17:25:24 +0100 |
---|---|---|
committer | Toshio Kuratomi <a.badger@gmail.com> | 2019-01-24 10:37:00 -0800 |
commit | f67081e97be45f711c70e311f67ac9b26321361e (patch) | |
tree | 482d2516d612eb4748ee20350ceb73855fd06e12 /docs/docsite | |
parent | bb28719541bac177a8c64e913d36cbef34582b52 (diff) | |
download | ansible-f67081e97be45f711c70e311f67ac9b26321361e.tar.gz |
Clarify gather_facts and highlight important lines
Clarify gather_facts and highlight important lines
+label: docsite_pr
Diffstat (limited to 'docs/docsite')
-rw-r--r-- | docs/docsite/rst/scenario_guides/guide_aci.rst | 20 |
1 files changed, 19 insertions, 1 deletions
diff --git a/docs/docsite/rst/scenario_guides/guide_aci.rst b/docs/docsite/rst/scenario_guides/guide_aci.rst index 9ba6feaf70..6da6cb4d98 100644 --- a/docs/docsite/rst/scenario_guides/guide_aci.rst +++ b/docs/docsite/rst/scenario_guides/guide_aci.rst @@ -109,11 +109,27 @@ As originally designed, Ansible modules are shipped to and run on the remote tar For this very reason, the modules need to run on the local Ansible controller (or are delegated to another system that *can* connect to the APIC). +Gathering facts +``````````````` +Because we run the modules on the Ansible controller gathering facts will not work. That is why when using these ACI modules it is mandatory to disable facts gathering. You can do this globally in your ``ansible.cfg`` or by adding ``gather_facts: no`` to every play. + +.. code-block:: yaml + :emphasize-lines: 3 + + - name: Another play in my playbook + hosts: my-apic-1 + gather_facts: no + tasks: + - name: Create a tenant + aci_tenant: + ... + Delegating to localhost ``````````````````````` So let us assume we have our target configured in the inventory using the FQDN name as the ``ansible_host`` value, as shown below. .. code-block:: yaml + :emphasize-lines: 3 apics: my-apic-1: @@ -124,6 +140,7 @@ So let us assume we have our target configured in the inventory using the FQDN n One way to set this up is to add to every task the directive: ``delegate_to: localhost``. .. code-block:: yaml + :emphasize-lines: 8 - name: Query all tenants aci_tenant: @@ -145,6 +162,7 @@ Another option frequently used, is to tie the ``local`` connection method to thi In this case the inventory may look like this: .. code-block:: yaml + :emphasize-lines: 6 apics: my-apic-1: @@ -343,6 +361,7 @@ Use signature-based authentication with Ansible You need the following parameters with your ACI module(s) for it to work: .. code-block:: yaml + :emphasize-lines: 2,3 username: admin private_key: pki/admin.key @@ -498,7 +517,6 @@ The below example waits until the cluster is fully-fit. In this example you know infrawinode.imdata[0].infraWiNode.attributes.health == 'fully-fit' and infrawinode.imdata[1].infraWiNode.attributes.health == 'fully-fit' and infrawinode.imdata[2].infraWiNode.attributes.health == 'fully-fit' - # all(apic.infraWiNode.attributes.health == 'fully-fit' for apic in infrawinode.imdata) retries: 30 delay: 30 |