Commit graph

1621 commits

Author SHA1 Message Date
Matt Martz
c22c1b4785 Add note about reading input for binary modules 2016-05-12 12:25:09 -05:00
Vic Iglesias
dac356466c Update GCE module to use JSON credentials (#13623)
* Update GCE module to use JSON credentials

* Ensure minimum libcloud version when using JSON crednetials for GCE

* Relax langauge around libcloud requirements
2016-05-12 08:57:26 -07:00
Jinesh Choksi
67a64efb58 Key names in the ansible_local variable are converted into lower case
Adding a note to the documentation to highlight that key names in the ansible_local variable are converted into lower case when they are read from the local facts on the host.
2016-05-11 13:32:01 +01:00
Devon Harvey
e33b97ed1f Fix typo in intro_dynamic_inventory.rst (#15810) 2016-05-10 16:19:52 -04:00
Sandra Wills
0dc6177217 updated video link in quickstart with link from danlondon/ansible marketing 2016-05-10 10:16:22 -04:00
Victor Bocharsky
395f85e1bf Highlight SSH protocol types 2016-05-10 10:48:59 +03:00
Darren Birkett
30decd5e0a Fix a couple of typos in guide_rax.rst (#15795) 2016-05-09 18:27:18 -04:00
Scott Butler
ff2d3fee3e Tech review edits. 2016-05-06 12:59:07 -07:00
Scott Butler
b2d3631ca1 Initial structural development draft of working with networking topic 2016-05-06 10:35:46 -07:00
Miguel Cabrerizo
a274ef9adc Update intro_dynamic_inventory.rst (#15750)
When using Cobbler with Ansible a cobbler.ini file is needed by the /etc/ansible/cobbler.py script, otherwise Python errors like ConfigParser.NoSectionError: No section: 'cobbler' are shown. Maybe this could be added to the documentation. Thanks and cheers!
2016-05-06 09:57:16 -04:00
Toshio Kuratomi
4f7a0925fd Corrections to documentation formatting 2016-05-04 12:18:02 -07:00
Brian Coca
e0573d3099 make vi the default editor if no EDITOR
fixes #15577
2016-05-03 09:39:19 -04:00
Jason Pettett
4d9648dc15 Added commas in documentation to increase readability (#15662)
I have added commas in some sentences here because even as a native English speaker, they were somewhat difficult to read.
2016-04-29 09:51:04 -04:00
Chris Houseknecht
c49da27be0 Merge pull request #15615 from chouseknecht/docker_guide
Adding getting started guide for Docker
2016-04-29 01:21:15 -04:00
Brian Coca
b9a546b703 one less typo 2016-04-28 23:34:00 -04:00
Matt Davis
c6a14567b6 Merge pull request #15646 from dagwieers/patch-19
Fix a typo in "inventory_hostnames" plugin name
2016-04-28 16:47:21 -07:00
Brian Coca
f2980fc565 clarify tags (#15647)
* clarify tags

* feedback corrections
2016-04-28 10:25:26 -04:00
Brian Coca
37672f9ac3 fixed typo 2016-04-28 09:26:12 -04:00
Dag Wieers
1a50ad34e3 Fix a typo in "inventory_hostnames" plugin name
Also make Jinja2 expressions more consistent
2016-04-28 15:18:32 +02:00
Michael Scherer
47c08c865a Document that plugins can be shipped in a role (#15199)
This greatly simplify the distribution of plugin on galaxy.
2016-04-27 17:01:20 -04:00
chouseknecht
fb19d064b1
Fixed docker_host definition. 2016-04-27 04:04:40 -04:00
chouseknecht
20c2c1a771
Change command line parameters to parameters. 2016-04-27 03:34:20 -04:00
chouseknecht
07f6df3624
Adding getting started guide for Docker 2016-04-27 03:09:59 -04:00
Abhijit Menon-Sen
6b0710dde3 Merge pull request #15612 from dflock/patch-2
Improve grammar for 'Setting any var or directive makes no implications' note
2016-04-27 07:05:24 +05:30
Duncan Lock
a1f4b4eca9 Spelling mistake: reasable -> readable 2016-04-26 18:16:41 -07:00
Duncan Lock
014dec6bbb Improve grammar for 'Setting any var or directive makes no implications' note.
'makes no implications on the values of the other' is a clumsy and verbose way of saying 'independent'.
2016-04-26 18:08:22 -07:00
nikut
54440a30c0 doc fix for delegate_to / ansible_host (issue #15546) (#15605) 2016-04-26 11:18:06 -04:00
Dougal Matthews
e2640e9e61 Correct the spelling of "overridden" (#15598) 2016-04-26 08:59:26 -04:00
Dag Wieers
5d69a09fd7 Fix quoting issue in example (#15589) 2016-04-25 17:53:58 -04:00
Allyson Bowles
3b96861b7c Refer to the play_host as remote instead of local (#15307)
It was pointed out on IRC that the "local machine" terminology is
confusing, since in this instance it refers to the host *against* which
Ansible is running, in contrast to the host *from* which Ansible is
running.
2016-04-25 12:16:28 -04:00
Dag Wieers
cf958ca457 Add the encoding parameter to the options of csvfile (#15283)
I assume this ships with v2.1, if it would ship with e.g. v2.0.3.0 let me know.
2016-04-25 12:13:06 -04:00
Tegan Snyder
bf0da4aa3c add centrify dzdo escalation (#15219)
add dzdo context, and test
2016-04-25 11:24:26 -04:00
Toshio Kuratomi
2e86260e17 Update Program flow documentation for new way that ziploader works
Add documentation on how to debug ziploader modules
2016-04-24 20:46:05 -07:00
chouseknecht
86dc571d54
Fixing inventory script ambiguity. 2016-04-22 23:35:53 -04:00
Fran Torres-Lopez
0eead1a3f6 Add example of checking registered variable for emptiness. (#15510) 2016-04-22 16:23:17 -04:00
chouseknecht
af5e4abf66
Rename azure inventory script. Fix bug preventing AD user login via environment vars. 2016-04-21 14:34:08 -04:00
Brian Coca
7376405358 updated conditional docs
- added missing anchors
- clarified when/with interactions
- added examples for skipping loops on undefined vars
2016-04-21 09:43:39 -04:00
ThomasSteinbach
c600ab81ee Document connection types (#15155)
* first description of non ssh based connection types

* fixed formatting
2016-04-19 18:39:48 -04:00
Alexandr Elhovenko
3014f78bb9 Fix typo in FAQ (#15472) 2016-04-19 11:24:51 -04:00
Toshio Kuratomi
e6577ead30 Fix rst formatting 2016-04-19 07:44:45 -07:00
James Cammarata
6eefc11c39 Make the loop variable (item by default) settable per task
Required for include+with* tasks which may include files that also
have tasks containing a with* loop.

Fixes #12736
2016-04-19 01:42:40 -04:00
René Moser
ff0296f98a doc: another block/rescue with flush_handlers (#15463) 2016-04-18 17:18:20 -04:00
Will Thames
cfe99b991f Add @willthames to committer list (#15454) 2016-04-18 15:09:30 -04:00
chouseknecht
4a7fd097ba Adding Getting Started with Azure guide. 2016-04-16 04:19:38 -04:00
Greg DeKoenigsberg
4edeba9518 Changing code of conduct email address
Will change back when we actually get the code of conduct alias set up
2016-04-14 12:26:56 -04:00
Allyson Bowles
7f500ce6b9 Updates the community code of conduct (#15164)
* Updates to the Community Code of Conduct

Fleshes out the Code of Conduct, with adaptations from the Contributor
Covenant and the Elastic.co Community Code of Conduct.

* Better format subsections

* Use strong emphasis instead of sections

* Set subsections correctly and add newline after strong emphasis
2016-04-14 12:23:29 -04:00
Cryptophobia
76a519fddc Update to ConfigureRemotingForAnsible.ps1 2016-04-13 18:02:55 -04:00
Sandra Wills
4822c2caa5 minor typo fixes
fixed a few minor typos in the intro for the section
"Deprecating and making module aliases"
2016-04-13 13:57:23 -04:00
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
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
Charles Chan
903d4771a1 Improve documentation. 2016-03-25 16:35:04 -07: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
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
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
udesilva
fd28103c28 Update playbooks_lookups.rst 2016-03-04 00:04:54 +00: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
udesilva
9fcc0b307a Update playbooks_lookups.rst
Added a warning regarding attempting to create a local password file when the user the playbook is running as cannot create it... causes Ansible to loop at that task.
2016-02-27 20:23:36 +00: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
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
THEBAULT Julien
fd67d911c3 Update doc for the ansible-galaxy include directive 2016-02-08 17:31:54 +01: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
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
Greg DeKoenigsberg
981e9c44ba Put Python 2.4 in checklist
It's in the travis check, but we don't spell it out explicitly in the guidelines.
2016-01-21 12:22:26 -05:00
Greg DeKoenigsberg
a10e15c765 Update developing_test_pr.rst 2016-01-20 10:29:25 -05:00
Greg DeKoenigsberg
a4f91c2c53 format fix for github markup 2016-01-20 10:27:37 -05:00
Greg DeKoenigsberg
b900c104b9 Adding submodule help 2016-01-20 10:25:49 -05:00
Brian Coca
3750af45d4 clarified with_file 2016-01-19 21:20:24 -05:00
Brian Coca
742bd2c554 clarify role include paths 2016-01-19 08:49:16 -05:00
Brian Coca
11ca4e6282 Merge pull request #13934 from dlangille/dlangille-patch-2
Specify the correct default options for sudo_flags
2016-01-18 17:42:39 -05:00
Brian Coca
1c9774785f Merge pull request #13923 from slimandslam/patch-1
Added example of running commands on a remote Windows Server
2016-01-18 17:26:50 -05:00
Dan Langille
2765708450 Specify the correct default values for sudo_flags
The correct default options for sudo_flags can be found at: https://github.com/ansible/ansible/blob/devel/lib/ansible/constants.py#L181

Slightly alter explanation of '-H' so as not to confuse it with -E, --preserve-env (which preserves existing environment variables).

When adding the two other options, include short explanations of those options.

Add note about '-n', which did not appear in 1.x I believe, and which bit me.
2016-01-16 15:28:41 -05:00
Dan Langille
2cde16a06c Add correct default options for sudo_flags
see https://github.com/ansible/ansible/blob/devel/lib/ansible/constants.py#L181
2016-01-16 14:37:04 -05:00
Ryan Groten
e6ab0daa4b minor wording fixes 2016-01-15 14:11:17 -07:00
J Levitt
8e059d058b Added example of running commands on a remote Windows Server
Added example of running commands on a remote Windows Server
2016-01-15 14:17:23 -06:00
Brian Coca
ec95f50cb6 updated docs with new test grammer examples 2016-01-14 12:29:02 -05:00
Brian Coca
4de4d59d7a changed examples to not use 'port' directive 2016-01-13 18:06:55 -05:00
Toshio Kuratomi
f72d380bcf Specify all variables in the description to make it more clear 2016-01-13 13:15:08 -08:00
Toshio Kuratomi
be9d817618 Make example of deprecated args clearer 2016-01-13 12:35:28 -08:00
Brian Coca
739e4c0386 corrected info about windows module naming and loc 2016-01-13 10:32:36 -05:00
jfrappier
21ac96fa35 Updated intro_getting_started.rst to reference --ask-become-pass 2016-01-12 21:51:47 -05:00
Toshio Kuratomi
a3dcd99d96 Documentation fixes 2016-01-12 12:00:00 -08:00
Brian Coca
d9d4ad828a zpell the corerstly 2016-01-12 14:07:39 -05:00
Brian Coca
2374abbeda api not thread safe
also removed runner ref in general description as it is now a 1.x only thing.
2016-01-12 14:05:33 -05:00
Brian Coca
06b0161e6d fixed extract version 2016-01-12 13:26:46 -05:00
Toshio Kuratomi
cacc22abbb Add the porting guide 2016-01-11 13:58:39 -08:00
Brian Coca
a12164497b Merge pull request #13726 from teolupus/devel
Added OpenStack dynamic inventory example
2016-01-11 16:07:27 -05:00
Brian Coca
f8b06e1613 Merge pull request #13785 from claremacrae/patch-1
Fixed typo: Integerations -> Integrations
2016-01-11 14:36:56 -05:00
James E. Blair
51255aed9b Fix typo in API docs
This typo caused a SyntaxError when attempting to run the example
in the API docs.
2016-01-11 09:48:25 -08:00
Clare Macrae
04ace28f6d Fixed typo: Integerations -> Integrations 2016-01-09 22:34:03 +00:00
Brian Coca
41a417be1f noted that regex_escape was added in 2.0
fixes #13759
2016-01-07 19:02:49 -05:00
Sebastian Thiel
28be222ff0 correct invocation of launchctl
When I executed `launchctl limit maxfiles 1024 2048` , my entire system would become unusable, as all of the sudden no process could use any file anymore, reporting that the max file limit was reached.
Only a hard reboot could fix the problem, which fortunately revealed that the configuration was not saved.

The change I made *should* remedy the issue, even though I didn't test it.
Therefore I hope you can revise the documentation to be sure nothing bad happens.

# Meta

Tested on OSX 10.11.2
2016-01-07 16:55:41 +01:00
Michael
519952d7d7 Fix module name 2016-01-07 00:08:49 -08:00
Bruno Almeida do Lago
9e32099b5e Added OpenStack dynamic inventory example
Added an example illustrating how to use the OpenStack dynamic inventory script
to the "Dynamic Inventory" section.
2016-01-05 16:48:49 +13:00
Fuentes, Christopher
de529c1734 minor grammar error was making me pull hair out 2016-01-04 13:52:06 -05:00
mgarstecki
5accc98587 Correction of a double negation
The sentence seemed to imply that return codes from modules are significant, while they are not. The second part of the sentence confirms this, as it advises to use standard return codes only for future proofing.
2015-12-30 11:57:12 +01:00
Brian Coca
2000566031 minor fix to become docs 2015-12-28 10:24:49 -05:00
Brian Coca
395bfec2f9 Merge pull request #13670 from stephen144/patch-1
intro_adhoc.rst: clarify idempotence explanation
2015-12-28 10:20:08 -05:00
Brian Coca
c489b271d1 updated release cycle to 4 months instead of 2 2015-12-27 14:18:07 -05:00
Stephen Medina
cd9e18d0e5 clarify idempotence explanation
Small typo; wasn't sure what to replace it with.
2015-12-25 08:56:08 -08:00
Matt Martz
630a35adb0 Add ProxyCommand support to the paramiko connection plugin 2015-12-23 15:15:07 -06:00
Brian Coca
b201cf2ee1 switched from pythonic None to generic null 2015-12-23 10:30:24 -05:00
Matt Roberts
809c9af68c Update playbooks_intro.rst
If you follow the documentation through in order you shouldn't have 
read about modules yet.
2015-12-23 08:18:46 +00:00
Toshio Kuratomi
b33f72636a Also remove the bool casting function info (transparent to module writer now) 2015-12-22 07:25:50 -08:00
Toshio Kuratomi
b310d0ce76 Update the developing doc to modern method of specifying bool argspec values 2015-12-22 07:23:51 -08:00
Brian Coca
eb16e11253 Merge pull request #13613 from azaghal/devel-13126-dig_lookup_documentation
Adding documentation for the 'dig' lookup (#13126).
2015-12-21 13:46:02 -05:00
Brian Coca
593d80c63d role search path clarified 2015-12-21 13:15:12 -05:00
Branko Majic
6ec58bbd5f
Adding documentation for the 'dig' lookup (#13126). 2015-12-20 14:19:20 +01:00
James Cammarata
491fd754f1 Updating the porting guide to note the complex args/bare vars change
Related to #13518
2015-12-16 16:36:16 -05:00
James Cammarata
76b4b9ed2c Merge pull request #13501 from chouseknecht/galaxy-2.0-update
Galaxy 2.0 update
2015-12-16 15:01:12 -05:00
Chrrrles Paul
851c0058b1 Removing yaml support for path: 2015-12-16 12:45:05 -06:00
David
63b624707d Fix typo 2015-12-16 23:46:06 +08:00
Brian Coca
5d1a2eac3e Merge pull request #13500 from mscherer/fix_markup_doc_modules
Fix the markdown used for the Windows module section
2015-12-14 18:43:18 -05:00
gp
e595c50197 Fix typo in galaxy.rst
Fix typo
2015-12-14 12:06:35 -05:00
chouseknecht
95785f149d Fix docs. The search command works with both galaxy.ansible.com and galaxy-qa.ansible.com. 2015-12-13 05:23:04 -05:00
chouseknecht
06dde0d332 Fixed documentation typos and bits that needed clarification. Fixed missing spaces in VALID_ACTIONS. 2015-12-13 05:23:04 -05:00
chouseknecht
847f454bcc Add a section to intro_configuration for Galaxy. 2015-12-13 05:23:04 -05:00
chouseknecht
342dee0023 Define and handle ignore_certs correctly. Preserve search term order. Tweak to Galaxy docsite. 2015-12-13 05:23:04 -05:00
chouseknecht
f1c72ff8f5 Make sure it is clear that new commands require using the Galaxy 2.0 Beta site. 2015-12-13 05:23:04 -05:00
chouseknecht
989604b1a3 Fix typo. 2015-12-13 05:23:04 -05:00
Usman Ehtesham Gul
4779f29777 Fix Doc mistake
Fix Doc mistake in ansible/docsite/rst/playbooks_variables.rst
2015-12-13 01:24:27 -05:00
Brian Coca
d7b516f75d added releases doc 2015-12-12 13:16:40 -05:00
Brian Coca
0a112a1b06 fixed formating issues with rst 2015-12-12 13:14:14 -05:00
Brian Coca
8db2912745 corrected section anchors 2015-12-12 12:59:00 -05:00
Brian Coca
14f3739260 Merge pull request #13505 from janek-warchol/patch-2
Explain how 'run_once' interacts with 'serial'
2015-12-12 00:29:37 -05:00
Brian Coca
58072c92fb removed 'bare' example in environment
now shows how to use explicit templating
2015-12-11 09:32:19 -05:00
Jan Warchoł
72f0679f68 Explain how 'run_once' interacts with 'serial' 2015-12-10 16:22:37 +01:00
Michael Scherer
fe72fff57d Fix the markdown used for the Windows module section 2015-12-10 02:00:31 +01:00
Toshio Kuratomi
30e729557f Add first draft of porting guide for 2.0 2015-12-09 16:43:41 -08:00
Brian Coca
a61387846d draft release documentation 2015-12-09 14:54:11 -08:00
Toshio Kuratomi
a19e083d33 Note that handlers inside of includes are not possible at the moment 2015-12-09 13:52:01 -08:00
nitzmahone
a7cd41b482 Windows doc updates 2015-12-09 16:30:32 -05:00
Toshio Kuratomi
0211da2fe9 Clarify language of delegate_facts documentation 2015-12-09 08:44:46 -08:00
chouseknecht
4f84769a17 Galaxy 2.0 2015-12-09 10:51:12 -05:00
Brian Coca
c1cec64aa8 added delegate_facts docs 2015-12-08 14:18:38 -08:00
Brian Coca
dcedfbe26c corrected usage of ec2.py's profile option
this was never introduced into ansible-playbook though the docs
stated otherwise. We still explain how to use the env var to get the
same result.
2015-12-07 09:54:55 -08:00
sam-at-github
a96a879fcf Add fullstop to make sentence make sense. Touch parargraph while at it. 2015-12-05 13:06:58 +11:00
Brian Coca
7d073bdd17 Merge pull request #13345 from amenonsen/extract
Add an 'extract' filter
2015-12-03 11:19:06 -08:00
Toshio Kuratomi
9caa2b0452 Revert "Update docs and example config for requiretty + pipelining change"
This reverts commit f873cc0fb5.

Reverting pipelining change for now due to hard to pin down bugs: #13410  #13411
2015-12-03 07:59:23 -08:00
Brian Coca
6559616a04 updated docs for 2.0 api 2015-12-02 12:03:07 -08:00
Brian Coca
abeec3c8b5 Merge pull request #13322 from muffl0n/docs_regex_replace_named_groups
Add example for regex_replace using named groups
2015-12-02 09:43:45 -08:00
Abhijit Menon-Sen
8cf1815867 Add an 'extract' filter
At its most basic, this is nothing more than an array or hash lookup,
but when used in conjunction with map, it is very useful. For example,
while constructing an "ssh-keyscan …" command to update known_hosts on
all hosts in a group, one can get a list of IP addresses with:

    groups['x']|map('extract', hostvars, 'ec2_ip_address')|list

This returns hostvars[a].ec2_ip_address, hostvars[b].ec2_ip_address, and
so on. You can even specify an array of keys for a recursive lookup, and
mix string and integer keys depending on what you're looking up:

    ['localhost']|map('extract', hostvars, ['vars','group_names',0])|first
        == hostvars['localhost']['vars']['group_names'][0]
            == 'ungrouped'

Includes documentation and tests.
2015-12-02 18:16:38 +05:30
Brian Coca
afefaff1a7 Merge pull request #13382 from mscherer/doc_with_inventory
Add a documentation on how to loop over all inventory host
2015-12-01 18:33:59 -08:00
Michael Scherer
c8bac7f54b Remove empty line breaking the formatting of the title 2015-12-02 00:24:14 +01:00
Michael Scherer
517b533d46 Add a documentation on how to loop over all inventory host
Related to #13343
2015-12-02 00:21:10 +01:00
Ming Qian
7724c958e1 Update intro_windows.rst
first pull. thanks.
2015-12-01 11:24:17 -08:00
Toshio Kuratomi
f873cc0fb5 Update docs and example config for requiretty + pipelining change 2015-12-01 10:24:15 -08:00
James Cammarata
d1b5653b53 Merge pull request #13367 from leedm777/patch-1
Corrected group separator
2015-12-01 10:48:08 -05:00
sreekanth
96bd2a4447 Added missing closing quote 2015-12-01 17:30:43 +05:30
David M. Lee
cfdb12c2ec Corrected group separator
The text said comma, but the examples were all colons.
2015-11-30 21:44:18 -06:00
Kerim Satirli
96c6b74754 removes editorial
I feel that Ansible is above the "my hosted Git community is better than yours" discussion and thus removed the editorial around Bitbucket
2015-11-27 10:09:55 +01:00
muffl0n
fa3848a1f2 Add example for regex_replace using named groups 2015-11-26 12:56:30 +01:00
Raphael Badin
20a45ab36d Fix missing word in developing_modules.rst 2015-11-25 18:29:17 +01:00
dizzler
b937018fcd Fix typo in modules_core.rst 2015-11-24 12:49:15 -07:00
René Moser
a9f5837157 docsite: cloudstack: fix missing quotes in example 2015-11-23 07:10:47 +01:00
Matt Davis
8f00d1c698 Merge pull request #13212 from cchurch/recommended_pywinrm_version
Recommend using pywinrm >= 0.1.1 from PyPI instead of GitHub version.
2015-11-20 15:22:04 -08:00
Gilles Cornu
dc60e08aa0 Documentation: Update the Vagrant Guide
This is an attempt to solve #7665.

Revert the change applied by f56a6e0951
(#12310), as the inventory generated by Vagrant still rely on the legacy
`_ssh` setting names for backwards compatibility reasons.
See also https://github.com/mitchellh/vagrant/issues/6570
2015-11-20 21:50:41 +01:00
Chris Church
dea07438b5 Recommend using pywinrm >= 0.1.1 from PyPI instead of GitHub version. 2015-11-18 17:49:21 -05:00
Brian Coca
f6fb47be8c Merge pull request #13172 from gebn/docs-grammar
Removed erroneous apostrophe in installation documentation
2015-11-16 14:52:50 -08:00
Brian Coca
1f34c6b214 updated yaml syntax and gotchas
specifically added example for getting strings that match boolean values
2015-11-17 12:05:57 -08:00
George Brighton
0dedf444a1 Removed erroneous apostrophe in installation documentation 2015-11-15 00:04:11 +00:00
Toshio Kuratomi
958fb29b78 Merge pull request #12881 from Scypho/devel
fix for issue #11885 - allowing json in lookup template calls
2015-11-12 15:39:35 -08:00
René Moser
1d7982c599 Update guide_cloudstack.rst 2015-11-10 09:11:57 +01:00
Toshio Kuratomi
317e908165 Merge pull request #13065 from tima/patch-2
Consistent inventory pattern delimiter in docs
2015-11-09 08:54:51 -08:00
Scott Radvan
19b95e9106 Update intro_bsd.rst
Minor fixes/wording/capitalization.
2015-11-09 12:34:28 +13:00
Timothy Appnel
a8e1ec585d Consistent inventory pattern delimiter in docs
The inventory pattern delimiter used in the examples switches between the comma and colon. While both are valid I've found this throws off new users so I've modified the examples to consistently use a colon, the more common of the two in my experience.
2015-11-06 13:54:39 -05:00
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.
2015-11-06 13:48:35 -05:00
cmluciano
6677c8b8f0 Provide git based example
I found it difficult to find documentation for how to pull from a git-based scm that wasn't github. The only way I could find this option was to dig through the google-group.
2015-11-04 15:43:24 -05:00
Toshio Kuratomi
4b75308439 Fix up rst formatting 2015-11-03 17:29:02 -08:00
Tim Gerla
9008b7b0e7 Clarify how tagged roles work
This is a confusing part of roles and tags. Most people assume that tagging a role means that the tagged tasks inside the role will run based on the tags specified. But in reality, it tags the whole role with those tags.
2015-11-02 11:47:18 -05:00