Commit graph

1972 commits

Author SHA1 Message Date
Aneesh Joseph
0907c178bb update galaxy docs
update galaxy docs to indicate that multiple roles can be downloaded from the same source
2016-07-24 00:44:49 +05:30
Robin Roth
2b28beb1d7 add check_mode option for tasks (#16056)
* add check_mode option for tasks

includes example testcases for the template module

* extend check_mode option

* replace always_run, see also proposal rename_always_run
* rename always_run where used and add deprecation warning
* add some documentation

* have check_mode overwrite always_run

* use unique template name to prevent conflicts

test_check_mode was right before, but failed due to using the same filename as other roles

* still mention always_run in the docs

* set deprecation of always_run to version 2.4

* fix rst style

* expand documentation on per-task check mode
2016-07-22 20:40:14 -04:00
Kevin Bullock
243af8f727 Fix order of version_compare arguments in porting guide (#15809)
I struggled with this for quite a while trying to figure out the right quoting before I discovered that the arguments to `version_compare` were reversed.
2016-07-22 20:35:46 -04:00
Toshio Kuratomi
48a2773463 Find places where ziploader is used and change them to ansiballz so that people aren't confused when they google for information.information (#16715) 2016-07-21 10:58:24 -07:00
Tim Baldwin
89a61b5b43 fixed word case (#16753)
The word "times" should not be capitalized unless at the beginning of a sentence or in a proper noun.
2016-07-20 18:02:23 -04:00
Kurt Kremitzki
4483b57b4a Correct user->uesr typo 2016-07-18 10:59:45 +02:00
jjshoe
02dfed92a4 Use same warning for become-pass as for ask-pass (#16702)
* Use same warning for become-pass as for ask-pass

* Whoops, right arg

* no really, I know what I'm doing
2016-07-14 10:13:51 -07:00
Brian Coca
ed7623ecde J2 test docs (#16646)
* moved tests from filters to actual jinja2 tests

also removed some unused declarations and imports

* split tests into their own docs

removed isnan as existing jinja2's 'number' already covers same
added missing docs for several tests

* updated as per feedback
2016-07-12 10:13:00 -04:00
Chris Houseknecht
7964a2fca3 Upgrade to azure 2.0.0rc5 and add locations parameter. 2016-07-09 01:42:39 -04:00
nitzmahone
1c2bc49025 update docs for unsupported Windows features 2016-07-06 08:18:20 -07:00
Chris Houseknecht
54db1df244 Merge pull request #16559 from chouseknecht/azure-rc5
Fix authentication via params and env variables.
2016-07-04 15:03:13 -04:00
Chris Houseknecht
c71a939b08 Fix authentication via params and env vars. Update guide to RC5. 2016-07-02 21:36:34 -04:00
Brian Coca
7c9525b735 fix module_lang docs
fixes #16541
2016-07-01 10:47:52 -04:00
Johanan Lieberman
b3ca0c02c5 Fixed typo in Conditionals documentation page (#16537) 2016-06-30 19:27:14 -04:00
Johanan Lieberman
2f69baf1b9 Fixed typo in Conditionals documentation page (#16531) 2016-06-30 17:55:40 -04:00
Adrian Likins
e8d3b4b1ee Add docs-api to generate api docs with sphinx 2016-06-30 16:54:21 -04:00
Alex Willmer
52d4079184 Quote the azure requirement to prevent > causing file redirection (#16490)
Running it without quotes caused a file called '=2.0.0rc4' to be created, containing the stdout of pip installing azure 1.x
2016-06-29 09:55:19 -04:00
Andrew
b75fccb475 Noticed a typo (#16474)
Only major typo on document. Several terms that are not ideal English words.
2016-06-28 10:20:13 -04:00
nitzmahone
ca183c5bd8 update conditional docs to clarify no mustaches required 2016-06-27 16:35:49 -07:00
Bill Nottingham
c117b9d79b Update intro_configuration.rst (#16416)
Fix callback plugin path (per lib/ansible/constants.py)
(cherry picked from commit e877ea7f2b)
2016-06-23 11:09:51 -04:00
Brian Coca
f4c1d749b6 added missing plugins 2016-06-22 17:44:13 -04:00
Pedro Salgado
43e913f994 fixed plugin directories (#16377) 2016-06-22 17:43:09 -04:00
jlmitch5
caaffda496 Remove break word for docsite tables
This still allows the lines to wrap with lots of text, like comments cells.
2016-06-22 11:13:20 -04:00
René Moser
80e52888a5 doc: fix typo, handler listen in v2.2 2016-06-20 18:35:59 +02:00
James Cammarata
a026481396 Adding docs for handler listen feature and CHANGELOG entry for same 2016-06-20 09:30:20 -05:00
James Cammarata
4bc85e150a Merge pull request #12807 from Lujeni/devel
Ansible-galaxy requirements support a include directive
2016-06-18 07:50:59 -05:00
Toshio Kuratomi
73fcf9ba6e Note that ZFS's acls won't work with Ansible's secure temp file code. 2016-06-17 10:02:04 -07:00
Matt Martz
ab65150a9e Rework the v2 API example to use a custom callback to better show how callbacks can be used for handling results 2016-06-17 11:18:02 -05:00
Matt Martz
eab10b2402 Extend v2 API use example to show collecting results. Fixes #16341 2016-06-17 09:56:29 -05:00
Cory Klein
241283514a Add missing documentation about defaults/main.yml 2016-06-16 14:43:56 -06:00
jlmitch5
e397d7d603 Fix table width on docsite
This makes it so that table columns break by word instead of in between words.  It also sets the minimum width of a column in the table to 100px, and makes tables horizontally scrollable on small screen sizes.
2016-06-16 16:35:00 -04:00
Toshio Kuratomi
a3959644ee Change the default of module_set_locale to False. (#16313)
This makes Ansible no longer set LC_ALL for remote systems.  It is up to
the individual modules to set LC_ALL if they need it for screenscraping
the output from a program.

This is the 2.2 followup for #15138
2016-06-15 14:21:04 -04:00
Scott Butler
e35c0b5669 Minor grammar and punctuation tweaks.
(cherry picked from commit fd3149a5f6)
2016-06-14 18:31:48 -04:00
Jiri Tyr
27d065924f Adding custom indentation of YAML and JSON filters (#10008) 2016-06-14 10:07:34 -04:00
Peter Sprygada
e499b4ad25 update network roadmap for 2.2 2016-06-13 21:59:53 -04:00
John R Barker
1c813443a1 ROADMAP formatting (#16252) 2016-06-13 11:36:28 -04:00
scottb
e5d04fd6bd Merge pull request #16023 from jhawkesworth/add_fetch_to_windows_modules
[WIP]: A few ideas for updating the windows introduction.
2016-06-09 11:31:46 -07:00
Aaron Mortenson
5bba918052 added more documentation of loops with register (#16208) 2016-06-09 13:13:51 -04:00
James Cammarata
b37b51dcea Fix variable precedence issue where set facts beat role params
Also updates doc on variable precedence, as it was incorrect for the
order of play vars/vars_prompt/vars_files in relation to set_fact and
registered variables.

Fixes #14702
Fixes #14826
2016-06-07 11:25:02 -05:00
Marius Gedminas
b479a80d45 Document playbook_dir (#16166)
It was added back in 2013, in version 1.3: https://github.com/ansible/ansible/issues/4246
2016-06-07 09:13:06 -04:00
Brian Coca
6f36909074 service now passes 'started' instead of 'running'
other modules don't have to implement this directly
also updated docs to prefer 'started'.
fixes #16145
2016-06-06 22:30:04 -04:00
Adrian Likins
a5df32cf54 Merge pull request #16142 from drew-russell/patch-1
Fix typo in the VMware section
2016-06-06 13:31:14 -04:00
Sandra Wills
261b0af15a Merge pull request #16038 from larsks/docs/become-examples
docs: add some examples to the documentation for become
2016-06-06 11:35:47 -04:00
Drew Russell
5e81e436a2 Fix typo in the VMware section 2016-06-06 00:27:39 -05:00
nitzmahone
d1b611a730 updates for Azure SDK 2.0.0rc4 2016-06-04 15:05:13 -07:00
Jason McKerr
d170d5b5c0 Update ROADMAP_2_2.rst 2016-06-02 16:17:01 -04:00
Jason McKerr
d4b9740391 Update ROADMAP_2_2.rst 2016-06-02 16:17:01 -04:00
Jason McKerr
e109f6f3b2 Update ROADMAP_2_2.rst 2016-06-02 16:17:01 -04:00
Jason McKerr
7a8227deb6 Update ROADMAP_2_2.rst 2016-06-02 16:17:01 -04:00
Adrian Likins
ef78e3019d formatting 2016-06-02 16:17:01 -04:00
Adrian Likins
1ce266ebc3 formatting 2016-06-02 16:17:01 -04:00
Adrian Likins
b24b4fae47 formatting 2016-06-02 16:17:01 -04:00
Jason McKerr
8305f0c506 Update ROADMAP_2_2.rst 2016-06-02 16:17:01 -04:00
Jason McKerr
805955c734 Update ROADMAP_2_2.rst
formatting
2016-06-02 16:17:01 -04:00
Jason McKerr
b6dc7f008b Update ROADMAP_2_2.rst 2016-06-02 16:17:01 -04:00
Jason McKerr
868878c4e1 adding docs for individual roadmap docs. Adding subdir in docsite for
them. removing md file
2016-06-02 16:17:01 -04:00
Hrishikesh Barua
6354f0292b Update intro_configuration.rst (#16093)
Fix for #16092
2016-06-02 10:06:56 -04:00
Duncan Lock
05dd07c97c Two minor grammar fixes (#16090)
* 'putting a playbook on a crontab' -> 'putting a playbook in a crontab'
* `tasks marked as "run_once" will be ran on one host in *each* serial batch.` -> `tasks marked as "run_once" will be run on one host in *each* serial batch.`
2016-06-01 16:36:18 -04:00
Brian Coca
96495594cc added clarification on results tests naming 2016-06-01 11:07:17 -04:00
Devin Waas
01decf4166 added necessary argument (#16067)
E.G.
~~~~

# ./openstack.py --refresh
usage: openstack.py [-h] [--private] [--refresh] [--debug]
                    (--list | --host HOST)
openstack.py: error: one of the arguments --list --host is required
2016-05-31 11:53:59 -04:00
Sven-Hendrik Haase
d81b9ca29e Fix grammar (#16037) 2016-05-28 11:43:12 +02:00
Lars Kellogg-Stedman
51f88b6688 docs: add some examples to the documentation for become
there were some questions on `#ansible` about the `become` suite of
directives, and I thought it would be helpful if this document had an
example or two.
2016-05-27 17:55:39 -04:00
=
6615824f4d A few ideas for updating the windows introduction. 2016-05-27 08:45:23 +01:00
Scott Butler
1b52acade8 Fixed indenting in samples. 2016-05-25 13:37:21 -07:00
Scott Butler
189ae499cf Typo fix 2016-05-25 07:29:02 -07:00
Scott Butler
9fcb6635fa Typo fixes 2016-05-24 22:00:40 -07:00
Scott Butler
813d4435ca Incorporated additional tech review feedback. 2016-05-24 21:39:59 -07:00
Brian Coca
de7b0e9da1 made def main an explicit requirement 2016-05-24 15:11:00 -04:00
Toshio Kuratomi
d45a394f63 Mocate ansible_ssh_changes into a common directory 2016-05-24 11:37:04 -07:00
Toshio Kuratomi
9ef814e782 Documentation fixes 2016-05-24 10:46:33 -07:00
Toshio Kuratomi
6d18999c6f f 2016-05-24 10:46:10 -07:00
Toshio Kuratomi
7fb0f75db6 Update the Ansiballz developer docs 2016-05-24 10:26:14 -07:00
Sven-Hendrik Haase
070af51370 Update for preferred syntax (#15945) 2016-05-23 09:36:45 -04:00
Matt Davis
5825958a5a Merge pull request #15275 from Cryptophobia/devel
Update ConfigureRemotingForAnsible.ps1
2016-05-20 17:15:46 -07:00
Brian Coca
dd4c56e4d6 updated diff description to match current diff 2016-05-20 12:44:20 -04:00
Toshio Kuratomi
8789cfb514 Update the way we make a module be tested for py3 syntax compliance 2016-05-18 18:37:30 -07:00
Sandra Wills
9c13c7b139 Merge pull request #15804 from docschick/devel
updated video link in quickstart with link from danlondon/ansible mar…
2016-05-18 21:20:09 -04:00
Sandra Wills
56fc2ce3ad Merge pull request #15840 from gundalow/patch-1
community.rst - Formatting and readability
2016-05-18 21:13:08 -04:00
Toshio Kuratomi
0d16782a22 Python3 syntax compatibility for modules 2016-05-18 17:03:48 -07:00
Toshio Kuratomi
c37252eeca Update python3 module porting doc with new location of pycompat 2016-05-18 17:03:48 -07:00
Matt Davis
ec2cb07988 Make 'required' optional in module docs (#15906)
Updated module dev docs, doc build, ansible-doc to match
2016-05-18 16:57:36 -07:00
Chris Houseknecht
16a3b69549 Merge pull request #15917 from chouseknecht/doc-updates
Docker guide updates
2016-05-18 15:07:49 -04:00
chouseknecht
0bc23a4408
Fix typo. 2016-05-18 14:57:06 -04:00
John R Barker
21bef93d83 Double backticks
[ci skip]
2016-05-18 19:49:21 +01:00
chouseknecht
22de8a9a21
Update ansible-container links. 2016-05-18 14:31:50 -04:00
chouseknecht
0c80b71d71
Fix italics and version directives. 2016-05-18 14:22:27 -04:00
chouseknecht
10c5d9e749
Add docker_service and mention ansible-container. 2016-05-18 14:11:11 -04:00
Scott Butler
a62ac9f17e Merge branch 'devel' of https://github.com/ansible/ansible into devel 2016-05-17 14:50:28 -07:00
Scott Butler
f3dcd4b8b3 Rearranged structure; added install instructions; added info to the conditionals section. 2016-05-17 14:44:09 -07:00
Matt Davis
9ad5a32208 Merge pull request #15894 from jhawkesworth/add_ubuntu_krb5_user_to_windows_intro
add krb5-user to list of packages to install for ubuntu
2016-05-17 08:12:56 -07:00
=
be928ef71a add krb5-user to list of packages to install for ubuntu following this post on the google group: https://groups.google.com/forum/#!topic/ansible-project/dLhLtnuyzak 2016-05-17 08:16:10 +01:00
Anne Gentle
2cd17b66be Updates links to OpenStack docs to specific pages (#15857)
While a redirect is in place for both the links to the docs.openstack.org site, a more precise link is helpful.
2016-05-16 15:50:28 -04:00
toromoti
11b3a1b8ce change to a more easy-to-understand example (#15863) 2016-05-16 09:48:54 -04:00
Michael Scherer
1e60fb6c19 Add my irc nick (#15881) 2016-05-16 08:33:00 -04:00
Toshio Kuratomi
b9aafb6f89 Add six to developing_modules documentation 2016-05-14 07:56:06 -07:00
Toshio Kuratomi
9a69354b6a Start a document for developing modules for python3 2016-05-14 07:35:22 -07:00
Peter Schaadt
08f71c400f Fixing typo in Inventory documentation. (#15858) 2016-05-13 17:47:08 -04:00
Brian Coca
acf3c4dedd removed emepty line 2016-05-13 17:16:11 -04:00
Brian Coca
2ffe30a8c2 converted list to table and added some aliases 2016-05-13 17:14:05 -04:00
Nathaniel Case
6d4ba4a161 Fix my IRC handle
Not the first nor last time someone has gotten this wrong, but oddly only
one ofthem was wrong
2016-05-13 16:02:45 -04:00
nitzmahone
145f2df1f6 updated committer IRC nicks/GH IDs 2016-05-13 12:26:43 -07:00
Jason McKerr
5b7896ce7f Update committer_guidelines.rst
Adding Ryan and Adrian
2016-05-13 10:43:46 -04:00
Matt Davis
2cc50c6dc6 Merge pull request #15799 from bocharsky-bw/patch-1
Highlight SSH protocol types
2016-05-12 17:20:53 -07:00
John R Barker
3e7c5d1451 community.rst - Formatting and readability
By using the correct formatting we can avoid the double dash/em dash symbol.

I also took the opportunity to make this a bit more readable. Adding :code:`somecode` makes it a lot easier when someone scans this page to spot things, such as `make tests` is a thing that they should do.

Add in some extra links to the source so people can find more infor
2016-05-12 18:49:00 +01:00
Matt Martz
2e8146c52f Improve documentation about the JSON args file 2016-05-12 12:25:09 -05:00
Matt Martz
a4d2238e50 Bumping binary modules functionality to 2.2 2016-05-12 12:25:09 -05:00
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
5da63e18a6 updating and cleaning up the appearance of the copyright date and footer content 2016-05-10 10:30:05 -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
a3eaf3d78e table witdh fix 2016-04-28 10:16:56 -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