Commit graph

2138 commits

Author SHA1 Message Date
James Cammarata
159aa26b36 FEATURE: adding variable serial batches
This feature changes the scalar value of `serial:` to a list, which
allows users to specify a list of values, so batches can be ramped
up (commonly called "canary" setups):

- hosts: all
  serial: [1, 5, 10, "100%"]
  tasks:
  ...
2016-08-04 15:04:10 -05:00
Nick Heiner
3a83333ef2 Small grammar fixes. (#16955) 2016-08-04 15:13:41 -04:00
Brian Coca
dd12a6b310 document 'no booleans in choices' 2016-08-04 10:41:50 -04:00
Adrian Likins
d8ea0c3dfe Add links to gh issues for vault roadmap items 2016-08-04 10:20:45 -04:00
scottb
e0318f752d Merge pull request #16418 from alikins/docs-api
Add docs-api to generate api docs with sphinx
2016-07-29 12:37:02 -07:00
yunque
d1e4aa76a7 Grammatical clarification and stylistic uniformity
Made more legible by removing unnecessary punctuation, formatting special words (e.g. `sudo`), and a few other minor grammatical changes.
2016-07-28 11:25:07 +01:00
Adrian Likins
aece03312f Add a doc note that local_tmp was added in 2.1 (#15730)
Fixes #15719
2016-07-26 10:57:06 -07:00
scottb
eba3e51cb9 Merge pull request #15172 from charleswhchan/patch-1
Improve documentation.
2016-07-25 23:50:48 -07:00
Larry Letelier
3d7f43982a Update playbooks_roles.rst (#16808)
Just a little typo,
2016-07-24 19:52:50 -04:00
Scott Butler
312abf877b Fixed minor typo in merged pull request 2016-07-23 20:34:41 -07:00
Aneesh Joseph
8a1fd73798 fix formatting issues 2016-07-24 01:01:47 +05:30
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
Justin Lecher
e9e00d78d9 Unify space around "="
The documentation has mixed usage of spaces around = in assigned. The commit unifies it to have a single space on each side.
2016-06-09 10:58:14 +01: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
Bill Nottingham
8bd0f0c1e2 Update faq.rst
Note that ANSIBLE_DEBUG can show sensitive information.
2016-04-29 16:05:30 -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
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
Brian Coca
dec15523bd Merge pull request #15222 from docschick/devel
adding print stylesheet to theme.css for better HTML to PDF printing
2016-03-31 16:04:02 -04:00
Sandra Wills
3059272008 testing another revert: Revert "minor change, adding markup for cleaner view"
This reverts commit 1bf15176d8.
Attempting to get this commit/PR clean so that it will only include the print stylesheet (commit 94eeff7)
2016-03-31 12:36:11 -04:00
Sandra Wills
283a32340b testing a revert : Revert "playbook variables precedence list light edits"
This reverts commit 17f7e6162a.
2016-03-31 12:34:44 -04:00
Sandra Wills
1bf15176d8 minor change, adding markup for cleaner view
adding additinal header markup character to prevent "over highlighting" that globbed the docs
2016-03-31 12:30:02 -04:00
Sandra Wills
94eeff7196 updating stylesheet to make printing cleaner from HTML
Tima had feedback that saving the HMTL to a PDF wasn't ideal for printing, as the marking ad
took up 1/3 of the page. We've cleaned up the ad as well as streamlined printing a bit (removing
color backgrounds from admonitions and adding black text, exposing links, etc.)
2016-03-31 12:22:35 -04:00
Zhuoyun Wei
1a13fb63c6 Fix a typo 2016-03-30 19:05:13 +08:00
Jason McKerr
2e529d7a51 Update committer_guidelines.rst
Adding Chris Houseknecht to committers
2016-03-29 11:07:27 -04:00
James Cammarata
c157b872cc Merge pull request #15129 from kevinlondon/patch-1
Update faq.rst
2016-03-26 01:00:03 -04:00
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
Brian Coca
7f8e8ddca9 Merge pull request #14948 from mscherer/fix_doc_lexer
Fix pygments lexer name
2016-03-16 17:13:29 -07:00
Toshio Kuratomi
de708f7199 Document the issue with modules being created world-readable on the client in certain circumstances 2016-03-16 11:06:06 -07:00
Toshio Kuratomi
b6d5c6888b Update link target 2016-03-16 11:04:28 -07:00
Toshio Kuratomi
0ad4ba5fe5 Fix another docs link problem 2016-03-16 11:03:00 -07:00
karimb
6efdaa6f4f Include Ovirt in inventory list 2016-03-16 14:20:27 +01:00
Brian Coca
9be6974d37 Merge pull request #14949 from mscherer/fix_faq_syntax
Fix the lexer used, jinja2 is not valid, jinja is
2016-03-15 22:22:05 -07:00
Toshio Kuratomi
66328e5200 Merge pull request #14967 from ansible/facts-subset-and-cleanup
Facts subset and cleanup
2016-03-15 07:17:58 -07:00
Brian Coca
051b9e7b90 added warning about additional requirements 2016-03-14 22:34:17 -04:00
Toshio Kuratomi
512825455e Make ohai and facter work via module_utils Fact classes rather than in the setup module 2016-03-14 14:53:29 -07:00
Toshio Kuratomi
5a1e35224b Make changes proposed during review of restrict fact gathering feature:
* Make documentation examples into code blocks
* Make code to call the subsets more general.
* Made min subset always execute (cannot disable it).
* Use a passed in modules parameter rather than global modules.  This is needed for ziploader
* Remove unneeded __init__()
* Remove uneeded multiple inheritance from a base class
* gather_facts is now a list type
2016-03-14 14:53:29 -07:00
Yannig Perré
88772b6003 Add a way to restrict gathered facts in Ansible:
- Using gather_subset options
- By ignoring ohai/chef or facter/puppet facts
2016-03-14 14:53:28 -07:00
Michael Scherer
b3d600f1ec Fix the lexer used, jinja2 is not valid, jinja is 2016-03-13 10:03:57 +01:00
Michael Scherer
8b808cab9e Add doc on ansible_version, fix #13204 2016-03-13 09:54:24 +01:00
Michael Scherer
d7f1d865ec Fix pygments lexer name
This prevent the build from sending warnings like this:

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

and actually show real warnings and issues in the documentation
2016-03-13 09:50:52 +01:00
Jason McKerr
5128167ee6 Merge pull request #14862 from mckerrj/devel
Adding committer guidelines to docsite
2016-03-11 15:01:17 -05:00
Jason McKerr
1e85abfcf2 updates based on feedback from docschick and bcoca. 2016-03-11 14:11:06 -05:00
Matt Davis
32a1662ad0 Merge pull request #14910 from mattclay/libvirt-no-selinux
Add noseclabel support to libvirt_lxc plugin.
2016-03-11 00:24:05 +00:00
Matt Clay
ba1bcdfc17 Add noseclabel support to libvirt_lxc plugin. 2016-03-10 15:34:31 -08:00
amesbury
1871f0ec16 Fixed typo 2016-03-10 16:27:43 -06:00
Rene Moser
4264df693f docsite, cloudstack: add limited VPC support
Also see https://github.com/ansible/ansible-modules-extras/issues/1811
2016-03-10 11:41:17 +01:00
Jason McKerr
4af8676329 fix formatting for people section 2016-03-08 10:42:47 -05:00
Jason McKerr
e903b24cb7 initial checkin of the new Community Committer Guidelines 2016-03-08 10:37:30 -05:00
Michael Scherer
43309c0f5d Fix various mispellings 2016-03-06 11:29:32 +01:00
Kishin Yagami
299c18d700 Support strategy_plugins setting in a configuration file 2016-03-05 20:15:04 +09:00
Matt Martz
2da2dc621b Fix callback example in porting guide. See #14772 2016-03-04 07:18:05 -06:00
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
Sandra Wills
17f7e6162a playbook variables precedence list light edits
QA had asked me a while ago to clean up the way the precedence list for 1.x was worded,
as the intro from the list started with "then", as if something should preceed it. The
comments from OxABAB were not helpful, but his issue reminded me that this was on my to
do list to make a little cleaner and clearer.  Edits made to remove the "then"
intros for each list line, to help with clarity.
2016-02-19 10:16:59 -05:00
Toshio Kuratomi
86b8dc0e79 Add a configuration setting that allows the user to specify printing of task arguments in the header.
Fixes #14554
2016-02-18 04:20:35 -08:00
Michael Scherer
4102812a69 Remove spurious 'either', fix #14520 2016-02-17 11:13:59 +00:00
Scott Buchanan
71dffbc28f Fix leftover references to sudo instead of become
Catching a few places that earlier PR #10788 missed.
2016-02-16 16:19:26 -05:00
brianlycett
665e158ec0 Update YAMLSyntax.rst
Updated to include a bit more depth in explaining the YAML, along with a link the Wikipedia page on YAML syntax.
2016-02-16 16:40:44 +00:00
Adam Hartz
cebf127d68 Change reference to basic.py, where the implementation details live 2016-02-16 10:32:57 -05:00
Adam Hartz
327b27ba1c Update stated location of common_module.py 2016-02-16 09:48:40 -05:00
Kamal Wood
0c1395ed2f Documenting that values passed in using the extra-vars 'key=value' syntax are interpreted as strings. 2016-02-15 14:13:39 +00:00
Illia Krauchanka
889c273ac4 Update playbooks_lookups.rst 2016-02-15 15:53:34 +03:00
Brian Coca
4b953c4b16 extended api example with more options in tasks
also adopted to less requried options
2016-02-13 20:15:56 -05:00
Anton Belonovich
d24761af1b Update playbooks_roles.rst 2016-02-12 00:01:36 +03:00
Timothy Hopper
f014b548e4 Link to /videos instead of the less obvious /resources 2016-02-11 10:34:39 -05:00
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