Ansible Task Looping Directives: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
Line 6: Line 6:
=Loops=
=Loops=
==<tt>with_items</tt>==
==<tt>with_items</tt>==
An iterator whose elements can be accessed with <code>item.<element></code>.
An iterator whose elements can be accessed with <code>item.<element></code>. The content to iterate over may came from in-line declaration or from a variable.
 
In-line declaration:
 
Variable:
 
==<tt>loop</tt>==
==<tt>loop</tt>==
Takes a list for the task to iterate over, saving each list element into the <code>item</code> variable (configurable via <code>[[#loop_control|loop_control]]</code>)
Takes a list for the task to iterate over, saving each list element into the <code>item</code> variable (configurable via <code>[[#loop_control|loop_control]]</code>)

Revision as of 04:16, 5 July 2021

External

Internal

Overview

Loops

with_items

An iterator whose elements can be accessed with item.<element>. The content to iterate over may came from in-line declaration or from a variable.

In-line declaration:

Variable:

loop

Takes a list for the task to iterate over, saving each list element into the item variable (configurable via loop_control)

jdks:
  - corretto8
  - corretto11
...
- name: Multiple items in a loop
  homebrew_cask:
    name: "{{ item }}"
    state: present
  loop: "{{ jdks }}"

An existing variable's field that reference a list can be used:

- name: Debug
  debug:
    var: item.path
    loop: "{{ some_task_result.files }}"

loop_control

with_<lookup_plugin>

The same as loop but adds the output of any lookup plugin to generate the item list.