ansible.builtin.config – Lookup current Ansible configuration values

• Synopsis
• Parameters
• Examples
• Return Values

Synopsis

• Retrieves the value of an Ansible configuration setting.
• You can use ansible-config list to see all available settings.

Parameters

Parameter	Choices/Defaults	Configuration	Comments
_terms string / required			The key(s) to look up
on_missing string	Choices: error ← skip warn		action to take if term is missing from config Error will raise a fatal error Skip will just ignore the term Warn will skip over it but issue a warning

Examples

- name: Show configured default become user
  debug: msg="{{ lookup('config', 'DEFAULT_BECOME_USER')}}"

- name: print out role paths
  debug:
    msg: "These are the configured role paths: {{lookup('config', 'DEFAULT_ROLES_PATH')}}"

- name: find retry files, skip if missing that key
  find:
    paths: "{{lookup('config', 'RETRY_FILES_SAVE_PATH')|default(playbook_dir, True)}}"
    patterns: "*.retry"

- name: see the colors
  debug: msg="{{item}}"
  loop: "{{lookup('config', 'COLOR_OK', 'COLOR_CHANGED', 'COLOR_SKIP', wantlist=True)}}"

- name: skip if bad value in var
  debug: msg="{{ lookup('config', config_in_var, on_missing='skip')}}"
  var:
    config_in_var: UNKNOWN

Return Values

Common return values are documented here, the following are the fields unique to this lookup:

Key	Returned	Description
_raw any	success	value(s) of the key(s) in the config

Authors

• Ansible Core Team