Matt Roberts
809c9af68c
Update playbooks_intro.rst
...
If you follow the documentation through in order you shouldn't have
read about modules yet.
9 years ago
Toshio Kuratomi
b33f72636a
Also remove the bool casting function info (transparent to module writer now)
9 years ago
Toshio Kuratomi
b310d0ce76
Update the developing doc to modern method of specifying bool argspec values
9 years ago
Brian Coca
eb16e11253
Merge pull request #13613 from azaghal/devel-13126-dig_lookup_documentation
...
Adding documentation for the 'dig' lookup (#13126 ).
9 years ago
Brian Coca
593d80c63d
role search path clarified
9 years ago
Branko Majic
6ec58bbd5f
Adding documentation for the 'dig' lookup ( #13126 ).
9 years ago
James Cammarata
491fd754f1
Updating the porting guide to note the complex args/bare vars change
...
Related to #13518
9 years ago
James Cammarata
76b4b9ed2c
Merge pull request #13501 from chouseknecht/galaxy-2.0-update
...
Galaxy 2.0 update
9 years ago
Chrrrles Paul
851c0058b1
Removing yaml support for path:
9 years ago
David
63b624707d
Fix typo
9 years ago
Brian Coca
5d1a2eac3e
Merge pull request #13500 from mscherer/fix_markup_doc_modules
...
Fix the markdown used for the Windows module section
9 years ago
gp
e595c50197
Fix typo in galaxy.rst
...
Fix typo
9 years ago
chouseknecht
95785f149d
Fix docs. The search command works with both galaxy.ansible.com and galaxy-qa.ansible.com.
9 years ago
chouseknecht
06dde0d332
Fixed documentation typos and bits that needed clarification. Fixed missing spaces in VALID_ACTIONS.
9 years ago
chouseknecht
847f454bcc
Add a section to intro_configuration for Galaxy.
9 years ago
chouseknecht
342dee0023
Define and handle ignore_certs correctly. Preserve search term order. Tweak to Galaxy docsite.
9 years ago
chouseknecht
f1c72ff8f5
Make sure it is clear that new commands require using the Galaxy 2.0 Beta site.
9 years ago
chouseknecht
989604b1a3
Fix typo.
9 years ago
Usman Ehtesham Gul
4779f29777
Fix Doc mistake
...
Fix Doc mistake in ansible/docsite/rst/playbooks_variables.rst
9 years ago
Brian Coca
d7b516f75d
added releases doc
9 years ago
Brian Coca
0a112a1b06
fixed formating issues with rst
9 years ago
Brian Coca
8db2912745
corrected section anchors
9 years ago
Brian Coca
14f3739260
Merge pull request #13505 from janek-warchol/patch-2
...
Explain how 'run_once' interacts with 'serial'
9 years ago
Brian Coca
58072c92fb
removed 'bare' example in environment
...
now shows how to use explicit templating
9 years ago
Jan Warchoł
72f0679f68
Explain how 'run_once' interacts with 'serial'
9 years ago
Michael Scherer
fe72fff57d
Fix the markdown used for the Windows module section
9 years ago
Toshio Kuratomi
30e729557f
Add first draft of porting guide for 2.0
9 years ago
Brian Coca
a61387846d
draft release documentation
9 years ago
Toshio Kuratomi
a19e083d33
Note that handlers inside of includes are not possible at the moment
9 years ago
nitzmahone
a7cd41b482
Windows doc updates
9 years ago
Toshio Kuratomi
0211da2fe9
Clarify language of delegate_facts documentation
9 years ago
chouseknecht
4f84769a17
Galaxy 2.0
9 years ago
Brian Coca
c1cec64aa8
added delegate_facts docs
9 years ago
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.
9 years ago
sam-at-github
a96a879fcf
Add fullstop to make sentence make sense. Touch parargraph while at it.
9 years ago
Brian Coca
7d073bdd17
Merge pull request #13345 from amenonsen/extract
...
Add an 'extract' filter
9 years ago
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
9 years ago
Brian Coca
6559616a04
updated docs for 2.0 api
9 years ago
Brian Coca
abeec3c8b5
Merge pull request #13322 from muffl0n/docs_regex_replace_named_groups
...
Add example for regex_replace using named groups
9 years ago
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.
9 years ago
Brian Coca
afefaff1a7
Merge pull request #13382 from mscherer/doc_with_inventory
...
Add a documentation on how to loop over all inventory host
9 years ago
Michael Scherer
c8bac7f54b
Remove empty line breaking the formatting of the title
9 years ago
Michael Scherer
517b533d46
Add a documentation on how to loop over all inventory host
...
Related to #13343
9 years ago
Toshio Kuratomi
f873cc0fb5
Update docs and example config for requiretty + pipelining change
9 years ago
James Cammarata
d1b5653b53
Merge pull request #13367 from leedm777/patch-1
...
Corrected group separator
9 years ago
sreekanth
96bd2a4447
Added missing closing quote
9 years ago
David M. Lee
cfdb12c2ec
Corrected group separator
...
The text said comma, but the examples were all colons.
9 years ago
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
9 years ago
muffl0n
fa3848a1f2
Add example for regex_replace using named groups
9 years ago
Raphael Badin
20a45ab36d
Fix missing word in developing_modules.rst
9 years ago
dizzler
b937018fcd
Fix typo in modules_core.rst
9 years ago
René Moser
a9f5837157
docsite: cloudstack: fix missing quotes in example
9 years ago
Matt Davis
8f00d1c698
Merge pull request #13212 from cchurch/recommended_pywinrm_version
...
Recommend using pywinrm >= 0.1.1 from PyPI instead of GitHub version.
9 years ago
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
9 years ago
Chris Church
dea07438b5
Recommend using pywinrm >= 0.1.1 from PyPI instead of GitHub version.
9 years ago
Brian Coca
f6fb47be8c
Merge pull request #13172 from gebn/docs-grammar
...
Removed erroneous apostrophe in installation documentation
9 years ago
Brian Coca
1f34c6b214
updated yaml syntax and gotchas
...
specifically added example for getting strings that match boolean values
9 years ago
George Brighton
0dedf444a1
Removed erroneous apostrophe in installation documentation
9 years ago
Toshio Kuratomi
958fb29b78
Merge pull request #12881 from Scypho/devel
...
fix for issue #11885 - allowing json in lookup template calls
9 years ago
René Moser
1d7982c599
Update guide_cloudstack.rst
9 years ago
Toshio Kuratomi
317e908165
Merge pull request #13065 from tima/patch-2
...
Consistent inventory pattern delimiter in docs
9 years ago
Scott Radvan
19b95e9106
Update intro_bsd.rst
...
Minor fixes/wording/capitalization.
9 years ago
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.
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
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.
9 years ago
Toshio Kuratomi
4b75308439
Fix up rst formatting
9 years ago
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.
9 years ago
Toshio Kuratomi
5e0d55ae5b
Change the dict attribute collision warning to recommend using bracket notation
9 years ago
Brian Coca
4ec0536168
made condition not simplifiable to 'in'
9 years ago
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.
9 years ago
Brian Coca
1dbde84337
Merge pull request #12994 from resmo/for_ansible
...
doc: cloudstack guide fix up
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
Rene Moser
1243997c00
doc: cloudstack guide fix up
9 years ago
Brian Coca
3c3aff09c9
fixed documentation for host patterns separators
9 years ago
Brian Coca
9c09dc3ef8
Revert "Document , instead of : in intro_patterns, update changelog"
...
due to , being broken in 1.9
This reverts commit b47bc343ea
.
9 years ago
René Moser
090f450d18
doc: add cloudstack guide to the guides
9 years ago
René Moser
3f26b31e47
Create guide_cloudstack.rst
9 years ago
Lars Kellogg-Stedman
dc8290ab7a
add missing configuration examples
...
adds configuration examples missing from intro_configuration.rst.
Closes #12963 .
9 years ago
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.
9 years ago
Jens Peter Schroer
9f2baf3f84
adding documentation
9 years ago
James Cammarata
27dc7e11a4
Merge pull request #12953 from larsks/bug/7890
...
add documentation for with_file loops
9 years ago
Will Thames
ab55726fad
Clarify module documentation
...
Make the position on _facts modules more emphatic
Add documentation for RETURN structure
9 years ago
Lars Kellogg-Stedman
097adec834
add documentation for with_file loops
...
This commit adds documentation for the `with_file` loop construct,
resolving #7890 and #9160 .
9 years ago
Brian Coca
46acf892d5
clarified ignore_errors
9 years ago
Petrox
cad053af04
Typo fix: invenotry to inventory
...
Typo fix: invenotry to inventory :)
9 years ago
Brian Coca
6637982deb
added docs for include with_items and usage of multiple lopo vars (item)
9 years ago
Sandra Wills
bc14ed380e
variables precedence reordering and added para to help explain precedence rules
9 years ago
Aidan Hobson Sayers
9f8c4d716a
Document setting environment variables in a playbook
9 years ago
Borys Borysenko
126276ce6c
Fix order of handlers that were notified in different sections
9 years ago
José Moreira
25e4a3ad2a
Fixed docs typo
9 years ago
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
9 years ago
Nick Cartwright
17469d0781
Fix typo: comma not colon separates groups in patterns
9 years ago
Ryan S. Brown
48e1396496
Add -y to yum command, otherwise it would hang indefinitely
9 years ago
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.
9 years ago
Sandra Wills
ce0cedc4a7
Merge pull request #12764 from docschick/docschick-fixes
...
vault and variables best practices info added, edited, and referenced
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
jdelaporte
c2a5381438
Fix links to dynamic inventory script example.
...
:doc`aws_example` no longer existed.
9 years ago
Sandra Wills
1918604e72
reordering entries in glossary for alphabetical order
9 years ago
Toshio Kuratomi
3f2efddeb2
Merge pull request #12733 from docschick/ansible_ssh_docswork
...
added "include" for ansible_ssh_ change to another section
9 years ago
Sandra Wills
7dfce28e9a
added "include" for ansible_ssh_ change note to another section of intro_inventory.rst for clarity
9 years ago
James Cammarata
76c8318351
Merge pull request #12688 from docschick/ansible_ssh_docswork
...
Ansible ssh changes docswork
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
Toshio Kuratomi
6292520c45
Merge pull request #12444 from knakayama/bugfix/update-docs
...
Update docs (playbooks_loops.rst, playbooks_filters.rst)
9 years ago
Toshio Kuratomi
d660381f98
Merge pull request #12450 from glnds/devel
...
Installation update for people using Fishshell
9 years ago
Toshio Kuratomi
676e4232e3
Merge pull request #12438 from lekum/doc_shelvefile_lookup
...
Update lookups doc with shelvefile example
9 years ago
Sandra Wills
84240c9f28
fixed git conflict with double para
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
Bill Nottingham
aec58bfbb3
Update playbooks_blocks.rst
...
Remove heading that appears to be extraneous.
9 years ago
deyvsh
155282f94a
Indicate that credstash plugin is new in v2
...
Also offer a poor-man's alternative.
9 years ago
James Cammarata
fb0294be03
Merge pull request #12657 from jhawkesworth/powershell_strict_mode_version_2
...
Explictly set the version of strict mode to use for powershell modules.
9 years ago
deyvsh
c4c8493f1b
Add an example for map() to the filters page
9 years ago
=
345ce424c6
Explictly set the version of strict mode to use for powershell modules.
9 years ago
Brian Coca
130ba70598
added missing blank line for markup separation
9 years ago
Brian Coca
da458bbfd6
added way to display inventory vars for host to faq + some minor fixes/edits
9 years ago
Abhijit Menon-Sen
478e234bc3
Reword the jump host section in the FAQ
...
It's just s/extra_args/common_args/, but I reworded some parts to make
things a bit clearer too.
Closes #12335
9 years ago
Abhijit Menon-Sen
3ad9b4cba6
Rework additional ssh argument handling
...
Now we have the following ways to set additional arguments:
1. [ssh_connection]ssh_args in ansible.cfg: global setting, prepended to
every command line for ssh/scp/sftp. Overrides default ControlPersist
settings.
2. ansible_ssh_common_args inventory variable. Appended to every command
line for ssh/scp/sftp. Used in addition to ssh_args, if set above, or
the default settings.
3. ansible_{sftp,scp,ssh}_extra_args inventory variables. Appended to
every command line for the relevant binary only. Used in addition to
#1 and #2 , if set above, or the default settings.
3. Using the --ssh-common-args or --{sftp,scp,ssh}-extra-args command
line options (which are overriden by #2 and #3 above).
This preserves backwards compatibility (for ssh_args in ansible.cfg),
but also permits global settings (e.g. ProxyCommand via _common_args) or
ssh-specific options (e.g. -R via ssh_extra_args).
Fixes #12576
9 years ago
Brian Coca
00b8a24299
Merge pull request #12579 from acogdev/devel
...
Alphabitize retry_files_enabled and retry_files_save_path
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
Trond Hindenes
e9786db541
Windows: Updated docs to reflect the new name of get-attr, along with examples
9 years ago
acogdev
e6958df9a8
Put retry_files_enabled and retry_files_save_path into alphabetical order. Found when investigating #11491
9 years ago
Brian Coca
d380cc7e7d
Merge pull request #12543 from DevOps4Networks/devel
...
Guidance for pycrypto install on Mac OSX
9 years ago
Nathan Sowatskey
e7029a90e6
#12454 changing to footnote.
9 years ago
Austin Ziegler
67a980c9ef
Describe the units for fact_caching_timeout
9 years ago
Nathan Sowatskey
68a927466e
Updating Mac OSX guidance comment to make it a note for issue #12454 .
9 years ago
Nathan Sowatskey
420589c715
Adding Mac OSX guidance comment for issue #12454 .
9 years ago
Toshio Kuratomi
4225c0677d
Merge pull request #12548 from amenonsen/pr-9130-rebase
...
#9130 rebase: EC2 Inventory Boto Profile Support
9 years ago
Jameel Al-Aziz
c08137a3d2
Update ec2 inventory documentation to refer to AWS_PROFILE
9 years ago
willthames
9c967dd054
Allow ec2 inventory to use a boto profile
...
This allows the EC2 inventory plugin to be used with
the same configuration against different EC2 accounts
Profile can be passed using --profile variable or using
EC2_PROFILE environment variable e.g.
```
EC2_PROFILE=prod ansible-playbook -i ec2.py playbook.yml
```
Added documentation on profiles to EC2 dynamic inventory doc
Only tries to use profiles if --profile argument is given
or EC2_PROFILE is set to maintain compatibility will boto < 2.24.
Works around a minor bug in boto where if you try and use
a security token with a profile it fails (boto/boto#2100 )
9 years ago
Abhijit Menon-Sen
d4af7d256b
Mention ansible_ssh_pipelining in intro_inventory
9 years ago
Nathan Sowatskey
ee6317ca07
Adding Mac OSX guidance comment for issue #12454 .
9 years ago
Nathan Sowatskey
c8835b873b
Adding Mac OSX guidance comment for issue #12454 .
9 years ago
Nathan Sowatskey
f5c453f2b2
Adding Mac OSX guidance comment for issue #12454 .
9 years ago
Brian Coca
b757798f3e
Merge pull request #12483 from jeffwidman/patch-2
...
Clarified that .yml, .yaml, and .json are allowable file extensions for inventory vars files
9 years ago
Marius Gedminas
b57d549e16
Typo in shell command in example
9 years ago
Jeff Widman
3f135e3fac
Clarified that .yml, .yaml, and .json are allowable file extensions for inventory variables files.
9 years ago
Jeff Widman
983ee0898d
Add mention of roles_path parameter to `ansible-galaxy install` command
9 years ago
Nathaniel Cohen
fc0801e69b
describe command line options for ConfigureAnsibleForRemoting
9 years ago
Nathaniel Schaaf
356cae9e5d
Fix typo
9 years ago
Gert Leenders
2dc61bc73f
Installation update for people using Fishshell
9 years ago
knakayama
f717f14fe9
Update docs (playbooks_loops.rst, playbooks_filters.rst)
9 years ago
Toshio Kuratomi
b11a44e5b4
Merge pull request #12097 from mgedmin/patch-1
...
Fix typo, remove redundant paragraph
9 years ago
James Cammarata
37f2cbc429
Merge pull request #12436 from amenonsen/ranges
...
Support «hosts: foo[1:]» and add tests for split/apply_subscript
9 years ago
Brian Coca
5dd61ad3fe
Merge pull request #12409 from mgedmin/patch-2
...
Fix example formatting in the documentation
9 years ago
Abhijit Menon-Sen
2fcdb37e7b
Support «hosts: groupname[1:]» notation (~= 'the rest of the group')
9 years ago
Alejandro Guirao
8288e27051
Update lookups doc with shelvefile example
9 years ago
James Cammarata
951128d7a6
Merge branch 'hostpatterns' of https://github.com/amenonsen/ansible into amenonsen-hostpatterns
9 years ago
James Cammarata
ba82e57445
Merge branch 'sudo_on_if_needed' of https://github.com/apollo13/ansible into apollo13-sudo_on_if_needed
9 years ago
Abhijit Menon-Sen
b47bc343ea
Document , instead of : in intro_patterns, update changelog
9 years ago