Docs: code-block wrapping for playbooks_module_defaults.rst #75936 (#75942)

pull/76012/head
Tamas Szabo 3 years ago committed by GitHub
parent a2ff765e06
commit 81eec4a05a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -5,7 +5,9 @@ Module defaults
If you frequently call the same module with the same arguments, it can be useful to define default arguments for that particular module using the ``module_defaults`` keyword. If you frequently call the same module with the same arguments, it can be useful to define default arguments for that particular module using the ``module_defaults`` keyword.
Here is a basic example:: Here is a basic example:
.. code-block:: YAML
- hosts: localhost - hosts: localhost
module_defaults: module_defaults:
@ -29,7 +31,9 @@ Here is a basic example::
state: touch state: touch
path: /tmp/file3 path: /tmp/file3
The ``module_defaults`` keyword can be used at the play, block, and task level. Any module arguments explicitly specified in a task will override any established default for that module argument:: The ``module_defaults`` keyword can be used at the play, block, and task level. Any module arguments explicitly specified in a task will override any established default for that module argument.
.. code-block:: YAML
- block: - block:
- name: Print a message - name: Print a message
@ -39,7 +43,9 @@ The ``module_defaults`` keyword can be used at the play, block, and task level.
ansible.builtin.debug: ansible.builtin.debug:
msg: "Default message" msg: "Default message"
You can remove any previously established defaults for a module by specifying an empty dict:: You can remove any previously established defaults for a module by specifying an empty dict.
.. code-block:: YAML
- name: Create file1 - name: Create file1
ansible.builtin.file: ansible.builtin.file:
@ -53,7 +59,9 @@ You can remove any previously established defaults for a module by specifying an
Here are some more realistic use cases for this feature. Here are some more realistic use cases for this feature.
Interacting with an API that requires auth:: Interacting with an API that requires auth.
.. code-block:: YAML
- hosts: localhost - hosts: localhost
module_defaults: module_defaults:
@ -74,7 +82,9 @@ Interacting with an API that requires auth::
ansible.builtin.uri: ansible.builtin.uri:
url: http://some.api.host/v1/whatever3 url: http://some.api.host/v1/whatever3
Setting a default AWS region for specific EC2-related modules:: Setting a default AWS region for specific EC2-related modules.
.. code-block:: YAML
- hosts: localhost - hosts: localhost
vars: vars:

Loading…
Cancel
Save