knowledge/technology/tools/Ansible/lookups/ansible.builtin.file.md
2023-12-04 11:02:23 +01:00

22 lines
No EOL
1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ansible.builtin.file
This lookup returns the contents from a file on the Ansible controllers file system.
## Parameters
| Parameter | Type | Description |
| ---------- | ----------------- | ---------------------------------------------------------------------------- |
| **Input** | string / required | path(s) of files to read |
| **lstrip** | boolean | whether or not to remove whitespace from the beginning of the looked-up file |
| **rstrip** | boolean | whether or not to remove whitespace from the ending of the looked-up file |
## Examples
```yml
- ansible.builtin.debug:
msg: "the value of foo.txt is {{ lookup('ansible.builtin.file', '/etc/foo.txt') }}"
- name: display multiple file contents
ansible.builtin.debug: var=item
with_file:
- "/path/to/foo.txt"
- "bar.txt" # will be looked in files/ dir relative to play or in role
- "/path/to/biz.txt"
```