Commit Graph

136 Commits (8c7ceaab816652cef68a25342d4ba51821d6500c)

Author SHA1 Message Date
Aaron Mortenson 5bba918052 added more documentation of loops with register (#16208) 9 years ago
James Cammarata b37b51dcea Fix variable precedence issue where set facts beat role params
Also updates doc on variable precedence, as it was incorrect for the
order of play vars/vars_prompt/vars_files in relation to set_fact and
registered variables.

Fixes #14702
Fixes #14826
9 years ago
Marius Gedminas b479a80d45 Document playbook_dir (#16166)
It was added back in 2013, in version 1.3: https://github.com/ansible/ansible/issues/4246
9 years ago
Toshio Kuratomi d45a394f63 Mocate ansible_ssh_changes into a common directory 9 years ago
nikut 54440a30c0 doc fix for delegate_to / ansible_host (issue #15546) (#15605) 9 years ago
Mengdi Gao bb037f033c Fix typo in variable docs 9 years ago
Strahinja Kustudić eed6cf5dad Adds 'ansible_check_mode' boolean magic variable
* Makes it possible to pass any options variable to VariableManager
  by changing `load_options_vars(options)` in `lib/ansible/utils/vars.py`
9 years ago
Brian Coca 84bbd2b4e3 corrected version added for ansible_version 9 years ago
Abhijit Menon-Sen 0c6693aa4c Merge pull request #14947 from mscherer/add_ansible_version_doc
Add doc on ansible_version, fix #13204
9 years ago
Abhijit Menon-Sen 00312723b2 Merge pull request #14484 from Antillean/extra-vars_docs
Documenting that extra-vars 'key=value' is for strings
9 years ago
Michael Scherer 8b808cab9e Add doc on ansible_version, fix #13204 9 years ago
Vladimir Rutsky 35880e6254 fix reference to chapter + trailing dot 9 years ago
Brian Coca b0bed27211 minor doc fixes 9 years ago
Matt Martz 38b663471d Merge pull request #14311 from sivel/unsafe-yaml-constructor
Add new 'unsafe' YAML constructor
9 years ago
Sandra Wills 11f081cb99 minor typo fix
missing "the" added to 2.x listing to match wording for 1.x
9 years ago
Sandra Wills c172a289e4 light editing of variable precedence list wording
QA had asked me a while ago to clean up the way the precedence list for 1.x was worded,
as the intro from the list started with "then comes", as if something should preceed
it. The comments from OxABAB were not helpful themselves, but his issue reminded me that
this was on my to do list to make a little cleaner and clearer.  Edits made to remove the
"then comes" intros for each list line, to help with clarity.
9 years ago
Kamal Wood 0c1395ed2f Documenting that values passed in using the extra-vars 'key=value' syntax are interpreted as strings. 9 years ago
Matt Martz 5cd4afaa1d Add documentation about the unsafe YAML tag 9 years ago
Usman Ehtesham Gul 4779f29777 Fix Doc mistake
Fix Doc mistake in ansible/docsite/rst/playbooks_variables.rst
9 years ago
sam-at-github a96a879fcf Add fullstop to make sentence make sense. Touch parargraph while at it. 9 years ago
Timothy Appnel fde7c14cd0 v1 variable precedence order was off.
Noticed that the v1 variable precedence docs list facts discovered as having a lower precedence than inventory variables. It is in reality the other way around. The v2 section gets this right.
9 years ago
Toshio Kuratomi 5e0d55ae5b Change the dict attribute collision warning to recommend using bracket notation 9 years ago
Robin Schneider ad0d299c56
Avoid key names which are valid attributes for data types in Python.
Closes #12990.

Alternative to #12992

This PR excludes all attributes of the following data types: lists,
tuples, dicts, sets, integers, floats, strings and Unicode objects.

It is expected that only the attributes of dicts and sets would cause an
problem like in #12990.
9 years ago
Sandra Wills bc14ed380e variables precedence reordering and added para to help explain precedence rules 9 years ago
Sandra Wills 8501a46baa vault and variables best practices info added, edited, and referenced
This work fulfills PR #11799. Moved the content out of the vault file,
into best practices, edited it, then referenced it from variables and
vaults content files.
9 years ago
Sandra Wills 32cb2fa215 removed repetition of note and replaced with an include directive
ansible_ssh_* changes from 1.9 to 2.0, original note made into a separate file
for easier editing, and an include for this new file added to each of the 6 file affected
by this change
9 years ago
Sandra Wills 748ff72b6b fixed typo, depricated --> deprecated, in all 6 notes 9 years ago
Sandra Wills f24fbb04c9 note modified a bit, then reviewed/approved by jmartin
Ansible 2.0 has depricated the “ssh” from ansible_ssh_user,
ansible_ssh_host, and ansible_ssh_port to become ansible_user,
ansible_host, and ansible_port. If you are using a version of
Ansible prior to 2.0, you should continue using the older style
variables (ansible_ssh_*). These shorter variables are ignored,
without warning, in older versions of Ansible.
9 years ago
Sandra Wills 6af2b2a4cb added note about ansible_ssh_* change
added a note like the following to each file hit with unlabled 2.0 changes...
Ansible 2.0 moved away from using ansible_ssh_* variables to accepting
ansible_* variables. If you are using a version of Ansible prior to 2.0,
you should continue using the older style variables (ansible_ssh_*), such
as ansible_ssh_user instead of ansible_user and ansible_ssh_port instead of
ansible_port, which appear in the following content. These shorter variables
are ignored, without warning, in older versions of Ansible.
9 years ago
Brian Coca 75f99f873b Merge pull request #12379 from bcoca/document_vars
Document vars

merging so we can push PRs against the common repo
9 years ago
Austin Ziegler 67a980c9ef Describe the units for fact_caching_timeout 9 years ago
Brian Coca 0aeaacb947 fixed zpellings 9 years ago
Brian Coca 4241df41aa fixed typoe (thanks @resmo) 9 years ago
Brian Coca 7f52d909c4 rewrote 1.x section of precedence to prevent promissing specificity to those reading docs for earlier versions 9 years ago
Brian Coca 6e34e84417 documenting var precedence
made new sections for vars, started explaining scope, gave example on command line override of connection vars
added some formatting changes and clarifications
9 years ago
Brian Coca 5c7bca9e17 Merge pull request #12369 from bborysenko/docsite/playbooks_variables
docs - minor fixes to playbooks_variables
9 years ago
Brian Coca 43ea5f0853 added note about registered variables 9 years ago
Borys Borysenko 6b396cdab7 fix code block quoting and boldface for modules name 9 years ago
Abhijit Menon-Sen f56a6e0951 Rename ansible_ssh_{host,port,user} in docs to ansible_*
The _ssh variants will continue to work, but the shorter, more generic
names are preferred now.
9 years ago
Brian Coca 827f2ff0ac corrected var name 9 years ago
Michael Scherer c2c20baf01 Add more explicit documentation on ansible_nodename and ansible_hostname
Fix #9971, based on text from Paul Czarkowski
9 years ago
Brian Coca 493d91cb55 Merge pull request #11531 from tamsky/tamsky-document-jsonfile
document `jsonfile` fact cache
9 years ago
Marc Tamsky aaf59319e4 document jsonfile and provide example config 9 years ago
Gerard Lynch 4942f18100 added role_path to magic var section 10 years ago
Peter Parente 2aba3b4172 Fix typo: "name" to "role" 10 years ago
Maciej Delmanowski c866a26d81 Move Jinja2 filters documentation to separate file 10 years ago
Brian Coca 62a6378c4a Merge pull request #8792 from bcoca/ternary_filter
ternary filter
10 years ago
Brian Coca f05a1085e9 Merge pull request #9249 from tjanez/doc-add_note_about_escaping_with_regex_replace
Added a note about escaping backreferences when using 'regex_replace' filter
10 years ago
Björn Andersson 65e4f2b2bc Add filter to turn a string into a UUID
This filter was made because I needed to create idempotent UUIDs when
installing the agent for Go (http://go.cd), which uses UUIds to
distinguish the agents from each other.

It uses a newly created Ansible namespace to distinguish UUIDs created
by Ansible from any other source. The new namespace is a random one
created by uuidgen on OSX.
10 years ago
Brian Coca 2a9d5054bf Merge pull request #9995 from bcoca/hash_filters
Hash filters
10 years ago