diff options
author | James Cammarata <jimi@sngx.net> | 2015-10-29 10:45:05 -0400 |
---|---|---|
committer | James Cammarata <jimi@sngx.net> | 2015-10-29 10:45:05 -0400 |
commit | 27dc7e11a4e6778b30d0611a4c3ae15290ffc17b (patch) | |
tree | 769fdb695e53f9fe61dcda989a1637e7a0450e8b | |
parent | 061b83cd749ab513f2c7df10c591c4fbf838798e (diff) | |
parent | 097adec834368ff0bae2a9829be536355650e198 (diff) | |
download | ansible-27dc7e11a4e6778b30d0611a4c3ae15290ffc17b.tar.gz |
Merge pull request #12953 from larsks/bug/7890
add documentation for with_file loops
-rw-r--r-- | docsite/rst/playbooks_loops.rst | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/docsite/rst/playbooks_loops.rst b/docsite/rst/playbooks_loops.rst index fef48ca49a..b25e95941e 100644 --- a/docsite/rst/playbooks_loops.rst +++ b/docsite/rst/playbooks_loops.rst @@ -93,6 +93,35 @@ And you want to print every user's name and phone number. You can loop through .. _looping_over_fileglobs: +Looping over Files +`````````````````` + +``with_file`` iterates over a list of files, setting `item` to the content of each file in sequence. It can be used like this:: + + --- + - hosts: all + + tasks: + + # emit a debug message containing the content of each file. + - debug: + msg: "{{item}}" + with_file: + - first_example_file + - second_example_file + +Assuming that ``first_example_file`` contained the text "hello" and ``second_example_file`` contained the text "world", this would result in:: + + TASK [debug msg={{item}}] ****************************************************** + ok: [localhost] => (item=hello) => { + "item": "hello", + "msg": "hello" + } + ok: [localhost] => (item=world) => { + "item": "world", + "msg": "world" + } + Looping over Fileglobs `````````````````````` |