added more documentation of loops with register (#16208)

This commit is contained in:
Aaron Mortenson 2016-06-09 13:13:51 -04:00 committed by Brian Coca
parent e81f14ab48
commit 5bba918052

View file

@ -599,6 +599,8 @@ While it's mentioned elsewhere in that document too, here's a quick syntax examp
Registered variables are valid on the host the remainder of the playbook run, which is the same as the lifetime of "facts"
in Ansible. Effectively registered variables are just like facts.
When using ``register`` with a loop the data structure placed in the variable during a loop, will contain a ``results`` attribute, that is a list of all responses from the module. For a more in-depth example of how this works, see the :doc:`playbook_loops` section on using register with a loop.
.. note:: If a task fails or is skipped, the variable still is registered with a failure or skipped status, the only way to avoid registering a variable is using tags.
.. _accessing_complex_variable_data: