James Cammarata
8bfba5c0b4
Adding documentation for role default variables
2013-08-30 10:13:22 -05:00
James Cammarata
deb5f027f0
Fixed up a few other pages that had the same versionadded error
2013-08-23 11:33:57 -05:00
James Cammarata
f8a54d162d
Fixing versionadded fields in the playbook doc
2013-08-23 11:04:06 -05:00
James Cammarata
f40d39bc92
Minor formatting change
2013-08-22 23:35:23 -05:00
James Cammarata
e1b1d09210
Remove references to old-style variables
...
Fixes #3842
2013-08-22 23:33:18 -05:00
James Cammarata
1f42fd9964
Remove references to old-style variables
...
Fixes #3842
2013-08-22 23:29:13 -05:00
James Cammarata
b33cd0c44f
Added a note in the advanced playbooks section regarding YAML extra vars
2013-08-22 20:18:15 -05:00
Stoned Elipot
f0743fc32a
Introduce the 'always_run' task clause.
...
The 'always_run' task clause allows one to execute a task even in
check mode.
While here implement Runner.noop_on_check() to check if a runner
really should execute its task, with respect to check mode option
and 'always_run' clause.
Also add the optional 'jinja2' argument to check_conditional() :
it allows to give this function a jinja2 expression without exposing
the 'jinja2_compare' implementation mechanism.
2013-08-20 23:09:44 +02:00
Jon W
d000f23344
typo
...
just darting a mistyped "ansible"
2013-08-20 12:11:51 -05:00
Jon W
c4ab7009b2
minor corr pip-install
...
perhaps there may be pip distribution using "pip-install" but "pip install" is universal afaik
2013-08-20 11:39:04 -05:00
Michael DeHaan
15e2ccd2d9
Moving some role deps stuff around a small amount.
2013-08-16 22:05:26 -04:00
Michael DeHaan
42648e2f0a
Merge branch 'role_dependencies' of git://github.com/jimi1283/ansible into jimi1283-role_dependencies
2013-08-16 21:42:57 -04:00
Michael DeHaan
0eb1827936
Some install guide tweaks.
2013-08-16 17:02:35 -04:00
James Cammarata
5429586985
Adding documentation on role dependencies and variable scope/inheritance
2013-08-16 10:34:45 -05:00
Michael DeHaan
11fe4566f8
Document facts.d
2013-08-12 09:49:54 -04:00
Michael DeHaan
6af77226fa
Merge pull request #3818 from resmo/feature/docsite-update
...
update docsite about new variable inventory_file
2013-08-11 12:50:20 -07:00
Abhijit Menon-Sen
1a90d01ba9
Fix some typos discovered during casual reading
2013-08-11 18:41:23 +05:30
René Moser
28267de3fe
update docsite about new variable inventory_file
2013-08-11 11:08:57 +02:00
Michael DeHaan
220cc75cd9
Merge pull request #3805 from lwade/docs
...
Modified playbooks2.rst to include conditional boolean example.
2013-08-10 14:24:31 -07:00
lwade
a46e0f9788
Modified playbooks2.rst to include conditional boolean example.
2013-08-09 13:24:48 +01:00
Michael DeHaan
067cc9274d
Add note about python-selinux.
2013-08-08 09:15:24 -04:00
Michael DeHaan
18be6dcb62
Use blockquote in docs.
2013-08-06 16:45:24 -04:00
Michael DeHaan
bcaa983c2f
Document inventory script upgrades
2013-08-04 11:45:31 -04:00
Michael DeHaan
d039fbe200
Merge pull request #3649 from dekked/extra-vars-from-file
...
Extra vars from file
2013-08-03 11:31:58 -07:00
Michael DeHaan
82d6323845
Update docs on action shorthand.
2013-08-01 20:28:37 -04:00
Alan Descoins
d505474832
Updated documentation.
2013-07-23 19:49:27 -03:00
Joshua Lund
be6feee058
Minor cleanup of YAML Syntax documentation
2013-07-22 16:09:18 -06:00
Ches Martin
b35fc42d36
Enhance meta-docs on... contributing to docs.
...
- Update FAQ entry to refer to docsite README and reduce redundancy.
- Add additional info to docsite README: Sphinx building, link to module
documentation reference.
2013-07-22 17:20:38 +07:00
Tim Gerla
7e07bca6bf
very minor fix to playbooks2 to fix a formatting error
2013-07-21 11:50:12 -07:00
Michael DeHaan
77a4dcca85
Sphinx/docs syntax fixes
2013-07-21 11:18:07 -04:00
Michael DeHaan
feb4a8847d
Slight edit to when_changed docs
2013-07-21 10:48:22 -04:00
Michael DeHaan
b603bb0f73
Merge branch 'changed_when-doc' of git://github.com/stoned/ansible into devel
2013-07-21 10:41:35 -04:00
Xiao Hanyu
23ff2f2992
Merging docs
2013-07-20 12:44:37 -04:00
Joshua Lund
e8c6da6045
Cleanup Glossary documentation
2013-07-19 17:32:00 -06:00
Michael DeHaan
9314341923
Merge pull request #3465 from jlund/best-practices
...
Add documentation for Role Variables to the Best Practices page
2013-07-19 07:33:39 -07:00
Michael DeHaan
ce89382473
Legacy variable removal.
2013-07-19 10:27:37 -04:00
Michael DeHaan
597e5075f1
Merge pull request #3585 from devo-ps/documentation
...
Minor typo on site about host_key_checking config section.
2013-07-19 06:50:28 -07:00
Michael DeHaan
1867fb4888
Update an example.
2013-07-19 09:49:44 -04:00
Michael DeHaan
10bc6f6d9c
Merge pull request #3541 from pol/docs_withitems_regivar
...
Create with_items example with a registered var
2013-07-19 06:46:31 -07:00
Michael DeHaan
c101d4b30b
Documentation indentation fix.
2013-07-19 09:33:31 -04:00
Michael DeHaan
deda5c8ee7
Remove backlinks:top which is setting hyperlinks in docs sections so they are hard to bookmark.
2013-07-19 09:33:31 -04:00
Michael DeHaan
ad5ac71219
Merge pull request #3542 from pol/docs_task_format
...
Update to conventional task format
2013-07-19 06:26:42 -07:00
Michael DeHaan
f938bc660f
Slight documentation tweak.
2013-07-19 09:13:30 -04:00
Michael DeHaan
21e06a87ce
Merge pull request #3530 from candeira/with_nested
...
add documentation for with_nested
2013-07-19 06:11:37 -07:00
Vincent Viallet
6a00cb7b3b
Minor typo on site about host_key_checking config section.
2013-07-19 13:26:30 +08:00
Joshua Lund
a5459e8a03
* Added documentation for Role Variables
...
* Fixed a few minor typos
2013-07-16 14:53:20 -06:00
Pol Llovet
8a0861f804
Create with_items example with a registered var
2013-07-15 17:44:50 -06:00
Pol Llovet
d933fef93f
Deprecate only_if in favor of when.
2013-07-15 17:41:09 -06:00
Pol Llovet
bd7448ccf0
Update to conventional task format
2013-07-15 17:35:20 -06:00
Javier Candeira
d3a97bfb07
add documentation for with_nested
2013-07-15 14:28:02 +10:00
Stoned Elipot
60d2ad3642
Document changed_when clause
2013-07-14 21:43:10 +02:00
Michael DeHaan
324a28f3dd
Merge pull request #3439 from eest/bestpractices_templates_fix
...
Fix path to ntp.conf.j2 in example.
2013-07-11 05:31:25 -07:00
Michael DeHaan
90dfc115d6
Merge pull request #3463 from stoned/filterskipped
...
Add Jinja2 filter 'skipped' to test for a registered variable from a ski...
2013-07-11 05:26:25 -07:00
Joshua Lund
7c78fef1f5
Fixed some minor typos in the Advanced Playbooks documentation
2013-07-10 13:09:12 -06:00
Stoned Elipot
906746b1f0
Add Jinja2 filter 'skipped' to test for a registered variable from a skipped task
2013-07-07 22:13:14 +02:00
Michael DeHaan
d002c2d907
Document 'smart' option and connection type default changes.
2013-07-04 19:10:56 -04:00
Michael DeHaan
107ced7ec5
Mention envrionment variable configuration.
2013-07-04 18:56:46 -04:00
Michael DeHaan
1ead97098d
Talk more about transports in documentation.
2013-07-04 18:51:47 -04:00
Patrik Lundin
1f1aa1f0a8
Fix path to ntp.conf.j2 in example.
...
The "common" role adds "common/templates/" to the src path.
2013-07-04 15:42:46 +02:00
Michael DeHaan
f3dc5707a8
Merge pull request #3282 from jlaska/devel
...
Reference ansible_lsb.major_release, not ansible_lsb.major_version
2013-06-30 16:43:30 -07:00
Michael DeHaan
39105dc853
Fix RST formatting in documentation (underline too short)
2013-06-30 19:01:06 -04:00
Michael DeHaan
6dd93fa964
Some minor doc tweaks
2013-06-30 18:32:49 -04:00
Michael DeHaan
ee4d9b1516
Merge branch 'devel' of git://github.com/shirou/ansible into devel
2013-06-30 18:28:35 -04:00
Michael DeHaan
f2e3a9a850
Merge pull request #3370 from y-p/PR_role_doc_enh
...
Add doc example of attaching tags to a role
2013-06-30 14:18:11 -07:00
y-p
a4dfc14a6c
Add doc example of attaching tags to a role
2013-06-28 16:28:41 +03:00
shirou
a439afeb8f
add description about host parameters in a inventory file.
2013-06-28 17:59:47 +09:00
James Laska
eb2ae8b3c2
Reference major_release, not major_version
2013-06-20 08:23:49 -04:00
Michael DeHaan
85ef79443a
Fix a documentation formatting warning.
2013-06-19 22:38:04 -04:00
Joshua Lund
0f81d1630f
* Updated all ansible.cc references in the documentation to point
...
to ansibleworks.com
* Fixed a few misspelled words
2013-06-19 19:34:02 -06:00
Michael DeHaan
58f5bfb4c1
Merge pull request #3252 from tgerla/gettingstarted
...
Explicitly mention the Linux requirement for the Ansible machine, remove...
2013-06-19 17:08:11 -07:00
Tim Gerla
f2cf8d3e67
Fine-tune Ansible control system OS requirements a bit
2013-06-18 18:19:58 -07:00
Jim Tittsler
240a52906e
spelling ansbile->ansible
2013-06-19 10:37:02 +12:00
Tim Gerla
6f426f7986
Explicitly mention the Linux requirement for the Ansible machine, and remove a vestigial heading.
2013-06-18 12:12:37 -07:00
Michael DeHaan
89ee762ab7
Merge pull request #3247 from SirScott/vars_prompt_docs
...
Document the 'default' argument for vars_prompt.
2013-06-18 11:48:49 -07:00
Joshua Lund
ba853b8c1a
Fixed a few small typos
2013-06-18 12:26:40 -06:00
Scott Sturdivant
cc12b85e49
Document the 'default' argument for vars_prompt.
2013-06-18 09:25:51 -06:00
Michael DeHaan
fda74110bd
Merge pull request #3202 from trbs/20130613_docs_fix_ansible_cfg_loading_order
...
docs fix ansible cfg loading order
2013-06-16 20:17:25 -07:00
Michael DeHaan
306caf84f9
Merge pull request #3218 from lorin/fileglob-roles
...
Document: with_file(glob) relative path and roles
2013-06-16 19:52:22 -07:00
Michael DeHaan
a1d1ce8360
Merge branch 'docs_examples' of git://github.com/jpmens/ansible into standardize_docs
2013-06-16 22:07:20 -04:00
Jan-Piet Mens
5c69918d53
DOCS: standardize on EXAMPLES (a.k.a. Docs-JumboPatch JetLag Edition)
...
Migrated all examples: in DOCUMENTATION=''' string to standalone EXAMPLES=''' string
Added deprecation warning to moduledev.rst and remove deprecated example from it
Fixed up a few typos and uppercased some acronyms.
add consistency to how EXAMPLES are formatted
2013-06-15 20:54:25 +02:00
Lorin Hochstein
d7ba2e06eb
Document: with_file(glob) relative path and roles
...
Document that with_file and with_fileglob path is relative to
the files directory inside of a role.
2013-06-14 11:15:45 -04:00
trbs
653fac2f5c
fix loading order of ansible.cfg in documentation
2013-06-13 23:13:54 +02:00
Ralph Bean
dd5707ddd9
Well, a little more readability.
2013-06-11 14:58:28 -04:00
Ralph Bean
416e72c900
Fix a typo in the docs.
2013-06-11 14:54:42 -04:00
Michael DeHaan
643b5e2c5d
Fix dead link, remove redundant section.
2013-06-10 18:37:56 -04:00
Michael DeHaan
1fd863cf5d
Update docs to reference release tarball directory on new site.
2013-06-10 16:06:58 -04:00
Tim Gerla
8a9cded133
re-add docs css class required for some theme elements
2013-06-10 07:57:13 -07:00
Michael DeHaan
36e9cf5d7d
Mention YAML variable quoting.
2013-06-09 21:35:51 -04:00
Michael DeHaan
36c3c91d6e
Add roles to glossary.
2013-06-09 21:20:35 -04:00
Buce
7d2422cf92
Update supported package managers
...
Ansible has modules for package managers other than yum and apt,
so update the documentation accordingly.
2013-06-09 17:16:08 -04:00
Buce
563147d344
Reference Inventory & Patterns more
...
Link to the Inventory & Patterns page in places where the Getting
Started guide refer to it, so that users unfamiliar with the
inventory syntax can easily familiarize themselves with it.
2013-06-09 17:16:08 -04:00
Tim Gerla
b3e0071635
show entire doc index in left sidebar on the documentation home page
2013-06-09 11:04:16 -07:00
Michael DeHaan
92dce671bb
Resolve merge commit
2013-06-09 13:57:20 -04:00
Michael DeHaan
d706aca82b
Merge
2013-06-09 13:55:58 -04:00
Michael DeHaan
2f37314d41
Revise section referencing 1.1 since release is Monday. Will push with release.
2013-06-08 14:15:10 -04:00
Michael DeHaan
cabeafc550
Remove 1.1 reference (docs will be pushed with release of 1.2)
2013-06-08 14:14:12 -04:00
Bartłomiej Piotrowski
cd65bbc1c4
Add info about apk-tools module to contrib.rst.
2013-06-06 15:00:05 +02:00
Tim Gerla
a26cbd957c
fix heading styles for 'pending information' to avoid creating a new top-level chapter
2013-06-04 14:57:43 -07:00
Patrick Regan
4e5c0da7d6
Trivial typo fix in Amazon documentation
2013-06-03 13:54:26 -04:00
Serge van Ginderachter
18e7974021
add mention of github.com/ginsys/ansible-plugins in contrib.rst
2013-06-02 17:56:12 +02:00
Michael DeHaan
7f0e89a2f6
Explain when statements with |failure and |success.
2013-06-01 17:41:31 -04:00
Michael DeHaan
754d5f91a3
Show how to set PW length.
2013-06-01 12:36:24 -04:00
Michael DeHaan
bddbdd4881
avoid duplicate hyperlink warning (silly Sphinx)
2013-06-01 12:22:06 -04:00
Michael DeHaan
1de2028677
Update docs about examples, add edX online's configuration repo to examples
2013-06-01 11:46:32 -04:00
Michael DeHaan
9f567f05d6
Document group_vars and host_vars additional paths.
2013-06-01 10:40:39 -04:00
Michael DeHaan
fbba92b61e
Add an example of JSON extra variables on the command line.
2013-05-31 16:07:40 -04:00
Jan Duzinkiewicz
8ebd1792eb
advanced playbooks docs yaml snippets always use ---
2013-05-31 10:54:13 +02:00
Michael DeHaan
e75ab08e3d
Merge pull request #3054 from maxamillion/maxamillion/docsite
...
provide link to older docs when mentioning older docs
2013-05-29 16:55:30 -07:00
Michael DeHaan
53c490f453
Merge pull request #3050 from lorin/os-grizzly-only
...
Document: OpenStack inventory script needs grizzly
2013-05-29 15:54:49 -07:00
Michael DeHaan
fd77804bff
Merge pull request #3017 from sergevanginderachter/roles-script
...
Add roles support for the script module
2013-05-29 15:54:18 -07:00
Adam Miller
80bf5d49fe
provide link to older docs when mentioning older docs
2013-05-29 17:29:59 -05:00
Michael DeHaan
0a28358ebc
Minor docs tweak.
2013-05-29 18:27:16 -04:00
Michael DeHaan
c9b2df619b
Merge pull request #3043 from mvo5/feature/document-facts
...
Feature/document facts
2013-05-29 15:23:15 -07:00
Michael DeHaan
31b31a12e7
Merge pull request #3052 from chelsea/devel
...
Updated loop documentation with explicit example of hash usage
2013-05-29 15:21:19 -07:00
Adam Miller
33870745b1
fix ambiguous use of automatically automatic in Roles docs
2013-05-29 17:14:20 -05:00
Chelsea Robb
b8045bc29e
Updated loop documentation with explicit example of hash usage
2013-05-30 08:05:14 +10:00
Michael DeHaan
b5ed926720
Add AWS doc to table of contents.
2013-05-29 14:17:32 -04:00
Lorin Hochstein
bbe352b544
Document: OpenStack inventory script needs grizzly
...
The OpenStack Inventory script uses the OS-EXT-IPS:type parameter
to distinguish between fixed and floating IP addresses.
This was only added in the Grizzly release, see
https://bugs.launchpad.net/nova/+bug/1117784
Specify in the docs that this inventory script requires Grizzly
or greater.
2013-05-29 11:38:11 -04:00
Michael DeHaan
267b29cec7
Manpage tweaks, docs rebuild
2013-05-29 10:30:04 -04:00
Michael DeHaan
efee2e2630
Some tweaks to EC2 docs
2013-05-29 10:25:54 -04:00
Michael DeHaan
383b8ce14a
Merge branch 'awsdocs' of git://github.com/lwade/ansible into devel
2013-05-29 10:15:02 -04:00
Michael DeHaan
2c433cb707
Add an example of Jinja2 casting.
2013-05-29 09:43:32 -04:00
Michael Vogt
746edecf68
fix indent
2013-05-28 18:32:14 +02:00
Michael Vogt
b625f99938
fix typo
2013-05-28 18:25:44 +02:00
Michael Vogt
e13842fad1
add gathering-facts example
2013-05-28 18:23:12 +02:00
Michael Vogt
03e9d9a742
update info on debian/ubuntu packages
2013-05-28 18:12:33 +02:00
Serge van Ginderachter
5859af7285
script support for roles: use the files/ directory
...
instead of an additional scripts/ directory
2013-05-25 16:51:59 +02:00
Serge van Ginderachter
0224dc464d
roles/x/scripts support: update docs
...
also added example on where regular tasks fit in
2013-05-24 22:42:24 +02:00
lwade
07a1b2f1c1
Start of aws best practices docs
2013-05-24 16:59:24 +01:00
Michael DeHaan
8475a92dec
Merge pull request #2939 from mmoya/lookup-crypted-passwds
...
Add support for crypted passwords to password lookup
2013-05-18 13:17:41 -07:00
Maykel Moya
96afc3f462
Add support for crypted passwords to password lookup
...
Added new parameter 'encrypt' with same semantics from that of
vars_prompt. When encryption is requested a random salt will be
generated and stored along the password in the form:
'<password> salt=<salt>'.
Also store passwords with an ending '\n' for easier looking at files
with console tools. File content was being already rstripped so this
is harmless.
2013-05-16 13:24:54 +02:00
Stoned Elipot
2b58e03571
Fix registered variable usage example
2013-05-15 22:11:07 +02:00
Michael DeHaan
8a860779fd
Add some notes about 1.2 things, just to make it more obvious.
2013-05-11 16:40:09 -04:00
Michael DeHaan
0748e86f0e
Fix documentation about examples in modules so folks use the new style.
2013-05-11 16:32:22 -04:00
Maykel Moya
db618f837f
Fix link to Ansible Resources in moduledev page
2013-05-07 13:01:53 +02:00
Michael DeHaan
1b5dd3f15b
Clean up variable examples to say "$x" is still fine for a reference.
2013-05-05 13:21:47 -04:00
Michael DeHaan
63b4eea90b
Remove searchindex.js from source control.
2013-05-05 12:51:27 -04:00
Michael DeHaan
d1a59fe62b
Merge branch 'when_docs' of git://github.com/tartansandal/ansible into devel
...
Conflicts:
docsite/latest/rst/playbooks2.rst
docsite/latest/searchindex.js
2013-05-05 12:43:06 -04:00
Kahlil (Kal) Hodgson
cabd40b0aa
add docs for 'when: var is defined' idiom
2013-05-03 08:57:31 +10:00
Lorin Hochstein
c66b724817
Document: sudo works per-task too
...
Document that you can use sudo at the task level as well
2013-05-02 15:14:53 -04:00
Michael DeHaan
ce67588dcf
Fix module doc organization
2013-05-02 11:35:24 -04:00
Michael DeHaan
627b6a0455
Have 1.2 clear in docs
2013-05-02 11:31:51 -04:00
Tim Gerla
bdf50d1fb7
Fix up a couple of references to 'only_if' and change them to 'when'
2013-05-02 09:22:08 -04:00
Michael DeHaan
4ce6eca8b3
Slight tweak to set_fact variable documentation to clarify scope info.
2013-04-29 19:15:29 -04:00
Michael DeHaan
4bea9a612f
Don't use "finally" here as it's not 2.4 compliant.
2013-04-28 16:03:03 -04:00
Michael DeHaan
391fb98ee2
Allow modules to be categorized, and also sort them when generating the documentation.
2013-04-28 15:03:45 -04:00
Michael DeHaan
0fd3af8c3c
Document regex patterns.
2013-04-27 12:04:22 -04:00
Michael DeHaan
099e7b39a9
use lookup macro rather than with to demonstrate lookup plugins
2013-04-27 11:59:33 -04:00
Michael DeHaan
a61824470d
Update gitignore
2013-04-27 11:55:31 -04:00
Michael DeHaan
b6a8d402c5
Document variables are reserved.
2013-04-27 11:54:30 -04:00