Commit graph

1185 commits

Author SHA1 Message Date
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
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
Toshio Kuratomi
5e0d55ae5b Change the dict attribute collision warning to recommend using bracket notation 2015-11-01 13:32:45 -08:00
Brian Coca
4ec0536168 made condition not simplifiable to 'in' 2015-11-01 16:31:23 -05:00
Brian Coca
21ffe8702d Merge pull request #12993 from ypid/avoid-python-object-name-in-complex-datatypes
Avoid key names which are valid attributes for data types in Python.
2015-11-01 16:08:09 -05:00
Brian Coca
1dbde84337 Merge pull request #12994 from resmo/for_ansible
doc: cloudstack guide fix up
2015-11-01 15:47:21 -05:00
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.
2015-10-31 23:58:16 +01:00
Rene Moser
1243997c00 doc: cloudstack guide fix up 2015-10-31 23:51:03 +01:00
Brian Coca
3c3aff09c9 fixed documentation for host patterns separators 2015-10-31 16:35:40 -04:00
Brian Coca
9c09dc3ef8 Revert "Document , instead of : in intro_patterns, update changelog"
due to , being broken in 1.9

This reverts commit b47bc343ea.
2015-10-31 16:35:40 -04:00
René Moser
090f450d18 doc: add cloudstack guide to the guides 2015-10-31 19:34:40 +01:00
René Moser
3f26b31e47 Create guide_cloudstack.rst 2015-10-31 17:40:00 +01:00
Lars Kellogg-Stedman
dc8290ab7a add missing configuration examples
adds configuration examples missing from intro_configuration.rst.

Closes #12963.
2015-10-30 09:58:26 -04:00
jaamiller
4359189884 Update playbooks_lookups.rst
I was caught out by the different behaviour of lookups & local tasks, and could not find the difference documented anywhere at all, so I took the liberty of proposing this change.

Lookups are always relative to the role or play.
Local tasks are relative to the cwd from which you execute.
2015-10-30 10:50:53 +00:00
Jens Peter Schroer
9f2baf3f84 adding documentation 2015-10-30 10:34:47 +01:00
James Cammarata
27dc7e11a4 Merge pull request #12953 from larsks/bug/7890
add documentation for with_file loops
2015-10-29 10:45:05 -04:00
Will Thames
ab55726fad Clarify module documentation
Make the position on _facts modules more emphatic
Add documentation for RETURN structure
2015-10-29 10:02:59 +10:00
Lars Kellogg-Stedman
097adec834 add documentation for with_file loops
This commit adds documentation for the `with_file` loop construct,
resolving #7890 and #9160.
2015-10-28 16:56:21 -04:00
Brian Coca
46acf892d5 clarified ignore_errors 2015-10-27 19:59:43 -04:00
Petrox
cad053af04 Typo fix: invenotry to inventory
Typo fix: invenotry to inventory :)
2015-10-27 22:54:14 +01:00
Brian Coca
6637982deb added docs for include with_items and usage of multiple lopo vars (item) 2015-10-23 10:32:31 -04:00
Sandra Wills
bc14ed380e variables precedence reordering and added para to help explain precedence rules 2015-10-22 09:12:43 -04:00
Aidan Hobson Sayers
9f8c4d716a Document setting environment variables in a playbook 2015-10-22 12:07:54 +01:00
Borys Borysenko
126276ce6c Fix order of handlers that were notified in different sections 2015-10-21 11:00:47 +03:00
José Moreira
25e4a3ad2a Fixed docs typo 2015-10-20 16:38:16 +01:00
Brano Zarnovican
84967e282a DOC: in yum examples, 'pkg' arg renamed to 'name'
* alternating both pkg/name in examples might be confusing
* even if pkg= is working, it is not documented in
  module's refrence guide
2015-10-20 13:49:04 +02:00
Nick Cartwright
17469d0781 Fix typo: comma not colon separates groups in patterns 2015-10-16 04:30:46 +01:00
Ryan S. Brown
48e1396496 Add -y to yum command, otherwise it would hang indefinitely 2015-10-15 13:55:53 -04:00
Ryan S. Brown
9dcde77e0e Document using the raw module to install a py2.X and simplejson
In the installation guide, the raw module is mentioned as an option for
installing Python or simplejson on managed nodes that don't have them.
This change adds an example for users that may already be familiar with
using ansible but are checking install docs because they don't know the
requirements for managed nodes, or are using a distribution that doesn't
include Python 2 by default.
2015-10-15 13:35:07 -04:00
Sandra Wills
ce0cedc4a7 Merge pull request #12764 from docschick/docschick-fixes
vault and variables best practices info added, edited, and referenced
2015-10-15 10:01:06 -04:00
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.
2015-10-15 09:55:17 -04:00
jdelaporte
c2a5381438 Fix links to dynamic inventory script example.
:doc`aws_example` no longer existed.
2015-10-14 12:17:05 -05:00
Sandra Wills
1918604e72 reordering entries in glossary for alphabetical order 2015-10-14 11:37:27 -04:00
Toshio Kuratomi
3f2efddeb2 Merge pull request #12733 from docschick/ansible_ssh_docswork
added "include" for ansible_ssh_ change to another section
2015-10-13 11:22:31 -07:00
Sandra Wills
7dfce28e9a added "include" for ansible_ssh_ change note to another section of intro_inventory.rst for clarity 2015-10-13 13:59:44 -04:00