Add more explicit documentation on ansible_nodename and ansible_hostname

Fix #9971, based on text from Paul Czarkowski
This commit is contained in:
Michael Scherer 2015-07-25 14:20:07 +02:00
parent 8509f22839
commit c2c20baf01

View file

@ -308,7 +308,7 @@ This will return a ginormous amount of variable data, which may look like this,
"type": "ether" "type": "ether"
}, },
"ansible_form_factor": "Other", "ansible_form_factor": "Other",
"ansible_fqdn": "ubuntu2", "ansible_fqdn": "ubuntu2.example.com",
"ansible_hostname": "ubuntu2", "ansible_hostname": "ubuntu2",
"ansible_interfaces": [ "ansible_interfaces": [
"lo", "lo",
@ -353,6 +353,7 @@ This will return a ginormous amount of variable data, which may look like this,
"size_total": 20079898624 "size_total": 20079898624
} }
], ],
"ansible_nodename": "ubuntu2.example.com",
"ansible_os_family": "Debian", "ansible_os_family": "Debian",
"ansible_pkg_mgr": "apt", "ansible_pkg_mgr": "apt",
"ansible_processor": [ "ansible_processor": [
@ -387,8 +388,11 @@ In the above the model of the first harddrive may be referenced in a template or
Similarly, the hostname as the system reports it is:: Similarly, the hostname as the system reports it is::
{{ ansible_hostname }} {{ ansible_nodename }}
and the unqualified hostname shows the string before the first period(.)::
{{ ansible_hostname }}
Facts are frequently used in conditionals (see :doc:`playbooks_conditionals`) and also in templates. Facts are frequently used in conditionals (see :doc:`playbooks_conditionals`) and also in templates.