Commit graph

853 commits

Author SHA1 Message Date
Mengdi Gao
665babdaab Remove redundant whitespace. 2015-04-08 14:19:45 +08:00
Mohamed Hazem
bb3f50361e Replaced --start-at with --start-at-task 2015-04-05 20:47:22 +03:00
Bill Nottingham
7e3b3b6ebe Update intro_windows.rst
Add a bit about what Windows versions PS3 is actually available for.
2015-04-03 14:26:45 -04:00
Bill Nottingham
22608939eb Update intro_windows.rst
Refer to PowerShell consistently.
2015-04-03 14:23:04 -04:00
Matt Martz
fa076591c9 Don't recommend installing ansible via homebrew 2015-04-02 15:30:37 -05:00
Luke
132c0e794d note added to source section
Added reminder to not use source install method if you're going to be installing ansible for a Tower system
2015-04-01 08:29:56 -04:00
Brian Coca
c90e3f0d16 small updates to community and contribution page 2015-03-29 15:58:56 -04:00
Cristian Ciupitu
577cdcadb3 Doc: use literal code blocks for YAML examples
Without this, the straight double quotes (") are displayed as curved
quotes (“ and ”).
2015-03-23 22:52:42 +02:00
Tim Rupp
9a680472f8 Fixes a brief spelling error
Fixes a simple spelling mistake that was bugging me when I read the online
docs. Trying to make the docs as great as possible.
2015-03-21 19:22:12 -07:00
Henry Todd
10e14d0e0a Update add_host example in AWS Guide
The add_host module now uses "groups" instead of "groupname" to allow for specifying more than one group.
2015-03-21 13:21:55 +08:00
Brian Coca
64b447f01b grammer correction 2015-03-20 16:55:03 -04:00
Brian Coca
690d227034 extended return value explanation 2015-03-20 16:55:03 -04:00
Brian Coca
94909bd4a2 Added return values documentation to modules 2015-03-20 16:55:03 -04:00
Toshio Kuratomi
d1641f2925 Remove the multiline string for arguments not. 2015-03-19 16:10:01 -07:00
Toshio Kuratomi
86dc83b76d Merge pull request #10163 from maxamillion/docs_yaml_dict_playbook
Add intro to playbook docs using YAML dictionaries
2015-03-19 16:08:36 -07:00
Michael Crilly
8e346186b2 Correct version number.
1.8.4 is the latest stable now, I believe.
2015-03-13 18:07:18 +00:00
Jeff Widman
f6d8e457ab Typo: lead --> led 2015-03-11 01:20:17 -07:00
Brian Coca
5f6db0e164 preliminary privlege escalation unification + pbrun
- become constants inherit existing sudo/su ones
- become command line options, marked sudo/su as deprecated and moved sudo/su passwords to runas group
- changed method signatures as privlege escalation is collapsed to become
- added tests for su and become, diabled su for lack of support in local.py
- updated playbook,play and task objects to become
- added become to runner
- added whoami test for become/sudo/su
- added home override dir for plugins
- removed useless method from ask pass
- forced become pass to always be string also uses to_bytes
- fixed fakerunner for tests
- corrected reference in synchronize action plugin
- added pfexec (needs testing)
- removed unused sudo/su in runner init
- removed deprecated info
- updated pe tests to allow to run under sudo and not need root
- normalized become options into a funciton to avoid duplication and inconsistencies
- pushed suppored list to connection classs property
- updated all connection plugins to latest 'become' pe

- includes fixes from feedback (including typos)
- added draft docs
- stub of become_exe, leaving for future v2 fixes
2015-03-10 18:42:36 -04:00
Brian Coca
39a3d6f5ed added version to ternary example 2015-03-10 12:42:55 -04:00
Brian Coca
0ff77b3650 Merge pull request #10404 from maxalbert/doc_enhancement
Add note to section 'Loops' that the 'when:' statement is processed per-item
2015-03-10 10:51:47 -04:00
Brian Coca
a4c7aca419 Merge pull request #10395 from AndrewLorente/patch-2
Mention `view` in the ansible vault docs
2015-03-10 10:43:05 -04:00
Dag Wieers
2e67372919 Make the example somewhat more feature complete
New users might think that "state=started" implies that the service is also started at boot-time, which isn't.
By adding it, this change makes a clear distinction between the service state, and whether it is enabled (at boot).
And makes the example more feature-complete as this is what most people would be doing anyway.
2015-03-09 16:16:58 +01:00
Brian Coca
08617c087b Merge pull request #8866 from Fresheyeball/patch-1
Document Environment in tasks as well
2015-03-09 02:05:27 -04:00
Toshio Kuratomi
cc7385d8f7 Add the playbook filters to a toctree 2015-03-06 21:02:40 -08:00
Maximilian Albert
af593c2f51 Add note to section 'Loops' that the 'when:' statement is processed per-item. 2015-03-06 21:35:49 +00:00
Andrew Lorente
822c401a71 Mention view in the ansible vault docs 2015-03-05 14:01:09 -08:00
Vincent van Scherpenseel
01886ede28 Update playbooks_vault.rst
Typo fix (passwords -> files).
2015-03-05 14:05:38 +01:00
Brian Coca
6223094c54 Merge pull request #10351 from lekum/doc-update-mock
Update doc for testing PR with mock dependency
2015-02-27 08:54:51 -05:00
Alejandro Guirao
0e493dbd69 Update doc for testing PR with mock dependency 2015-02-27 09:34:20 +01:00
Brian Coca
d0f8df4bdb Merge pull request #10079 from lorin/csv-lookup-doc
Add docs for csvfile lookup
2015-02-26 23:54:57 -05:00
Brian Coca
5a64b2e269 Merge pull request #10305 from bcoca/cartesian
Cartesian
2015-02-26 23:25:33 -05:00
Brian Coca
c9cbe9d528 Merge pull request #9906 from NateEag/patch-1
"its" => "it's" in docsite/rst/intro_adhoc.rst
2015-02-26 22:57:17 -05:00
Toshio Kuratomi
82685799cb filter name is realpath, not readlink
Fixes #10062
2015-02-26 14:17:39 -08:00
Brian Coca
c81d981164 Merge pull request #10183 from bcoca/tag_control
adds complex tag management
2015-02-25 10:36:11 -05:00
David Mahler
c4144b1391 Some grammatical updates 2015-02-22 19:28:16 +00:00
Maciej Delmanowski
c10f4c23dd Specify that 'ipaddr' is available in 1.9 2015-02-21 14:11:04 +01:00
Maciej Delmanowski
25ef581a90 Add basic examples of ipaddr filter use 2015-02-21 13:34:22 +01:00
Maciej Delmanowski
71dae62b2a Add IP address filter documentation 2015-02-21 13:21:07 +01:00
Maciej Delmanowski
c866a26d81 Move Jinja2 filters documentation to separate file 2015-02-21 13:01:22 +01:00
Brian Coca
965680a18e documented cartesian lookup in 1.9 2015-02-20 09:06:17 -05:00
Brian Coca
a66c559818 documented new wantlist feature 2015-02-19 18:29:29 -05:00
Brian Coca
54cf8f1138 Merge pull request #10256 from kstrauser/kerberos-docs
Added winrm/kerberos configuration information
2015-02-16 12:48:21 -05:00
Kirk Strauser
1b67aa94e8 Added winrm/kerberos configuration information 2015-02-16 09:36:39 -08:00
Lorin Hochstein
639f06e0e8 Document redis_kv Python package dependency
Mention in docs that the redis_kv lookup requires that the redis Python package
is installed.
2015-02-15 22:37:58 -05:00
Brian Coca
af573db47a documented new tag behaviour 2015-02-13 08:27:07 -05:00
Toshio Kuratomi
53e5c5e33f Merge pull request #10205 from alefteris/patch-1
Typo in galaxy.rst
2015-02-12 12:00:25 -08:00
Brian Coca
62a6378c4a Merge pull request #8792 from bcoca/ternary_filter
ternary filter
2015-02-12 11:29:49 -05:00
Brian Coca
ec8483eb69 Merge pull request #10227 from fullergalway/patch-1
Small change to guid_gce.rst,  'project-name', should be 'project_id'
2015-02-12 10:00:13 -05:00
fullergalway
a8c02ea807 Small update to guid_gce.rst, says 'project-name', should be 'project_id'. 2015-02-12 09:15:43 +00:00
Tongliang Liu
1fc2095157 Added "--recursive" to git clone command in installation via yum section. Changed rpm build parent directory to current dir. 2015-02-11 20:00:38 -08:00
Brian Coca
f05a1085e9 Merge pull request #9249 from tjanez/doc-add_note_about_escaping_with_regex_replace
Added a note about escaping backreferences when using 'regex_replace' filter
2015-02-11 17:47:19 -05:00
Thanos Lefteris
ef11c8ce55 Typo in galaxy.rst 2015-02-11 23:03:45 +02:00
Brian Coca
13d788021f Merge pull request #4820 from mscherer/add_local_config
Add path for user defined plugin
2015-02-11 14:44:07 -05:00
Brian Coca
9820165265 Merge pull request #10188 from simontite-capita-ti/patch-1
Update playbooks_delegation.rst
2015-02-09 10:14:34 -05:00
simontite-capita-ti
21094614c0 Update playbooks_delegation.rst
There's a space missing "hosts:127.0.0.1" should be "hosts: 127.0.0.1"
2015-02-09 11:05:21 +00:00
Brian Peiris
ae5f64c232 Update YAMLSyntax.rst 2015-02-05 11:16:39 -05:00
Brian Peiris
32a5dc22c6 Reformat description of a dictionary entry. 2015-02-05 11:13:33 -05:00
Adam Miller
1e787bd91e Add intro to playbook docs using YAML dictionaries 2015-02-04 09:56:44 -06:00
Erika Heidi
c20c6d4eb4 [Vagrant guide] Updating private key location
Since Vagrant 1.7.0, released in December 2014, the private key file is autogenerated and has a new location - check the changelog for more info: [version 1.7.0 changelog](https://github.com/mitchellh/vagrant/blob/master/CHANGELOG.md#170-december-9-2014)
2015-02-02 13:30:17 +01:00
Michael Scherer
d6edbeb4d0 Fix documentation on hostfile vs inventory , follow up of #10130 2015-02-01 12:12:40 +01:00
Brian Coca
daa2c3a956 Merge pull request #9584 from Sgoettschkes/issue_docs_missing_ansible_sudo
Adding inventory parameter to documentation
2015-01-28 13:42:59 -05:00
Brian Coca
990d08b63f Merge pull request #10113 from bcoca/url_lookup
Url lookup
2015-01-28 09:54:40 -05:00
Dagobert Michelsen
7a90139e3c Add OpenCSW for Solaris 2015-01-28 10:23:03 +01:00
Brian Coca
6118bf4b64 corrected missing quote 2015-01-27 17:48:39 -05:00
Brian Coca
424065229c added example of url lookup 2015-01-27 17:25:55 -05:00
William Jimenez
36e0e1ef26 explain -q flag for env-setup
See https://github.com/ansible/ansible/issues/10109
2015-01-27 12:56:21 -08:00
Lorin Hochstein
0474b5ce5d Document that dnstxt lookup requires dnspython
Add a line in the docs to specify that dnstxt requires that you have the
dnspython package installed.
2015-01-25 15:20:49 -05:00
Lorin Hochstein
6a7012474b Add docs for csvfile lookup 2015-01-23 21:06:12 -05:00
Björn Andersson
65e4f2b2bc Add filter to turn a string into a UUID
This filter was made because I needed to create idempotent UUIDs when
installing the agent for Go (http://go.cd), which uses UUIds to
distinguish the agents from each other.

It uses a newly created Ansible namespace to distinguish UUIDs created
by Ansible from any other source. The new namespace is a random one
created by uuidgen on OSX.
2015-01-21 08:07:17 +08:00
Brian Coca
cf6f05e71d Merge pull request #10039 from tima/doc-version-fix
Modified the version numbers in one section on index of docs to reflect their current state.
2015-01-19 15:30:41 -05:00
Brian Coca
1a1b66702f Merge pull request #10037 from lekum/aws-doc-bug
Add missing register
2015-01-19 15:29:59 -05:00
Brian Coca
2a9d5054bf Merge pull request #9995 from bcoca/hash_filters
Hash filters
2015-01-19 15:17:39 -05:00
Jeremy Voorhis
f6e309bebb Fix copy/paste in plugins docs. 2015-01-18 15:55:24 -08:00
Timothy Appnel
802f0048e5 Modified the version numbers in one section on index of docs to reflect their current state. 2015-01-18 14:34:02 -05:00
Alejandro Guirao
63808ee3f1 Add missing register 2015-01-18 14:27:26 +01:00
Brian Coca
b28ef1701f Merge pull request #9896 from resmo/fix/doc
doc: mention smart gathering for facts caching
2015-01-16 10:17:51 -05:00
Brian Coca
ffe1dcde28 Merge pull request #9713 from bcoca/fact_cache_n_gathering
mentioned gathering settings in fact caching.
2015-01-16 10:17:17 -05:00
Major Hayden
eaac53922c Small spelling fix for Rax docs 2015-01-13 21:19:27 -06:00
Brian Coca
35247fabb8 added hash and password_hash functions
documented new hashing filters and preexisting hashing filters
removed extra sha1 example in others, clarified some of the hashing examples
2015-01-13 14:05:57 -05:00
stevelenihan
c29da7927c Correcting spelling mistake
Change 'uncrypted' to 'unencrypted'
2015-01-13 16:53:14 +00:00
Kerry Ivan Kurian
630ae89977 fix typo 2015-01-12 12:24:17 -07:00
Brian Coca
375f4d701c Merge pull request #9076 from jirutka/patch-1
Add Gentoo install notes do intro_installation
2015-01-12 10:27:03 -05:00
Marco Ippolito
31c8523371 Updated shebang from #!/bin/bash to #!/usr/bin/env bash (more flexible) 2015-01-10 17:21:43 -08:00
Toshio Kuratomi
fe53d86a83 inventory is ini-like but not quite like other implementations 2015-01-05 09:18:52 -08:00
Brian Coca
8760392a95 Merge pull request #9910 from NateEag/patch-3
Fix some typos in developing_modules.rst
2014-12-29 17:40:33 -05:00
Nate Eagleson
410c8fc825 Fix some typos in developing_modules.rst 2014-12-29 08:39:39 -05:00
Nate Eagleson
d2cae91dcf Improve wording in playbooks_intro.rst
I was reading the docs and thought "that wording seems off."
2014-12-29 08:03:38 -05:00
Nate Eagleson
20937f6fa2 "its" => "it's" in docsite/rst/intro_adhoc.rst
Noticed this grammar error while reading through the intro and figured
I'd send a quick PR.
2014-12-28 21:35:30 -05:00
René Moser
a88e928bf0 doc: mention smart gathering for facts caching 2014-12-25 23:33:56 +01:00
Toshio Kuratomi
fb5b682989 Use "override" instead of "loaded second" to be clear about what happens
Need for clarification brought up here:
https://github.com/ansible/ansible/issues/9877
2014-12-23 12:37:42 -08:00
Jérémie Astori
35b94948b9 Fix conditionals doc example
Use most recent parameters for yum
2014-12-21 23:42:01 -05:00
Toshio Kuratomi
7ab1e52575 Merge pull request #9832 from bcoca/math_filters
math filters!
2014-12-16 15:42:22 -08:00
Brian Coca
b07ce8b942 removed redundant math functions as jinja2 provides abs() and round()
already
2014-12-16 17:57:21 -05:00
Brian Coca
6a3c26eb70 removed stray j 2014-12-16 17:49:32 -05:00
Brian Coca
7a43d40050 math filters! 2014-12-16 17:47:50 -05:00
Toshio Kuratomi
b74a02301b Fix documentation syntax problems 2014-12-16 12:25:41 -08:00
Brian Coca
8908f4a0ef Merge pull request #7214 from lorin/dyn-inv-doc
Document static groups of dynamic groups
2014-12-15 17:56:25 -05:00
axiaoxin
5838812967 minor 2014-12-15 15:55:12 +08:00
axiaoxin
36eab28c7c making the whitespace expicity in dict 2014-12-15 15:53:35 +08:00
axiaoxin
c0cb4b3e08 in key/value pairs, whitespace is needed after the colon 2014-12-15 15:44:00 +08:00
axiaoxin
b9761a0692 members of a list must start with `- ` 2014-12-15 15:32:49 +08:00
Michael Scherer
72eab3c019 fix the documentation path for latest regarding plugins 2014-12-11 23:35:37 +01:00
Donovan Hernandez
a1a6b8dfbb Fix typo for the word "maintaining" 2014-12-11 02:10:44 -06:00
Tim Gerla
23405b60cb fix up formatting for one code section in guide_aws 2014-12-10 19:04:02 -08:00
Mike Putnam
09ef8f5722 Typo fix in playbook delegation docs. 2014-12-10 12:13:31 -06:00
Mike Putnam
e507a79b96 Typo fix 2014-12-10 11:41:31 -06:00
Toshio Kuratomi
12e1884352 Merge pull request #9755 from armetiz/docs_format
Add missing connection and header
2014-12-09 09:54:41 -08:00
Toshio Kuratomi
ff970eabd8 Add role vars to differentiate with role defaults 2014-12-09 09:51:51 -08:00
Thomas Tourlourat
050a2dc919 Add missing connection and header 2014-12-09 14:28:57 +01:00
Lorin Hochstein
c4d5e9195b Docfix: checking a background task
Minor changes to wording on how to check a background task with async_status.

Fixes #9740
2014-12-08 21:52:03 -05:00
Michael DeHaan
5890876d72 Merge pull request #9737 from lorin/doc-nopoll
Docfix: running background tasks without polling
2014-12-08 14:04:19 -08:00
Lorin Hochstein
e86259cdf3 Docfix: running background tasks without polling
Fix the example in the doc to explicitly set the poll interval to zero so the
job doesn't poll.

To run a background task without polling, you need to set the poll interval to
zero. However, Ansible's default poll setting is 15 seconds, so not specifying the poll
interval will cause a background job to poll.
2014-12-06 21:24:50 -05:00
Veres Lajos
bf5d8ee678 typofixes - https://github.com/vlajos/misspell_fixer 2014-12-04 22:23:35 +00:00
Brian Coca
2d17d18c1b mentioned gathering settings in fact caching. 2014-12-04 07:44:21 -05:00
Toshio Kuratomi
2b11c2b845 Merge pull request #9691 from nousdefions/devel
changed time.py to timetest.py to avoid keyword usage
2014-12-02 11:48:35 -08:00
James Cammarata
a3b5efadd6 Remove references to "baby JSON" in module developing documentation 2014-12-02 13:42:13 -06:00
Jonathan Davila
1d2e23bc7e changed time.py to timetest.py to avoid keyword usage 2014-12-02 10:09:31 -05:00
Michael DeHaan
9bbfddedf6 Best practices docs tweaks. 2014-12-01 14:31:13 -05:00
Michael DeHaan
fe06241986 AWS Guide overhaul, WIP. 2014-12-01 14:31:13 -05:00
Adrian Lopez
f27ffdcbf0 Is it not possible to set a comment in the same line 2014-11-26 14:41:39 +01:00
Brian Coca
02f6ca034e zpelling fix 2014-11-20 16:32:33 -05:00
Sebastian Göttschkes
9660afd3e0 Adding inventory parameter to documentation
Adding the inventory parameter `ansible_sudo` to the list of behavioural
inventory parameters in the intro_inventory documentation.
2014-11-20 20:18:04 +01:00
James Cammarata
55fd4daf9c Merge pull request #9583 from electroniceagle/devel
change location of ec2.ini example to moved location
2014-11-20 12:58:18 -06:00
Brian Coca
0edaa6f790 Merge pull request #9270 from bcoca/do_the_shuffle
added new 'shuffle' filter
2014-11-20 13:43:00 -05:00
Brian Schott
c8bfc61172 change location of ec2.ini example to moved location 2014-11-20 13:15:38 -05:00
Brian Coca
a897a5ea89 Merge pull request #9561 from bcoca/variable_precedence_clarification
minor clarifications of variable precedence
2014-11-19 12:05:18 -05:00
Michael DeHaan
f8ca975c75 The Guru program has been folded in with Ansible Tower. Have
questions or interested in Ansible support?  We'd love to hear from you.
Email us at info@ansible.com.
2014-11-18 17:20:53 -05:00
Brian Coca
9245acbf44 Merge pull request #9564 from bcoca/start_step_docs
Start step docs
2014-11-17 11:18:52 -05:00
Brian Coca
d1e80ea1e6 removed version added info, too old to matter
small rephrasing for clarification
2014-11-17 11:17:47 -05:00
Chris Church
42c4928cbb Merge pull request #9562 from johnpbatty/devel
Fix documentation link to issue template
2014-11-15 17:29:23 -05:00
Brian Coca
897965ce4d removed start/step from intro, added markers to start n step 2014-11-15 17:09:55 -05:00
Brian Coca
e0110903c7 put start and step docs into their own topic, moved from playbook_intro
which is meant to be kept simple
2014-11-15 17:01:25 -05:00
John Batty
9fa163c565 Fix documentation link to issue template
On the Ansible Community page (http://docs.ansible.com/community.html)
in the "I'd like to report a bug" section, the link to the "issue
template" is broken - it links to URL
https://raw2.github.com/ansible/ansible/devel/ISSUE_TEMPLATE.md, which
results in a GitHub 404 (Page not found) error page .

Fix points link to a URL that works.
2014-11-15 21:40:42 +00:00
Brian Coca
4caed6d450 Merge pull request #9266 from sjahl/step-start-docs
Documents the --step and --start-at options to ansible-playbook.
2014-11-14 21:49:24 -05:00
Brian Coca
8d37c6f091 minor clarifications of variable precedence 2014-11-14 16:20:52 -05:00
Brian Coca
0f2f022bb0 removed YAML as documented local facts format as it is not supported and
would require extra modules on target.
2014-11-12 17:55:58 -05:00
Chris Church
fa953e162e Merge pull request #9193 from vkhramtsov/fix-password-grammar-in-windows-intro
Fix grammar in password (windows-intro)
2014-11-10 22:28:11 -05:00
Brian Coca
5a4a212869 Merge pull request #9495 from AloisMahdal/longer_vid
Fix note about video length
2014-11-07 17:51:09 -05:00
Toshio Kuratomi
f1267c0b05 Move from md5 to sha1 to work on fips-140 enabled systems 2014-11-06 21:28:04 -08:00
Brian Coca
8e2a8c92ac changed examples to not have a non working variable that gets confused
with directives as per #9264
2014-11-06 08:20:01 -05:00
Brian Coca
d25748b037 Merge pull request #9502 from nikut/delegate_docfix
add documentation for the delegate_to magic variable
2014-11-06 08:06:57 -05:00
Niku Toivola
5a11315dc7 add documentation for the delegate_to magic variable 2014-11-06 15:03:03 +02:00
Alexander Ershov
9112f650c0 Fix path to the integration tests
"tests/integration" -> "test/integration"
2014-11-06 13:50:36 +03:00
Alois Mahdal
d1cc49fc55 Fix note about video length
Perhaps due to update mentioned at /resources page, the video is 34
minutes long.
2014-11-06 02:38:21 +01:00
Brian Coca
afd8cca345 Merge pull request #9451 from bcoca/load_aliases
Load aliases
2014-11-04 10:24:11 -05:00
James Cammarata
e1662422bf Merge pull request #9467 from lorin/accel-docs
Docs: accelerate mode -> accelerated mode
2014-11-03 11:49:34 -06:00
James Cammarata
6dbc45042b Merge pull request #9436 from bobobox/patch-2
vars_files haven't been discussed yet
2014-11-03 11:20:40 -06:00
Lorin Hochstein
684cdd0298 Docs: accelerate mode -> accelerated mode
The docs sometimes referred to "accelerated mode" as "accelerate mode".
This patch changes it to "accelerated mode" everywhere.
2014-11-01 19:31:04 -04:00
James Cammarata
fe0ab8e750 Merge pull request #9408 from aklamio/devel
Update playbooks_variables.rst
2014-10-29 13:38:35 -05:00
Brian Coca
cc12c9b226 fixed typo 2014-10-29 10:32:17 -04:00