Skip to content

Commit a6abd6c

Browse files
committed
Fixes #38335 - Document Ansible Diff Mode template option
1 parent 8e2d9f2 commit a6abd6c

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

guides/common/modules/proc_creating-a-job-template.adoc

+7
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,13 @@ endif::[]
3232
ifdef::satellite[]
3333
For more information on Ansible check mode, see {RHDocsBaseURL}red_hat_ansible_automation_platform/latest/html-single/using_automation_execution/index[Using automation execution] in _Red{nbsp}Hat Ansible Automation Platform documentation_.
3434
endif::[]
35+
.. Select *Enable Ansible Diff Mode* to run jobs based on the template in Ansible diff mode, which reports detailed changes Ansible tasks make _if_ the underlying Ansible modules supports Ansible diff mode. If a module does not support Ansible diff mode, then the parent task will only report that a change occurred and nothing else. When used in conjunction with Ansible check mode, the Ansible playbook tasks report changes they _would_ have made to the host, and no changes are made to the host. Please note that if a task is used to deploy credentials and the task supports Ansible diff mode, then changes to the credentials _may_ be reported in clear text. This can be mitigated by adding `diff: false` or `no_log: true` to the task in question which will prevent change reports for that task.
36+
ifndef::satellite[]
37+
For more information on Ansible diff mode, see link:https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_checkmode.html[Validating tasks: check mode and diff mode] in _Ansible Documentation_.
38+
endif::[]
39+
ifdef::satellite[]
40+
For more information on Ansible diff mode, see {RHDocsBaseURL}red_hat_ansible_automation_platform/latest/html-single/using_automation_execution/index[Using automation execution] in _Red{nbsp}Hat Ansible Automation Platform documentation_.
41+
endif::[]
3542
. Click the *Location* tab and add the locations where you want to use the template.
3643
. Click the *Organizations* tab and add the organizations where you want to use the template.
3744
. Click *Submit* to save your changes.

0 commit comments

Comments
 (0)