Commit graph

1814 commits

Author SHA1 Message Date
Sandra Wills
59456af8be attempting to wrangle feedback from git comments.
please edit specific lines when possible to ensure your feedback
is incorporated properly. thanks!
2016-04-13 13:57:04 -04:00
Sandra Wills
640f4e79bd trying the new content in the checklist instead of new sections
per bcoca's comment, thought I would move the new content to the checklist
to see if you guys think this is a better treatment.
2016-04-13 13:55:35 -04:00
Sandra Wills
c3a086a55e adding links and anchors for links, referencing check mode 2016-04-13 13:51:29 -04:00
Sandra Wills
f9d9cb8245 start of merge from google doc and team comments, module guidelines as focus, added a link anchor as needed 2016-04-13 13:51:25 -04:00
Toshio Kuratomi
dcc5dfdf81 Controller-side module caching.
This makes our recursive, ast.parse performance measures as fast as
pre-ziploader baseline.

Since this unittest isn't testing that the returned module data is
correct we don't need to worry about os.rename not having any module
data.  Should devise a separate test for the module and caching code
2016-04-12 08:01:07 -07:00
Toshio Kuratomi
8d60b298a4 Core module program flow and glossary (#15355)
* Reformat glossary as a sphinx glossary so that :term: will work.

* Add a document decribing program flow for executing modules

* Feedback from @docschick

* More feedback from docschick for the Program Flow: Modules doc

* Changes to address docschick's feedback on the glossary

* Add note section for async plugin

* make singular
2016-04-11 15:24:37 -07:00
Sandra Wills
40d0bb7aef Merge pull request #15361 from gaomd/patch-1
Fix typo in variable docs
2016-04-11 16:46:07 -04:00
jjshoe
f713a5412a Document argument true/false preferences 2016-04-11 12:05:34 -05:00
Reedik Tuuling
2f90d3721c Add installing with pip from git (#15366)
It is also possible to install with pip from the latest development branch in git. Not sure about the wording tho.
2016-04-11 11:35:58 -04:00
Jason McKerr
95d5c43a27 Update committer_guidelines.rst 2016-04-11 10:22:20 -04:00
Mengdi Gao
bb037f033c Fix typo in variable docs 2016-04-11 01:07:39 +08:00
Kishin Yagami
e4a6106ea5 Add debug strategy plugin (#15125)
* Add debug strategy plugin

* Fix Python 2-3 compatiblity issue

* Add document for debug strategy
2016-04-08 14:39:08 -04:00
Rickard von Essen
1f82c2c4a8 Add link to both Ansible local and Ansible remote provisioner introduced in Packer 0.9.0 (#15335) 2016-04-08 10:55:23 -04:00
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`
2016-04-08 00:26:02 +02:00
Zacharias Thompson
5afb0a222b Update porting_guide_2.0.rst
Small fix to the porting guide, in order to get the playbook name the correct attribute is ._file_name instead of ._filename.
2016-04-07 11:27:38 -04:00
Jason McKerr
c7d4ff906b Update committer_guidelines.rst
adding Trond and Jon H
2016-04-06 13:23:39 -04:00
James Cammarata
040893a677 Adding a config option to allow disabling locale settings upon module exec
Fixes #15138
2016-04-06 12:19:22 -04:00
Brian Coca
81a4df6206 updated docs to reflect new retry path
fixes #15269
2016-04-04 16:32:21 -04:00
Dag Wieers
1f680f311b Move the section up, near another newline-related section
Also specificaly state that this happens when templating (only), not just every time.
2016-04-01 16:07:27 +02:00
Dag Wieers
0e182728f2 Document the behavioral change (bugfix) that converted DOS-type text files to Unix-type 2016-04-01 15:50:58 +02:00
Brian Coca
dec15523bd Merge pull request #15222 from docschick/devel
adding print stylesheet to theme.css for better HTML to PDF printing
2016-03-31 16:04:02 -04:00
Sandra Wills
3059272008 testing another revert: Revert "minor change, adding markup for cleaner view"
This reverts commit 1bf15176d8.
Attempting to get this commit/PR clean so that it will only include the print stylesheet (commit 94eeff7)
2016-03-31 12:36:11 -04:00
Sandra Wills
283a32340b testing a revert : Revert "playbook variables precedence list light edits"
This reverts commit 17f7e6162a.
2016-03-31 12:34:44 -04:00
Sandra Wills
1bf15176d8 minor change, adding markup for cleaner view
adding additinal header markup character to prevent "over highlighting" that globbed the docs
2016-03-31 12:30:02 -04:00
Sandra Wills
94eeff7196 updating stylesheet to make printing cleaner from HTML
Tima had feedback that saving the HMTL to a PDF wasn't ideal for printing, as the marking ad
took up 1/3 of the page. We've cleaned up the ad as well as streamlined printing a bit (removing
color backgrounds from admonitions and adding black text, exposing links, etc.)
2016-03-31 12:22:35 -04:00
Zhuoyun Wei
1a13fb63c6 Fix a typo 2016-03-30 19:05:13 +08:00
Jason McKerr
2e529d7a51 Update committer_guidelines.rst
Adding Chris Houseknecht to committers
2016-03-29 11:07:27 -04:00
James Cammarata
c157b872cc Merge pull request #15129 from kevinlondon/patch-1
Update faq.rst
2016-03-26 01:00:03 -04:00
Matt Clay
4f4f339b92 Fix ISSUE_TEMPLATE.md link.
Fixes #15136.
2016-03-25 16:02:45 -07:00
jjshoe
e98fed9c81 Updated with bcoca's feedback 2016-03-25 16:08:39 -05:00
jjshoe
b3c03dcbaa Reflect sort order. Reflect white listing in 2.0. 2016-03-25 15:45:07 -05:00
Kevin London
d6f3a1423a Update faq.rst
Minor changes to spacing and names of variables
2016-03-23 13:31:16 -07:00
Brian Coca
85cc3b734f Merge pull request #15124 from ansible/gregdek-community-patch-1
Add meeting info to Ansible community page
2016-03-23 12:26:57 -07:00
Greg DeKoenigsberg
a083c4f5a7 Add meeting info to Ansible community page 2016-03-23 12:59:23 -04:00
Toshio Kuratomi
52e9209491 Don't create world-readable module and tempfiles without explicit user permission 2016-03-23 09:52:19 -07:00
Matthew Gamble
7b06ec79e3 Add documentation for squash_actions configuration setting 2016-03-23 20:38:12 +11:00
David Blencowe
941e31e968 Update the Mac warning in intro_installation.rst
A setting of 1024 here causes other issues such as VMware not being able to start Virtual Machines. Changing to just "unlimited" as the option resolves this
2016-03-22 16:49:03 +00:00
Jason McKerr
a3d0c9e006 Update committer_guidelines.rst 2016-03-22 10:42:26 -04:00
Brian Coca
636871c2c0 Merge pull request #13377 from bruceharbin/patch-1
Update intro_windows.rst
2016-03-21 07:28:48 -07:00
Gerben Geijteman
c7e1a65da4 Proposed change to documentation to elaborate on new notation style for with_items / with_subelements 2016-03-21 14:35:05 +01:00
Michael Scherer
49f8376051 Fix small error (thse => these) 2016-03-20 00:20:32 +01:00
James Cammarata
eafeab4ab5 Merge pull request #14508 from brianlycett/patch-1
Update YAMLSyntax.rst
2016-03-19 12:15:18 -04:00
Toshio Kuratomi
60c943997b More doc updates regarding ansible_shell_executable 2016-03-18 09:16:21 -07:00
Toshio Kuratomi
287fd29db9 Use better rst markup (main change definition lists instead of code-blocks for config file options 2016-03-18 08:52:21 -07:00
Brian Coca
06e6513276 Merge pull request #15023 from bpsuntrup/documentation_issue_15022
Clarify developing modules documentation
2016-03-18 08:07:55 -07:00
SUNTRUP
3bfb556cb9 Clarify developing modules documentation
This resolves issue #15022. When doing the module tutorial, it might be
necessary for the user to read through the documentation for installing
from source to avoid dependency errors and such.
2016-03-18 09:12:17 -05:00
Toshio Kuratomi
e25caebe7a Cleanups to docs and rename of inv var 2016-03-18 06:42:37 -07:00
Brian Coca
db61e9be0c add ansible_executable inventory var
also handle the overrides appropriately
also new executable to set shell type
2016-03-17 18:54:37 -07:00
Brian Coca
84bbd2b4e3 corrected version added for ansible_version 2016-03-17 07:25:37 -07:00
Abhijit Menon-Sen
0c6693aa4c Merge pull request #14947 from mscherer/add_ansible_version_doc
Add doc on ansible_version, fix #13204
2016-03-17 14:48:50 +05:30
Abhijit Menon-Sen
00312723b2 Merge pull request #14484 from Antillean/extra-vars_docs
Documenting that extra-vars 'key=value' is for strings
2016-03-17 14:46:18 +05:30
Abhijit Menon-Sen
cc7867d1de Merge pull request #11642 from quentinsf/inventory_ignores
Mention inventory_ignore_extensions in the dynamic inventory documentation
2016-03-17 10:11:07 +05:30
Brian Coca
7f8e8ddca9 Merge pull request #14948 from mscherer/fix_doc_lexer
Fix pygments lexer name
2016-03-16 17:13:29 -07:00
Toshio Kuratomi
de708f7199 Document the issue with modules being created world-readable on the client in certain circumstances 2016-03-16 11:06:06 -07:00
Toshio Kuratomi
b6d5c6888b Update link target 2016-03-16 11:04:28 -07:00
Toshio Kuratomi
0ad4ba5fe5 Fix another docs link problem 2016-03-16 11:03:00 -07:00
karimb
6efdaa6f4f Include Ovirt in inventory list 2016-03-16 14:20:27 +01:00
Brian Coca
9be6974d37 Merge pull request #14949 from mscherer/fix_faq_syntax
Fix the lexer used, jinja2 is not valid, jinja is
2016-03-15 22:22:05 -07:00
Toshio Kuratomi
66328e5200 Merge pull request #14967 from ansible/facts-subset-and-cleanup
Facts subset and cleanup
2016-03-15 07:17:58 -07:00
Brian Coca
051b9e7b90 added warning about additional requirements 2016-03-14 22:34:17 -04:00
Toshio Kuratomi
512825455e Make ohai and facter work via module_utils Fact classes rather than in the setup module 2016-03-14 14:53:29 -07:00
Toshio Kuratomi
5a1e35224b Make changes proposed during review of restrict fact gathering feature:
* Make documentation examples into code blocks
* Make code to call the subsets more general.
* Made min subset always execute (cannot disable it).
* Use a passed in modules parameter rather than global modules.  This is needed for ziploader
* Remove unneeded __init__()
* Remove uneeded multiple inheritance from a base class
* gather_facts is now a list type
2016-03-14 14:53:29 -07:00
Yannig Perré
88772b6003 Add a way to restrict gathered facts in Ansible:
- Using gather_subset options
- By ignoring ohai/chef or facter/puppet facts
2016-03-14 14:53:28 -07:00
Michael Scherer
b3d600f1ec Fix the lexer used, jinja2 is not valid, jinja is 2016-03-13 10:03:57 +01:00
Michael Scherer
8b808cab9e Add doc on ansible_version, fix #13204 2016-03-13 09:54:24 +01:00
Michael Scherer
d7f1d865ec Fix pygments lexer name
This prevent the build from sending warnings like this:

    YAMLSyntax.rst:28: WARNING: Pygments lexer name 'YAML' is not known

and actually show real warnings and issues in the documentation
2016-03-13 09:50:52 +01:00
Jason McKerr
5128167ee6 Merge pull request #14862 from mckerrj/devel
Adding committer guidelines to docsite
2016-03-11 15:01:17 -05:00
Jason McKerr
1e85abfcf2 updates based on feedback from docschick and bcoca. 2016-03-11 14:11:06 -05:00
Matt Davis
32a1662ad0 Merge pull request #14910 from mattclay/libvirt-no-selinux
Add noseclabel support to libvirt_lxc plugin.
2016-03-11 00:24:05 +00:00
Matt Clay
ba1bcdfc17 Add noseclabel support to libvirt_lxc plugin. 2016-03-10 15:34:31 -08:00
amesbury
1871f0ec16 Fixed typo 2016-03-10 16:27:43 -06:00
Rene Moser
4264df693f docsite, cloudstack: add limited VPC support
Also see https://github.com/ansible/ansible-modules-extras/issues/1811
2016-03-10 11:41:17 +01:00
Jason McKerr
4af8676329 fix formatting for people section 2016-03-08 10:42:47 -05:00
Jason McKerr
e903b24cb7 initial checkin of the new Community Committer Guidelines 2016-03-08 10:37:30 -05:00
Michael Scherer
43309c0f5d Fix various mispellings 2016-03-06 11:29:32 +01:00
Kishin Yagami
299c18d700 Support strategy_plugins setting in a configuration file 2016-03-05 20:15:04 +09:00
Matt Martz
2da2dc621b Fix callback example in porting guide. See #14772 2016-03-04 07:18:05 -06:00
Evgeni Golov
b00a620fa5 don't escape asterisks in parameter lists 2016-03-03 23:57:30 +01:00
Dag Wieers
85a28179b7 Improve the wording a bit
According to what @amenonsen suggested in #10064.
Although the additional statement is still needed to get rid of the ambiguity.
2016-03-03 14:38:40 +01:00
Dag Wieers
18d58e42d5 Improve ambiguous statement regarding handler order
This fixes #10064
2016-03-03 14:32:56 +01:00
Brian Coca
2cd52604e2 Merge pull request #14745 from jinesh-choksi/patch-1
On RHEL/CentOS 6 needed additional dependencies to build RPM
2016-03-02 10:44:23 -05:00
Brian Coca
7404d4ce7f made dict example less ambigous
fixes #14748
2016-03-02 09:20:46 -05:00
Jinesh Choksi
78f6b61990 On RHEL/CentOS 6 needed additional dependencies to build RPM
To build an RPM on RHEL 6, we needed asciidoc, git and python-setuptools in addition to the rpm-build/make and python2-devel packages.
2016-03-02 10:54:37 +00:00
Brian Coca
70e7be0346 added clarification on moustaches 2016-03-01 12:43:52 -05:00
Brian Coca
d6716a2f90 noted issues with setup now inheriting environment 2016-03-01 09:17:16 -05:00
Brian Coca
583fafa07f Merge pull request #14689 from jmatsushita/patch-2
Updated versions with current released and development
2016-02-29 23:15:24 -05:00
Brian Coca
30b137ad34 Merge pull request #14705 from rutsky/patch-1
fix reference to chapter + trailing dot
2016-02-29 18:15:17 -05:00
nitzmahone
d699ef72d2 Fixes #12433 with distro-agnostic text 2016-02-29 14:38:35 -08:00
Matt Davis
840cda741d Merge pull request #12363 from breathe/devel
allow ConfigureRemotingForAnsible.ps1 script from public zone
2016-02-29 22:28:53 +00:00
Brian Coca
8766a9dbaf added new gather behaviour to porting guide
also removed redundant header from changelog from merge
2016-02-29 15:56:39 -05:00
brianlycett
18e4a02c25 Update YAMLSyntax.rst
Ach - it's double backquotes in this markup.
2016-02-29 16:06:06 +00:00
brianlycett
6c7680b633 Update YAMLSyntax.rst
Small updates loosely based on suggestions. :)
2016-02-29 16:04:45 +00:00
Vladimir Rutsky
35880e6254 fix reference to chapter + trailing dot 2016-02-29 18:21:05 +03:00
Yannik
767856c463 fix typo 2016-02-28 22:19:20 +01:00
Yannik
192e22f6f4 fix typo 2016-02-28 10:11:07 +01:00
Jun Matsushita
de0e7de15c Updated versions with current released and development 2016-02-27 12:39:58 +01:00
Brian Coca
b0bed27211 minor doc fixes 2016-02-26 16:46:26 -05:00
Brian Coca
e60fef4dbe Merge pull request #14660 from dagwieers/doc-hybrid-plugin
Added a section wrt. hybrid plugins and provide an example for lookup…
2016-02-25 17:19:46 -05:00
Brian Coca
fbdcb22e36 now generate list of playbook ojbect directives
TODO: needs links/info and conditionals added
2016-02-25 16:48:37 -05:00
Dag Wieers
e5600ee204 Turn it in correct reStructuredText
Why not AsciiDoc is beyond me, as it is much easier for documentation.
2016-02-25 17:12:24 +01:00
Dag Wieers
c1d90e3f2d Added a section wrt. hybrid plugins and provide an example for lookup plugins 2016-02-25 17:01:28 +01:00
Brian Coca
03c33053aa clarified become options do not imply others
fixes #14635
2016-02-24 10:58:40 -05:00
brianlycett
4160a3f40b Update YAMLSyntax.rst
A brief explanation was added regarding multi-line values.
2016-02-24 15:06:21 +00:00
James Cammarata
8e0c8ffe7b Merge pull request #14512 from scottsb/patch-1
Fix leftover references to sudo instead of become
2016-02-24 09:18:32 -05:00
Matt Martz
3ac0143cf1 Merge pull request #13654 from sivel/paramiko-proxy-command
Add ProxyCommand support to the paramiko connection plugin
2016-02-23 11:30:43 -06:00
Matt Martz
38b663471d Merge pull request #14311 from sivel/unsafe-yaml-constructor
Add new 'unsafe' YAML constructor
2016-02-23 11:29:53 -06:00
Strahinja Kustudić
28b4f2a595 Adds ANSIBLE_VAULT_PASSWORD_FILE to the documentation site 2016-02-23 14:38:47 +01:00
James Cammarata
283532e11d Updating IRC channel list in community doc 2016-02-22 13:24:08 -05:00
Matthew Huxtable
b59b5a286b docsite: add missing closing square bracket 2016-02-22 16:07:48 +00:00
Sandra Wills
11f081cb99 minor typo fix
missing "the" added to 2.x listing to match wording for 1.x
2016-02-19 10:35:43 -05:00
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.
2016-02-19 10:32:34 -05:00
Sandra Wills
17f7e6162a playbook variables precedence list light edits
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", as if something should preceed it. The
comments from OxABAB were not helpful, 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"
intros for each list line, to help with clarity.
2016-02-19 10:16:59 -05:00
Toshio Kuratomi
86b8dc0e79 Add a configuration setting that allows the user to specify printing of task arguments in the header.
Fixes #14554
2016-02-18 04:20:35 -08:00
Michael Scherer
4102812a69 Remove spurious 'either', fix #14520 2016-02-17 11:13:59 +00:00
Scott Buchanan
71dffbc28f Fix leftover references to sudo instead of become
Catching a few places that earlier PR #10788 missed.
2016-02-16 16:19:26 -05:00
brianlycett
665e158ec0 Update YAMLSyntax.rst
Updated to include a bit more depth in explaining the YAML, along with a link the Wikipedia page on YAML syntax.
2016-02-16 16:40:44 +00:00
Adam Hartz
cebf127d68 Change reference to basic.py, where the implementation details live 2016-02-16 10:32:57 -05:00
Adam Hartz
327b27ba1c Update stated location of common_module.py 2016-02-16 09:48:40 -05:00
Kamal Wood
0c1395ed2f Documenting that values passed in using the extra-vars 'key=value' syntax are interpreted as strings. 2016-02-15 14:13:39 +00:00
Illia Krauchanka
889c273ac4 Update playbooks_lookups.rst 2016-02-15 15:53:34 +03:00
Brian Coca
4b953c4b16 extended api example with more options in tasks
also adopted to less requried options
2016-02-13 20:15:56 -05:00
Anton Belonovich
d24761af1b Update playbooks_roles.rst 2016-02-12 00:01:36 +03:00
Timothy Hopper
f014b548e4 Link to /videos instead of the less obvious /resources 2016-02-11 10:34:39 -05:00
Brian Coca
50dfd4b057 fixed bad tag example 2016-02-05 15:48:56 -05:00
Dag Wieers
0a20c53ed6 A few more typos
I came across another typo, and fixed similar ones in the docs.
2016-02-05 18:38:56 +01:00
Dag Wieers
2f411557f5 Fix small typo
While reading one of the docs I found this small typo.
2016-02-05 13:54:58 +01:00
Brian Coca
597638c401 revamped become page
its not only for the 'upgrade from 1.8' anymore, become is the
official way to do things and now presents as such, no need to know
about previous options, but still keep info there for those that
were using them..
2016-02-04 20:36:20 -05:00
Brian Coca
3d894b0f13 corrected mizpellz 2016-02-04 20:10:37 -05:00
Brian Coca
d6283129e1 corrections and additions to porting guide
fixes in syntax to what is now allowable
added section from user feedback
2016-02-04 19:39:56 -05:00
Brian Coca
7037f793b9 Expain our commitment to API 2016-02-04 19:39:56 -05:00
Matt Martz
5cd4afaa1d Add documentation about the unsafe YAML tag 2016-02-04 11:54:23 -06:00
Brian Coca
c433289a8b clarified how block applies directives to tasks
previous text could be interpreted as the block itself doing the evaluation and skipping
2016-02-03 14:34:08 -05:00
Greg Taylor
96e22970ee Fix a note tag in the API docs. 2016-02-02 09:58:08 -08:00
Brian Coca
0e551e6d46 clarified ansible_shell_type description 2016-02-02 11:00:31 -05:00
Brian Coca
6105c8c77c corrected name of inventory_hostnames lookup plugin 2016-02-02 09:41:21 -05:00
Toshio Kuratomi
9e3932ffca Some attributes of callbacks aren't in v2. Port plugins to the v2 way to do that
Update porting guide with info on callback porting
2016-01-29 19:45:12 -08:00
Brian Coca
f26673904f updated intro adhoc to use become 2016-01-29 17:46:18 -05:00
Brian Coca
4b1d621442 Merge pull request #14173 from sradvan/doc-fix-bsd-intro
grammar fixes; capitalize where necessary; general clean-up
2016-01-28 15:53:00 -05:00
Scott Radvan
ba9e5fa6ba grammar fixes; capitalize where necessary; general clean-up 2016-01-28 21:58:49 +13:00
Darren Tong
90c14644b0 Fixing typo depricated for deprecated. 2016-01-27 23:22:27 -08:00
James Cammarata
39b4117816 Merge pull request #14153 from oneswig/doc-ipaddr-add-subnet-masks
Details on how to convert subnet masks into CIDR
2016-01-27 16:34:03 -05:00
Brian Coca
a928465c9e added note about 1.9 ppa 2016-01-27 16:26:44 -05:00
Stig Telfer
326ae21089 Details on how to convert subnet masks into CIDR
Use data reported by Ansible network facts as an example.
2016-01-27 12:14:50 +00:00
Brian Coca
6e716b177e add webdocs as alias 2016-01-25 16:32:09 -05:00
Brian Coca
4dc3441cdb Merge pull request #14102 from senk/fix_docu
Fixes documentation formatting
2016-01-25 14:33:23 -05:00
Matthew Seaman
043b2cbcb4 Change example to use pkg rather than the obsolete pkg_add
pkg_add has been obsoleted in all released versions of FreeBSD for
several years.  Change the example to use the appropriate pkg(8)
command line.
2016-01-25 16:20:17 +00:00
Robin Naundorf
6cc7f7890f Fixes documentation formatting
Fixes documentation formatting
2016-01-25 11:51:30 +01:00
James Cammarata
6b166a1048 Merge pull request #14071 from rozha/devel
Fix server numbers in first 10 next 10 example
2016-01-23 09:30:37 -05:00
Ilya Novickov
46bd5a0d9c Fix server numbers in first 10 next 10 example 2016-01-22 18:50:41 +08:00
Greg DeKoenigsberg
f3336fba44 Tweaking Python 2.4 requirement 2016-01-21 13:02:03 -05:00