Commit graph

2144 commits

Author SHA1 Message Date
Toshio Kuratomi
15ed88547f Update roadmap with python3 status and python-3.5 req 2016-10-25 08:24:28 -07:00
Eric Anderson
dd8079776d url for comparisons for more supported examples 2016-10-24 20:27:54 -04:00
Peter Oliver
901d41b840 Template set comparisons are new in version 2.1. 2016-10-24 16:22:28 -04:00
Steve Steiner
931939e2f8 Improve readability, give more info about context 2016-10-24 15:39:40 -04:00
Chris Houseknecht
f4e5f5f2ff Refresh the Galaxy docs (#18101) 2016-10-24 10:59:44 -04:00
Allyson Bowles
b90efeb49c Add examples for rbenv and nvm 2016-10-23 21:39:05 -05:00
Scott Butler
843de98bad Fixed a typo. 2016-10-21 23:57:33 -07:00
Scott Butler
e6397a5943 Wording tweaks 2016-10-21 17:59:05 -07:00
Scott Butler
b6761abafb Edits for PR #18098 2016-10-21 15:20:59 -07:00
Kim
bd4d5112c5 Corrected three small typos in playbooks_loops.rst (#18136) 2016-10-21 09:58:09 -04:00
Julien Le Foll
2db4c22a07 Fixed typo and wording 2016-10-21 14:35:59 +02:00
Julien Le Foll
506ea7625c Fixed grammar 2016-10-21 14:30:11 +02:00
Guillaume Mella
801d6b35da fix hosts.yml filename for inventory
trying to help user understand that directory can be used as -i argument values.
2016-10-21 11:17:09 +02:00
Brian Coca
6bde3f1174 updated devleoping plugins guide 2016-10-19 23:33:57 -04:00
scottb
a85b8888d7 Merge pull request #18096 from dharmabumstead/fix-18092
Fix for #18092; plugin dev docs tweaks
2016-10-19 16:05:33 -07:00
Scott Butler
844a7c8823 Fix for #18092 2016-10-19 15:28:10 -07:00
Matt Davis
29d545a8bc Clarify pywinrm behavior WRT Python versions affected by SSLContext
fixes #16765
2016-10-19 14:26:44 -07:00
Toshio Kuratomi
cfca71ee0c Update the ansible_managed documentation.
* New default (a static string)
* Explanation of all the fields and how they impact idempotence

Fixes #17947
2016-10-18 22:20:03 -07:00
Scott Butler
427ce69645 Continued refurb of dev content 2016-10-18 18:59:47 -07:00
Alex
40cb621f0e Fix styling (#18081) 2016-10-18 14:19:47 +02:00
Will Thames
c661f9f561 Module examples should be in YAML format
Given that Ansible best practices say to use YAML format, our
documentation should not make the excuse that it's too hard,
but rather represent examples in YAML format.

This will allow those using the examples to instantly see
best practices
2016-10-15 16:51:54 -07:00
Bill Nottingham
77e7ae6838 Change <support@ansible.com> - it's being retired. 2016-10-15 16:42:13 -07:00
Toshio Kuratomi
d4f4abfb49 Fix python3 developer docs to build.
A couple small refactors to clarify meaning.
2016-10-14 15:57:57 -07:00
Scott Butler
578170a908 Edits for docs PR #18032 2016-10-14 14:30:00 -07:00
scottb
84021a98b8 Merge pull request #18032 from abadger/python3-porting-update
Update dev_guide with Python3 porting advice.
2016-10-14 13:59:58 -07:00
Toshio Kuratomi
b8765d3d22 Update dev_guide with Python3 porting advice.
Also update the date that Python2.4 support will be dropped to say
Ansible-2.4 will no longer have python-2.4 support.
2016-10-14 12:18:04 -07:00
Bryan Parry
8db725100b Clarify description of fork 2016-10-12 20:49:34 -05:00
Sam Doran
8213fd3962 Change ie to i.e. and add a bit more clarity 2016-10-12 14:03:42 -04:00
Colin Walters
ec06278204 docs: Tweak sentence for interaction of loops + register
The previous version had an extra `during a loop` and the comma broke
the sentence in the middle weirdly.  I think this new version reads
better.
2016-10-11 14:56:42 -04:00
Scott Butler
de58f673ef Reinstating mysteriously truncated hubspot analytics. 2016-10-10 13:10:55 -07:00
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