Skip to content

Commit b212e3a

Browse files
committed
Fixes #38335 - Document Ansible Diff Mode template option
1 parent 84a3b59 commit b212e3a

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

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,13 @@ endif::[]
3434
ifdef::satellite[]
3535
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_.
3636
endif::[]
37+
.. 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 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.
38+
ifndef::satellite[]
39+
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_.
40+
endif::[]
41+
ifdef::satellite[]
42+
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_.
43+
endif::[]
3744
. Click the *Location* tab and add the locations where you want to use the template.
3845
. Click the *Organizations* tab and add the organizations where you want to use the template.
3946
. Click *Submit* to save your changes.

0 commit comments

Comments
 (0)