Commit graph

2058 commits

Author SHA1 Message Date
Alexander Laughlin
7c29cb1b4b Updated grammar starting on line 166. 2016-09-13 16:43:11 -07:00
Scott Butler
da4c3ebeac Fix for ticket 9664 2016-09-13 14:23:52 -07:00
cmullaney
1e7e3aad0e docsite/rst/community.rst: Fixed typos (#17502) 2016-09-12 12:35:27 -04:00
Richard Metzler
f02ad99569 typo (#17517) 2016-09-12 08:15:07 -04:00
Robin Schneider
d76dd56ca3
Use addresses and names reserved for documentation
Trying to preserve the meaning of the examples. Not all occurrences in
`docsite/rst/playbooks_lookups.rst` have been changed for instance to
allow the unchanged examples to be used for testing.

Related to: #17479
2016-09-11 17:31:41 +02:00
scottb
c2f7aff14d Merge pull request #17485 from lovmat/clearify_why_using_python2
Clarifying why Ansible still uses Python 2
2016-09-09 16:48:29 -07:00
Mattias Loverot
2660b310dd Clarifying why Ansible still uses Python 2 2016-09-09 16:06:20 +02:00
James Cammarata
1874d9e3eb Fixing typo in developing modules doc 2016-09-08 14:29:46 -05:00
James Cammarata
516bb6deea Cleanup adhoc doc language regarding shell vs. command syntax
Fixes #7240
2016-09-08 14:23:13 -05:00
Brian Coca
68a4d40210 added backup_file to docs 2016-09-07 11:51:09 -04:00
Toshio Kuratomi
4ed88512e4 Move uses of to_bytes, to_text, to_native to use the module_utils version (#17423)
We couldn't copy to_unicode, to_bytes, to_str into module_utils because
of licensing.  So once created it we had two sets of functions that did
the same things but had different implementations.  To remedy that, this
change removes the ansible.utils.unicode versions of those functions.
2016-09-06 22:54:17 -07:00
nitzmahone
c752b25ced changelog/docsite updates for Windows async/environment 2016-09-06 17:45:56 -07:00
Ryan S. Brown
c8b8cdaf7e Update roadmap with results from this cycle of cloud modules 2016-09-02 16:17:03 -04:00
John R Barker
6fa3d70f97 Consistence formatting 2016-09-02 21:11:58 +01:00
Peter Sprygada
0c59cc1bcb update roadmap status for networking 2016-09-02 15:55:57 -04:00
John R Barker
513297abf9 Missing full stop 2016-09-02 13:49:27 +01:00
John R Barker
b0335b5ebd become_flags is a 2.2 feature
A user got bitten when become_flags didn't work as we hadn't stated it's a 2.2 feature
2016-09-02 13:47:48 +01:00
Scott Butler
0e7eddc620 Light edit of #17351 2016-09-01 15:37:37 -07:00
Will Thames
d54f5277d5 Add ksu privilege escalation (#17340)
Allow ksu privilege escalation to be used
as a standard become_method

https://web.mit.edu/kerberos/krb5-1.12/doc/user/user_commands/ksu.html
2016-09-01 16:54:31 -04:00
Marcus Bointon
d99c58ee55 Mention how to load a specific inventory file (#17348)
I had to do a silly amount of searching and reading man pages before I found this vital info - it really should be on this page!
2016-09-01 10:01:15 -07:00
Brian Coca
d647b0118d 1st draft really documenting common return vals (#17351)
* 1st draft really documenting common return vals

* fixed typo
2016-09-01 12:21:07 -04:00
Roman Belyakovsky
d80d986a38 Added to_datetime filter (#17145)
* Added to_datetime filter

* Added to_datetime filter documentation
2016-09-01 01:51:03 +02:00
Adriano C
dbb0ef40c0 Minor text formatting (#15991)
* Minor formatting

* Update intro_getting_started.rst

* Minor formatting

* Reserved words formatting.

* Reserved words formatting.
2016-09-01 01:26:54 +02:00
Scott Butler
93443bad2f Fleshing out plugin development documentation. WIP. 2016-08-31 14:53:13 -07:00
Brian Coca
f39799fbcd implemented loop pausing (#17289)
* implemented loop pausing

- added loop pause to changelog
- only pause between iterations, avoid 1st/last
- added example to docs

* fixed note placement

* else

* added docs for loop_control: label
2016-08-31 16:09:37 -04:00
Matt Clay
3a83379b1d Added note about deferring module test relocation. (#17333) 2016-08-31 12:22:29 -07:00
Toshio Kuratomi
33245b2011 Add checklist item on how to use env vars with basic auth helpers 2016-08-31 09:33:33 -07:00
Andrea Tartaglia
6fab8bc643 Added allow_world_readable_tmpfiles in config #17013 (#17153) 2016-08-31 17:07:13 +02:00
Fabio Alessandro Locati
b931873f3a Remove see also at the same page (#17317) 2016-08-31 16:39:51 +02:00
Michael Scherer
e3f54cb798 Add support for become_flags on the task level (#17310)
Working on the test suite, I tried to replace a call to sudo to a
call to su, and found out that I can't change user to 'nobody'
without changing the option become_flags in ansible.cfg

As this would be dependent on the user and the task, it make more sense
to push the setting there.
2016-08-30 12:29:00 -07:00
Scott Butler
4ba90a3817 Edited dynamic vs. static includes update 2016-08-30 10:27:35 -07:00
James Cammarata
9c311b6b13 Add docs on static/dynamic includes 2016-08-30 07:05:18 -05:00
Toshio Kuratomi
b8a8027b7d We've decided that python-3.5 is the minimum python version (#17270) 2016-08-29 09:12:37 -07:00
Toshio Kuratomi
0a39700b36 Fix octal output in a few more places (#17250)
Fix filetree lookup plugin for python3 (octal output and selinux API
takes native strings)
2016-08-25 14:58:35 -07:00
Toshio Kuratomi
7e71299ee1 Couple things to watch out for when reviewing facts modules 2016-08-25 11:37:57 -07:00
Tim Whittington
2b3a22fdba Document when clause list of conditions (#17206)
The 'when' clause supports a list of conditions, applying a logical 'and' to the conditions (i.e. requiring all of them to be true).

This can be useful for legibility sometimes, allowing distinct conditions to be listed on separate lines.
2016-08-25 09:52:52 -07:00
Tom
d29e9d7d3c Update command for generating password (#17170)
The option to generate a password is --method=sha-512 instead of --method=SHA-512 which produces a hash not found error
2016-08-25 09:43:28 -07:00
Matt Clay
dd51ddb844 Updated progress on Python 3 CI and test coverage. (#17245) 2016-08-25 09:24:42 -07:00
Peter Sprygada
c2d87816a8 update 2.2 roadmap network section 2016-08-25 10:21:35 -04:00
jlmitch5
2785ec878b Add ad blocks back in (#17228) 2016-08-24 15:59:58 -04:00
Matt Clay
8508e48c67 Noted addition of OS X integration tests. (#17203) 2016-08-23 15:31:46 -07:00
Toshio Kuratomi
3833b21ab5 Update python3 docs for some of the recent decisions about porting (#17169) 2016-08-20 13:17:38 -07:00
scottb
5483528480 Merge pull request #16331 from coryfklein/devel
Add missing documentation about defaults/main.yml
2016-08-19 11:28:02 -07:00
Scott Butler
9abd20d49b Edited https://github.com/ansible/ansible/pull/17128 2016-08-19 11:22:21 -07:00
scottb
495589230b Merge pull request #17128 from bcoca/DONT
Thanks @bcoca; will merge and do some minor wordsmithing.
2016-08-19 11:14:40 -07:00
Alan Justino da Silva
c5b5a20031 [DOC FIX] Time Limited Background Operations topic styles (#17129)
The styles are leaking, by not closing the "coding" part on the right place
2016-08-18 15:45:59 -07:00
Matt Clay
e1262fa49b Updated progress on roadmap items. 2016-08-18 09:55:59 -07:00
Peter Sprygada
9d29431661 Merge pull request #17114 from skg-net/Dell_Ansible_Roadmap
Added Dell Networking Modules to the Roadmap
2016-08-18 08:42:43 -04:00
Sandra Wills
63be666b53 Merge pull request #17119 from sam-at-github/patch-3
I think that is a better analogy.
2016-08-18 07:56:19 -04:00
Brian Coca
dac5af63cb corrected typo, expanded server types 2016-08-17 15:49:40 -04:00
Brian Coca
b581780283 dont do it 2016-08-17 15:45:31 -04:00
sam-at-github
a2d0bbed8c Handlers are triggered at the play level, not playbook. (#17121) 2016-08-17 10:36:33 -04:00
sam-at-github
16426ad795 I think that is a better analogy. 2016-08-17 19:20:13 +10:00
Senthil Kumar Ganesan
48df950a75 Added Dell Networking Modules to the Roadmap 2016-08-16 18:27:54 -07:00
Olaf Alders
8681df4b58 s/shutdown/shut down/ (#17107)
shutdown is a noun.  In the task name you really want a verb.
2016-08-16 21:02:25 +02:00
Scott Butler
124c1e3d27 Added substitution definitions and references for version number, etc 2016-08-15 17:48:46 -07:00
scottb
89ce1fc917 Merge pull request #17051 from ferrants/patch-2
Update playbooks_lookups.rst
2016-08-15 12:30:44 -07:00
Tim Whittington
b3c686f4c5 Note that to_nice_yaml(indent=X) was new in 2.2 (#17085)
The ability to pass indent parameter to to_nice_yaml was introduced in 2.2, but this is not noted in the docs.
2016-08-15 10:41:55 -04:00
Ted Timmons
f4bd38a153 document what glob style is used (#17080)
Took some digging to find that `with_fileglob` calls a method named `fileglob()`, which uses Python's `glob` library.
2016-08-15 09:38:27 -04:00
nickmisasi13
85dd9aa4ec Update developing_inventory.rst
Changed a misleading line from returning to printing
2016-08-12 08:49:30 -04:00
Matt Ferrante
e448c05f67 Update playbooks_lookups.rst 2016-08-11 13:23:06 -04:00
scottb
aef20c4242 Minor rewording. 2016-08-10 23:24:33 -07:00
Adrian Likins
8c7d235323 Update ROADMAP_2_2.rst 2016-08-09 11:32:16 -04:00
Scott Butler
12ce5a24da Minor wordsmithing. 2016-08-08 16:33:07 -07:00
Brian Coca
9a9268de0f version_added is required for new modules/options 2016-08-08 19:14:13 -04:00
Brian Coca
1a53d0c503 better phrasing 2016-08-08 09:40:01 -04:00
Brian Coca
1838eeba96 fix - replacement docs 2016-08-08 09:33:19 -04:00
Scott Butler
8fa5e88b55 Updated installation links. 2016-08-04 17:12:31 -07:00
Brian Coca
f92d724b17 made done: more visible 2016-08-04 19:48:34 -04:00
Brian Coca
022cc95a61 removed markdown .. its rst 2016-08-04 19:47:39 -04:00
Brian Coca
900a15ffd6 updated roadmap with a few 'dones' 2016-08-04 19:44:15 -04:00
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