Add example to use host parameters via Ansible

Author: maximiliankolb

guides/common/modules/proc_running-an-ansible-playbook.adoc

@@ -36,3 +36,4 @@ For more information, see xref:executing-a-remote-job_{context}[].
 For more information, see the following resources:
 ** xref:importing-an-ansible-playbook-by-name_{context}[]
 ** xref:importing-all-available-ansible-playbooks_{context}[]
+* xref:host-parameters-in-ansible-playbooks[]

guides/common/modules/ref_host-parameters-in-ansible-playbooks.adoc

@@ -0,0 +1,38 @@
+:_mod-docs-content-type: REFERENCE
+
+[id="host-parameters-in-ansible-playbooks"]
+= Host parameters in Ansible Playbooks
+
+You can use host parameters from {Project} in Ansible Playbooks.
+
+.Example Ansible Playbook to access host parameters
+[source, yaml, options="nowrap", subs="+quotes,verbatim,attributes"]
+----
+---
+- name: "Ansible Playbook to access host parameters"
+  hosts: all
+  tasks:
+    - name: "Use a host parameter"
+      ansible.builtin.debug:
+        var: hostvars[inventory_hostname]["_My_Host_Parameter_"]
+...
+----
+
+You can set the value of _My_Host_Parameter_ to an ERB template, for example, `<%= @host.capabilities.include?(:snapshots) %>`.
+When {Project} renders the Ansible Playbook, it will load the value of the variable _My_Host_Parameter_, render the ERB template, and provide the value to Ansible.
+
+.Example Ansible Playbook to use ERB templating
+[source, yaml, options="nowrap", subs="+quotes,verbatim,attributes"]
+----
+---
+- name: "Ansible Playbook to access host parameters and render the ERB template"
+  hosts: all
+  tasks:
+    - name: "Use ERB templating"
+      ansible.builtin.debug:
+        var: hostvars[inventory_hostname]["_My_Host_Parameter_"]
+...
+----
+
+.Additional resources
+* {ProvisioningDocURL}Host_Parameter_Hierarchy_provisioning[Host parameter hierarchy] in _{ProvisioningDocTitle}_

guides/doc-Managing_Configurations_Ansible/master.adoc

@@ -15,6 +15,8 @@ include::common/assembly_using-ansible-roles.adoc[leveloffset=+1]
 
 include::common/modules/proc_running-an-ansible-playbook.adoc[leveloffset=+1]
 
+include::common/modules/ref_host-parameters-in-ansible-playbooks.adoc[leveloffset=+2]
+
 include::common/assembly_configuring-and-setting-up-remote-jobs.adoc[leveloffset=+1]
 
 include::common/assembly_integrating-awx.adoc[leveloffset=+1]