Commit graph

2114 commits

Author SHA1 Message Date
Brian Coca
03765ba65e Revert "cloudstack: docs: use local_action, not connection=local" (#17956) 2016-10-10 01:15:02 -04:00
Strahinja Kustudić
6dd07de10b Adds an alternative layout of inventories best practices 2016-10-10 00:57:57 -04:00
René Moser
f50c0a78b2 cloudstack: docs: use local_action, not connection=local (#17951) 2016-10-09 11:49:44 +02:00
Brian Coca
7b2f15453d make explicit the scope of config's gather_subset
it only affects the invocation of setup triggered by the gather_facts directive in plays (explicit or implicit)
2016-10-07 20:13:53 -04:00
Brian Coca
1e8d0110ef removed non-feature -include in requirements.txt
fixes #17917
2016-10-07 20:13:53 -04:00
Pavlo Shchelokovskyy
aa1ec8af17 Make interprocess polling interval configurable (#16560)
As recently there was back-and-forth with this hardcoded value
(0.001 -> 0.01 -> 0.005), obviousely the optimal value for it depends on
Ansible usage scanario and is better to be configurable.

This patch adds a new config option in DEFAULT section,
`internal_poll_interval`, with default of 0.001 corresponding to the
value hardcoded in Ansible v2.1.
This config option is then used instead of hardcoded values where
needed.

Related GH issue: 14219
2016-10-06 14:30:20 -05:00
Toshio Kuratomi
1efe782b46 Refactor parsing of CLI args so that we can modify them in the base class
Implement tag and skip_tag handling in the CLI() class.  Change tag and
skip_tag command line options to be accepted multiple times on the CLI
and add them together rather than overwrite.

* Make it configurable whether to merge or overwrite multiple --tags arguments
* Make the base CLI class an abstractbaseclass so we can implement
  functionality in parse() but still make subclasses implement it.
* Deprecate the overwrite feature of --tags with a message that the
  default will change in 2.4 and go away in 2.5.

* Add documentation for merge_multiple_cli_flags
* Fix galaxy search so its tags argument does not conflict with generic tags
* Unit tests and more integration tests for tags
2016-10-06 10:46:58 -04:00
Matt Davis
0afc327532 Revert "Fix/windows documentation" (#17916) 2016-10-05 16:37:51 -07:00
Jordan Borean
e357ec68f7 Fix/windows documentation (#17851)
* Updated Windows documentation for more clarity on particular features like NTLM auth.
2016-10-05 18:46:12 -04:00
Andrea Tartaglia
60d0e681dd ssh_executable docs (#17868)
* ssh_executable docs

Added docs about ssh_executable in intro_configuration and
intro_inventory under behavioral inventory params

* Added full stops + \n in intro_configuration
2016-10-05 18:18:39 -04:00
Scott Butler
02b08b1b0c Added new nav breadcrumbs 2016-10-05 11:12:08 -07:00
Pablo SEMINARIO
b233f3ed3c Fix minor typo on testing paths example 2016-10-05 10:02:02 -04:00
Brian Coca
828dcd0f40 updated devel to 2.3 (#17884)
* updated devel to 2.3

* got missing 2.2/2.3 conversions
2016-10-03 15:08:19 -04:00
Indrajit Raychaudhuri
becb4765c3 Add homebrew in squash_actions list (#16966)
`homebrew`, like other package modules in the existing `squash_actions` list can
benefit from `with_items` loops optimization.
2016-09-30 18:07:09 -04:00
scottb
d88025f0cb Merge pull request #17833 from resmo/docs/fix_loops
docsite: various fixes in loops doc
2016-09-30 11:26:46 -07:00
Matt Davis
b427818f02 remove Windows async doc exclusion 2016-09-30 10:22:39 -07:00
Rene Moser
26bc8ab47a docsite: various fixes in loops doc
- "new in version ..." did not always show up
- indentation in examples
- minor style cleanup (whitespace)
2016-09-30 16:01:56 +02:00
scottb
c157c47802 Merge pull request #17556 from gahan-corporation/devel
Updated grammar starting on line 166.
2016-09-29 23:05:49 -07:00
scottb
db06a44b7c Merge pull request #14691 from udesilva/patch-1
Update Lookups documentation regarding a possible pitfall with password plugin
2016-09-29 23:03:18 -07:00
scottb
603f8ce91e Merge pull request #17809 from pkyeck/devel
Fix length of quickstart video mentioned in docs
2016-09-29 22:47:18 -07:00
Jason McKerr
11ae3793d5 Update ROADMAP_2_2.rst 2016-09-29 10:05:59 -04:00
Jason McKerr
036942680f Update ROADMAP_2_2.rst 2016-09-29 09:51:04 -04:00
Philipp Kyeck
d75fa2e3be Fix length of quickstart video mentioned in docs 2016-09-29 14:56:27 +02:00
Scott Butler
66f8fcea92 Fixes issue #17759 2016-09-28 15:49:17 -07:00
fajpunk
a64266e7f5 Document copy module vault decryption behavior (#17777) 2016-09-28 16:23:52 -04:00
Scott Butler
c917198415 Fixes issue #17795 2016-09-28 13:08:15 -07:00
Toshio Kuratomi
fb0ec5895a Use the play term instead of playbook.
An ansible playbook is a list of plays.  environment: applies per-play,
not per-playbook.
2016-09-28 08:23:42 -07:00
Brian Coca
86ea21a73d ansible_play_batch (#17779)
* ansible_play_batch

* added version added
2016-09-28 10:32:19 -04:00
Scott Butler
1c7890bf86 Fixed dev info landing page link 2016-09-25 14:15:09 -07:00
scottb
f46de631af Dev guide reorg continues (#17732) 2016-09-23 16:48:37 -04:00
Scott Butler
eeb4e258f8 Minor editing of PR#17730 2016-09-23 11:46:18 -07:00
scottb
c54b7dc939 Merge pull request #17730 from davidak/hash
add hint to use hash filters for password in FAQ
2016-09-23 11:39:38 -07:00
Daniel Farrell
f0e9bc160d Remove deprecated roll path arg from docs #13563 (#17689)
Signed-off-by: Daniel Farrell <dfarrell@redhat.com>
2016-09-23 14:13:56 -04:00
Brian Coca
45b961243b added note about loops being lookups 2016-09-23 13:04:43 -04:00
David Kleuker
4b58ff7eb5 add hint to use hash filters for password in faq 2016-09-23 19:04:09 +02:00
Brian Coca
89f1cd6a8f clarified play_hosts/ansible_play_hosts docs 2016-09-23 11:23:25 -04:00
j0hnsmith
4650d8910e Feature/add ansible play hosts all (#17498)
* refactor ignore_limits_and_restrictions

into ignore_limits and ignore_limitations

* add ansible_play_hosts_all

* update docs re ansible_play_hosts_all

* only use play.hosts when is has a value

* replace ansible_play_hosts with ansible_play_hosts_all

* remove unnecessary var
2016-09-23 11:17:46 -04:00
Brian Coca
52bf021904 clarified omit intended usage
fixes #13986
2016-09-23 10:19:36 -04:00
scottb
bfad319619 Merge pull request #15820 from jinesh-choksi/patch-2
Key names in the ansible_local variable are converted into lower case
2016-09-21 14:41:04 -07:00
scottb
33c96f6b7f Merge pull request #17677 from privateip/network_docs
update intro to networking section
2016-09-20 17:23:36 -07:00
Peter Sprygada
21120d9988 update intro to networking section
removes out of date device list and adds note about supported transports
2016-09-20 17:06:50 -04:00
Scott Butler
d3fe3d9217 Deprecation warning for accelerated mode; partially addresses 16410 2016-09-20 12:55:55 -07:00
Matt Clay
8a735679b4 Remove Travis and update references to Shippable. (#17649) 2016-09-19 13:36:57 -07:00
Brian Coca
1095d7e615 xpace 2016-09-19 14:00:51 -04:00
Brian Coca
322880f898 dash 2016-09-19 14:00:11 -04:00
Brian Coca
46ece623ae commiter doc update 2016-09-19 13:58:19 -04:00
John R Barker
991bd2908c Networking status for 2.2
Now that we are at feature freeze update the status
2016-09-19 16:03:43 +01:00
Justin Clift
4235bda192 Another minor typo fix ;) (#17631) 2016-09-19 14:10:44 +02:00
Justin Clift
49228d473b Minor typo fix for FreeBSD (#17633) 2016-09-19 14:10:01 +02:00
Toshio Kuratomi
794c1636eb Add note to explain inline comments can only begin with ; (#17607)
Fixes #16151
2016-09-16 15:44:22 -04:00
nitzmahone
c17a3bac37 roadmap update for Windows tasks 2016-09-15 15:00:10 -07:00
Brian Coca
4a78190982 updated devleoping plugins (#16713)
* updated devleoping plugins

Added info about action plugins and tests
made ref to task plugins/modules
updated/corrected some of the existing texts

* updated per feedback
2016-09-15 10:43:05 -04:00
Avi Wollman
c80b774631 Typo fix 2016-09-14 12:26:18 -04:00
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
Trond Hindenes
30523ddf72 fixed typo 2016-08-23 21:41:23 +02:00
Trond Hindenes
965c590808 List supported core modules in doc 2016-08-23 21:39:56 +02: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