18 Commits (6cfd198b13929e5297aa95d0371e49d73ca6bf74)

Author	SHA1	Message	Date
scottb	6ac9d05de6	Removing obsolete version behavior callout notes - initial pass. (#33172) ... * Removing obsolete version behavior callout notes - initial pass. * Fixed example text punctuation. * Removed old version callout. * Typo fix * Updated example * Fixed awkward sentence * Fixed incorrect feature name * Reinstated current version callout	7 years ago
Brian Coca	52c97a1cf4	added doc notes about vars plugins in precedence	7 years ago
Brian Coca	41685fb516	fix precedence issue with facts and vars (#32302) ... avoid making gathered facts high precedence, only set_fact is supposed to be. vars set via set_fact with cacheable are higher precedence than plain facts. Previously (after 6fbd0a8bb5) regular facts would end up with a higher precedence than host or play vars, but they should not be. Facts were getting added to 'non_persistent_facts' (equivalent to 'register' vars) which is higher precedence than facts should be. added 'cacheable set_facts' to precedence docs 'ansible_facts_cacheable' -> '_ansible_facts_cacheable' (made 'private')	7 years ago
Abhijit Menon-Sen	a84545dc33	Fix typo	7 years ago
Gregory M. Dulin	29a5938fb1	Update --extra-vars documentation. Fixes #11647 (#31433) ... * Update --extra-vars documentation to address #11647 * Fix some grammar * Fix indentation * Reshuffle and add versionadded tags * Remove code-block tags * Add lf after versionadded lines	7 years ago
Brian Coca	b233f3f296	updated plugin docs (#30490) ... * updated docs - for devs: - added inventory/vars section - made some updates to general section and other plugin types - for users: - added 'user' plugin section to start describing the plugins - docs on types, what they are and how to use - removed ref to deleted AUTHORS file - corrected several typos/headers - added descriptions to config.rst template - ignore generated files for cli/plugins and config - remove new generated files on `make clean` - moved details from devguid and intro doc to plugin specific pages - pretied up lookup notes - changed precedence ref to not conflict config - removed duplicate config data, as config is autogenerated and up to date - put new plugins under playbooks - added `pass` cause rst/python dislikes fractions - removed dupe in .gitignore, alpha sorted to avoid moar dupes - added try cause rst/python freaks out * generate plugins into their own dir only do plugins that support docs use toctree from main plugins page	7 years ago
Brian Coca	48da0597c0	document ansible_group_priority (#28777) ... * document ansible_group_priority * Copy edit pass	7 years ago
James Cammarata	483df9c5f8	Imports and includes (#25399) ... Initial commit to split includes into static imports/dynamic includes This implements the new include/import syntax for Ansible 2.4: * include_{tasks,role,variables} = dynamic * import_{playbook,tasks,role} = static The old bare `include` will be considered deprecated, as will any use of the `static: {yes|no}` option. This also adds docs for import/include and reorganizing the "Playbook Reuse" section of the documentation.	7 years ago
Brian Coca	8f97aef1a3	Transition inventory into plugins (#23001) ... * draft new inventory plugin arch, yaml sample - split classes, moved out of init - extra debug statements - allow mulitple invenotry files - dont add hosts more than once - simplified host vars - since now we can have multiple, inventory_dir/file needs to be per host - ported yaml/script/ini/virtualbox plugins, dir is 'built in manager' - centralized localhost handling - added plugin docs - leaner meaner inventory (split to data + manager) - moved noop vars plugin - added 'postprocessing' inventory plugins - fixed ini plugin, better info on plugin run group declarations can appear in any position relative to children entry that contains them - grouphost_vars loading as inventory plugin (postprocessing) - playbook_dir allways full path - use bytes for file operations - better handling of empty/null sources - added test target that skips networking modules - now var manager loads play group/host_vars independant from inventory - centralized play setup repeat code - updated changelog with inv features - asperioribus verbis spatium album - fixed dataloader to new sig - made yaml plugin more resistant to bad data - nicer error msgs - fixed undeclared group detection - fixed 'ungrouping' - docs updated s/INI/file/ as its not only format - made behaviour of var merge a toggle - made 'source over group' path follow existing rule for var precedence - updated add_host/group from strategy - made host_list a plugin and added it to defaults - added advanced_host_list as example variation - refactored 'display' to be availbe by default in class inheritance - optimized implicit handling as per @pilou's feedback - removed unused code and tests - added inventory cache and vbox plugin now uses it - added _compose method for variable expressions in plugins - vbox plugin now uses 'compose' - require yaml extension for yaml - fix for plugin loader to always add original_path, even when not using all() - fix py3 issues - added --inventory as clearer option - return name when stringifying host objects - ajdust checks to code moving * reworked vars and vars precedence - vars plugins now load group/host_vars dirs - precedence for host vars is now configurable - vars_plugins been reworked - removed unused vars cache - removed _gathered_facts as we are not keeping info in host anymore - cleaned up tests - fixed ansible-pull to work with new inventory - removed version added notation to please rst check - inventory in config relative to config - ensures full paths on passed inventories * implicit localhost connection local	7 years ago
Toshio Kuratomi	82ad8ff081	Add documentation of Jinja2 templating idioms that differ when run under Python3 ... Fixes #19514	8 years ago
Strahinja Kustudic	74e385e43a	Move include_vars to host scope (#23868) ... * Move include_vars to host scope Module include_vars actually sets variables on a host level, and not the play level. * Expand vars entires	8 years ago
James Cammarata	a2599cab79	Fix variable precedence of INI/script vars to be in-line with docs. ... This commit also adds a new test script (ansible-var-precedence-check.py in code-smell/) to provide us with another line of defense against precedence bugs going forward. The precedence docs state that the INI vars have a lower precedence than group/host vars files for inventory and playbooks, however that has not been the case since 2.0 was released. This change fixes that in one way, though not exactly as the docs say. The rules are: 1) INI/script < inventory dir < playbook dir 2) "all" group vars < other group_vars < host_vars So the new order will be (from the test script mentioned above): 8. pb_host_vars_file - var in playbook/host_vars/host 9. ini_host_vars_file - var in inventory/host_vars/host 10. ini_host - host var inside the ini 11. pb_group_vars_file_child - var in playbook/group_vars/child 12. ini_group_vars_file_child - var in inventory/group_vars/child 13. pb_group_vars_file_parent - var in playbook/group_vars/parent 14. ini_group_vars_file_parent - var in inventory/group_vars/parent 15. pb_group_vars_file_all - var in playbook/group_vars/all 16. ini_group_vars_file_all - var in inventory/group_vars/all 17. ini_child - child group var inside the ini 18. ini_parent - parent group var inside the ini 19. ini_all - all group var inside the ini Fixes #21845	8 years ago
scottb	0bd2714122	Update playbooks_variables.rst ... Minor edits	8 years ago
Brian Coca	cf3edf0989	more examples and clearer override docs for conn ... fixes #21866	8 years ago
Alvaro Aleman	1b2ad94496	Configurable fact path (#18147) ... * Make fact_path configurable * Add docs for fact_path * Add tests for localfacts * Default fact gathering settings in PlayContext	8 years ago
Toshio Kuratomi	adb7426c0c	Some more code-block fixes	8 years ago
John R Barker	7df31aaca1	Fix all RST errors for docs/docsite/rst (#20005) ... * developing_modules.rst is now in dev_guide, sync changes and delete the old version * Cleaner RST & formatted code * Tidyup roadmaps * Link to repomerge * Pull in abadger's fixes From https://github.com/ansible/ansible/compare/docs-code-block-fixes?expand=1 * Clean docsite/rst (apart from ROADMAP	8 years ago
Brian Coca	57f8b791d6	consolidated docs ... point to new doc locations removed non existing dirs	8 years ago