Commit Graph

377 Commits (a56c695bc84e779a63025670d353cf970f2c4812)

Author SHA1 Message Date
Michael DeHaan 4bea9a612f Don't use "finally" here as it's not 2.4 compliant. 12 years ago
Michael DeHaan 391fb98ee2 Allow modules to be categorized, and also sort them when generating the documentation. 12 years ago
Michael DeHaan 0fd3af8c3c Document regex patterns. 12 years ago
Michael DeHaan 099e7b39a9 use lookup macro rather than with to demonstrate lookup plugins 12 years ago
Michael DeHaan a61824470d Update gitignore 12 years ago
Michael DeHaan b6a8d402c5 Document variables are reserved. 12 years ago
Lars Vogdt 21d9789377 added informations for openSUSE and SUSE Linux Enterprise 12 years ago
Michael DeHaan 13e90c396c Merge pull request #2733 from chadoh/patch-1
Documentation: Mention vars_files before the Roles section in playbooks1 chapter
12 years ago
Stoned Elipot e1ee257619 Default sudo password to SSH password.
While here factor out password prompting in ansible.utils
12 years ago
Michael DeHaan b1d40ed064 Merge pull request #2734 from chadoh/patch-2
Documentation: Links are the best kinds of instructions
12 years ago
Jim Kleckner 5e5235a433 Nit fix spelling of separate 12 years ago
Chad Ostrowski e1396f853b Links are the best kinds of instructions
Link people right to this page on Github, so they can click "edit" right there. No need for them to search for the repo, figure out that the docsite isn't a separate repo, and navigate to the given dir.
12 years ago
Chad Ostrowski 0bb145af40 Mention vars_files before the Roles section
The Roles section assumes some familiarity with vars_files, which this note attempts to briefly provide.
12 years ago
Michael DeHaan 7fabaec55f Fix doc formatting error 12 years ago
Michael DeHaan c9a128a5c5 Rewrote the precedence docs. 12 years ago
Michael DeHaan cf3c77661b Document the new handler flushing system. 12 years ago
Michael DeHaan 84781bf185 Add documentation about pre_tasks and post_tasks with roles. 12 years ago
Michael DeHaan adac8f5312 Showcase the new-style lookup plugin access in the authorized_key docs rather than the old-style $FILE 12 years ago
Michael DeHaan cce2cad8dc Fix with_sequence doc error 12 years ago
Michael DeHaan 84fb92dac6 Working on the FAQ. 12 years ago
Michael DeHaan 728d81bf12 Add link to prior docs version. 12 years ago
Michael DeHaan 62fe4cc3af Explain conditionals as applied to roles. I could also explain with_items but the scope questions are complex
here, and it is better to include such loops inside the imported tasks.
12 years ago
Michael DeHaan 687a68091f Mention roles in best practices 12 years ago
Michael DeHaan ffb00d2071 Favor {{ foo }} rather than $foo in documentation. 12 years ago
Michael DeHaan 9ed246e432 Resolve merge conflict. 12 years ago
Michael DeHaan 26819d707d Reorganize docs structure to support snapshots. 12 years ago
Michael DeHaan e63dac15eb Moving some more files into snapshot directory 12 years ago
Michael DeHaan 148d8859ba Docs on parameterized roles, make document generation output less noisy 12 years ago
Michael DeHaan a0a2ef3d9d Merge pull request #2640 from trevor/devel
make json valid
12 years ago
Trevor Wennblom b779fa4fe9 make json valid 12 years ago
Michael DeHaan c5d9823467 Fix some items related to playbook includes and indentation. 12 years ago
gw0 80a4e02372 Improved Lookup plugins documentation 12 years ago
Michael DeHaan f9890c9973 Show other way to ignore command/shell errors 12 years ago
Michael DeHaan bccab0f2b7 Merge pull request #2514 from raphinou/patch-1
replaced && by ||
12 years ago
Michael DeHaan cdf5e006ff Merge pull request #2508 from tgerla/devel
Add some examples for local_action and rsync
12 years ago
Victor Castell ceede2f71f Place ad-hoc stuff from docs under context 12 years ago
raphinou ba2582fff6 replaced && by ||
In the example, you want /bin/true to be executed if the first command has an error return code. Combining command with && will run the second only if the first is successful. Combining them with ||, the second will be run only of the first fails, what is wanted here.
12 years ago
Tim Gerla d3a7c729ab Add a note regarding rsync and ssh-agent/passphrase-less keys 12 years ago
Tim Gerla 0e01085ab6 Add some examples for local_action and rsync 12 years ago
Michael DeHaan 783a12cc0e Resolve merge commit. 12 years ago
Michael DeHaan 518007a1ba Fix version added attribute, update docs URL 12 years ago
Michael DeHaan 3d5aa5dc2c Merge pull request #2487 from dorfsmay/20130322
fixed doc regarding wild card pattern on groups.
12 years ago
michael@ansibleworks.com ecda87cb63 Fixup docsite links 12 years ago
michael@ansibleworks.com e086d6fd89 Doc updates 12 years ago
Yves Dorfsman 5485451ddb fix doc regarding wild card pattern on groups. 12 years ago
Tim Gerla 242f988daf Add links to the ansible-examples repository 12 years ago
Yves Dorfsman 8b10cc5946 Mention of ansible-doc and man pages for modules. 12 years ago
Michael DeHaan 22cd10bc6f Add note about wanting to do crypted passwords with $PASSWORD plugin. 12 years ago
Michael DeHaan afb9ad1358 Fix duplicate Sphinx target in documentation. 12 years ago
Michael DeHaan 64a3839511 Fixup documentation formatting 12 years ago
Lorin Hochstein efd3cbe8b4 Document how to implement check mode
Fixes #2410
12 years ago
bfx81 649dc25d46 Updated getting ansible on gentoo 12 years ago
Michael DeHaan 7d6d009d15 Merge pull request #2411 from tyll/docs
glossary.rst: fix type regarding file mode
12 years ago
Lorin Hochstein c7cf2bc343 Docfix: ANSIBLE_LIBRARY_PATH -> ANSIBLE_LIBRARY 12 years ago
Till Maas 2b4621d8d7 glossary.rst: fix typo regarding file mode 12 years ago
Yves Dorfsman 2d0df2f233 Rephrased an awkward sentence. 12 years ago
Yves Dorfsman d1d7d56315 typo in playbooks2.rst 12 years ago
Michael DeHaan c53653dc0d Merge pull request #2348 from candeira/password-plugin
password lookup plugin, with working tests and documentation
12 years ago
Michael DeHaan daf7419f3a Make Python 3 instructions a bit more clear. 12 years ago
Javier Candeira ca6c36e1ac password lookup plugin, with working tests and documentation 12 years ago
Michel Blanc 9c6b28c218 Update gettingstarted.rst
Adds note on python 3 incompatibility
Added note about ansible_python_interpreter for people having python3 as default interpreter (mainly Arch users ?)
Should fix #2344
12 years ago
Jim Kleckner 92844d3dcd Minor spelling fixes 12 years ago
Michael DeHaan b11cf15b3e Merge pull request #2302 from leucos/patch-1
Update playbooks2.rst
12 years ago
Michael DeHaan 0b1343a281 Merge pull request #2306 from tbielawa/docdepends
Update the Makefile and build-site.py to notify of missing dependencies
12 years ago
Tim Bielawa badb41390e Update the Makefile and build-site.py to notify of missing dependencies for doc compiling 12 years ago
Michel Blanc aeed04b73f Cosmetic fixes
Fixed typo in passlib URL link
Fixed style in cryp scheme list
Fixed bullet 7 in variable precedence section
Adds statement regarding passlib requirement
12 years ago
Michel Blanc f3b06a3008 Adds crypt scheme list for vars_prompt
Added more details on encrypt usage for vars_prompt, including a list of
crypt schemes and a ling to the passlib documentation.
12 years ago
Michel Blanc d03954a24b Update playbooks2.rst
Added doc on encrypt capability of vars_prompt.
Assuming the example in https://github.com/ansible/ansible/blob/devel/examples/playbooks/prompts.yml is still valid.
12 years ago
Dag Wieers 59912b47be Allow 'make rpm' without the need for env-setup
As it used to be before, 'make rpm' from a cloned repository should work without the need to run hacking/env-setup. It's an easy fix, in line with what we already did for the man-pages.
12 years ago
Daniel Hokka Zakrisson b130716b61 YAML requires quoting the entire value when it starts with a quote
Fixes #2280.
12 years ago
Michael DeHaan de09e9dade Update doc reference to clarify that $item isn't expanded here. 12 years ago
Brian Coca 372b60a5f7 Added tip about ANSIBLE_KEEP_REMOTE_FILES to docsite
Signed-off-by: Brian Coca <briancoca+dev@gmail.com>
12 years ago
Michael DeHaan a19a0ca91b Update documentation on complex args to new simpler format. 12 years ago
Michael DeHaan ff32e404d5 Most people are better off doing looping inside the playbook versus
outside, and get confused about scope.  As a result simply this documentation
feature by not talking about it :)
12 years ago
Daniel Hokka Zakrisson 52c9a7af24 Fix references to user.username to be user.name 12 years ago
Cliffano Subagio 19082f7b20 Fix proxy env format
The incorrect format (e.g. http_proxy=http://proxy.bos.example.com:8080) gave this error: "environment must be a dictionary".
12 years ago
Michael DeHaan f6e3583b9b Fix path to DOCUMENTATION.yml 12 years ago
Michael DeHaan 3aceae57af Fixup documentation formatting 12 years ago
Michael DeHaan a5e4f4461e Add linode example, remove macports since it didn't do changed=True/etc 12 years ago
Michael DeHaan bd6852eda0 Merge branch 'doc_html_tweaks' of git://github.com/nigelm/ansible into devel 12 years ago
Michael DeHaan 7a6f3e6a6a Missing colon in docs. 12 years ago
Nigel Metheringham 9ae64ffba9 Added top padding to h2 elements so not under menubar 12 years ago
Nigel Metheringham 86d55c1c4d Tweak maximum length of drop down menu 12 years ago
Lorin Hochstein 2e8533aec2 Add a missing :: in an .rst file
Other changes are just eating trailing whitespace.
12 years ago
Michael DeHaan 908a192736 Documentation updates 12 years ago
Michael DeHaan c86b34dae1 Lots of docsite additions for new features + cleanup lineinfile YAML docs 12 years ago
Michael DeHaan 3422ae6737 Document how to do task includes using with_items and externalized data. 12 years ago
Michael DeHaan 9a04c7eabc Add more 1.1 features 12 years ago
Michael DeHaan d8a77c0468 Add some 1.1 feature documentation 12 years ago
Michael DeHaan 69f0ce422e temporarily disabled, want to re-layout this later. 12 years ago
Michael DeHaan f01def384f Nothing references DOCUMENTATION.yaml, and it's incomplete, so remove it. 12 years ago
Michael DeHaan 7650d7c20e Explain ansible_python_interp. a little better 12 years ago
Michael DeHaan 1c6b0f93f1 Best practices doc updates 12 years ago
Michael DeHaan a2915bff8d Fix typo in svc docs 12 years ago
Michael DeHaan e51707711c Merge pull request #2120 from jpmens/doc_ex1
Add support for additional EXAMPLES string in Ansible modules
12 years ago
Nigel Metheringham 185790e32a Change title of localtoc menu from Page to Section 12 years ago
jibs fbe0b2ab43 minor docs tweak: link directly to ec2 ini file 12 years ago
Jimmy Tang 7f980bba8f Added more users of ansible (TCHPC and DRI) 12 years ago
Michael DeHaan 7f9bb9084f Rewrite best practices section. 12 years ago
Jan-Piet Mens 396a07bcc7 Add support for additional EXAMPLES string in Ansible modules
return DOC and EXAMPLES as a list
add moduledev explanation
more
12 years ago
Lorin Hochstein c6778e796c Specified when PIPE_ONCE was added.
Also, now shows when "Getting values from files" was added, a sphinx
directive was missing a colon.
12 years ago
Lorin Hochstein ec16b854a5 Document new PIPE_ONCE macro 12 years ago
Michael DeHaan c000bd846b Hate to do this, but URI module docs were constructing messed up RST files, so removing examples for now. Will ask someone to work on them. 12 years ago
Michael DeHaan ae2d7eb7af Rough cut at adding a glossary section. This could definitely use some improvements, proof reading, and lots of cross linking. 12 years ago
Michael DeHaan a6653a8723 Clean up the installation section and mention pip. 12 years ago
Michael DeHaan 4d880ec69a Updating links to useful articles 12 years ago
Michael DeHaan 02db951708 Update releases link on getting started page. 12 years ago
Michael DeHaan 8333b4eb03 Better explain magic variables 12 years ago
Michael DeHaan 408deab4e0 Slight doc tweak 12 years ago
Michael DeHaan 32f682946f Add video link to docsite 12 years ago
Michael DeHaan c79f8cc316 add user to who uses page 12 years ago
Michael DeHaan 6f0c9592bb Additions to Who Uses Ansible 12 years ago
Michael DeHaan 85b52ca625 Resort the who uses ansible page 12 years ago
Michael DeHaan f41cf5528c Add complex networking setup to docs! 12 years ago
Michael DeHaan 550a1b5f02 Remove mercurial module reference now that we have a cleaned up hg module in core now! 12 years ago
Michael DeHaan 5457e969db Add a reference to Coderwall for tips & tricks! 12 years ago
Lorin Hochstein 44084a83a4 Document :& host notation and using variables with hosts 12 years ago
Michael DeHaan 7d43865e13 Merge pull request #1986 from jcftang/devel
Documentation Fixes relating to OSX and macports
12 years ago
Stoned Elipot 312ba593fd Fix yum module examples: the 'pkg' parameter is now 'name' 12 years ago
Jimmy Tang 7a40ed41f7 Documentation Fixes relating to OSX and macports
Insert some notes about installing on OSX via macports
12 years ago
Michael DeHaan 5cdc25ec47 Tweak documentation example about lookup plugins 12 years ago
Michael DeHaan f4dddfdbab Fixup inventory docs 12 years ago
Michael DeHaan dd91452eda Better explain precedence. 12 years ago
Michael DeHaan bf088a50aa Add when_failed/changed dates 12 years ago
Michael DeHaan cde5b4b80c Reference sudo flag changeability. 12 years ago
Michael DeHaan 1e3df3b5ab Show how to assign lookup plugins in variables 12 years ago
Michael DeHaan fe5ab64b62 Document lookup plugin shorthand 12 years ago
Michael DeHaan 78ecc45d4d Document other syntaxes 12 years ago
Michael DeHaan 0ae7f996f5 Make sure all the lookup plugins are documented. 12 years ago
Jeff Blaine aaf6173fbe Correct python module name for jinja2 12 years ago
Lester Wade 33cc9719ba Update docsite/rst/who_uses_ansible.rst
Added Eucalyptus.
12 years ago
Daniel Hokka Zakrisson 950e3052b8 Merge pull request #1890 from elventear/rabbitmq_contrib
RabbitMQ Contrib
12 years ago
Brendan Taylor ab63c24358 Make diagram of Directory Organization best practice match the text.
The text and playbook content assumed a directory structure that didn't
match the diagram.
12 years ago
Pepe Barbe 9dfa3ca88f Add my repo for RabbitMQ stuff 12 years ago
Daniel Hokka Zakrisson 94a1c221bc Update variable precedence section with current rules 12 years ago
Michael DeHaan ea45423f92 Merge pull request #1885 from vincentvdk/devel
added info of required packages to build rpms
12 years ago
Vincent Van der Kussen 4af54e8a3b stylistic change. 12 years ago
Michael DeHaan 1cae679271 Merge pull request #1881 from fdavis/when_changed_fail
add when_changed when_failed example to docsite
12 years ago
Vincent Van der Kussen 614826bcda Fixed my typo and forgot a package 12 years ago
vincent Van der Kussen 80f82f80d8 added info of required packages to build rpms 12 years ago
fdavis 7899e29395 add when_changed when_failed examples to docsite
whitespace fix
12 years ago
Tim Gerla b814f3dc66 Correct --private-key argument name in Getting Started 12 years ago
Jan-Piet Mens fc3f50454d typo in ssh private key name 12 years ago
Jayson Vantuyl 13ddd39db9 add with_sequence lookup plugin
Plugin allows you to do easy counts for items.
12 years ago
Daniel Hokka Zakrisson 073fb21bcb Document that task includes are now infinite depth 12 years ago
Francis Besset e246304256 [docsite] Added LEMP selected playbook 12 years ago
Michael DeHaan 04195e202d Merge pull request #1747 from njharman/alpharange
Alphabetic inventory hostname patterns.
12 years ago
Javier Candeira dac83c15a0 fix documentation for authorized_key in advanced playbooks page in docsite 12 years ago
Dag Wieers 66fb7fd9de Make use of yes/no booleans in playbooks
At the moment Ansible prefers yes/no for module booleans, however booleans in playbooks are still using True/False, rather than yes/no. This changes modifies boolean uses in playbooks (and man pages) to favor yes/no rather than True/False.

This change includes:

- Adaptation of documentation and examples to favor yes/no
- Modification to manpage output to favor yes/no (the docsite output already favors yes/no)
12 years ago
jkleint e363abeca7 Missing colon in $FILE example 12 years ago
Mark Theunissen 660bb43e21 Tweak docs for correct paths and filenames 12 years ago
Norman J. Harman Jr 6603737e4d Alphabetic inventory hostname patterns.
- Code, docs, tests.
  - Also added test of large range 000-142 to verify alpha range did not
    break this.
12 years ago
Daniel Hokka Zakrisson 8d309e0fa3 Allow inventory scripts to define groups of groups and group vars 12 years ago
Michael DeHaan 21d858f36d Document new types of plugins. 12 years ago
Michael DeHaan da90c5f75e Document 'when' and tweak the code to be a little more comprehensive on what is false. 12 years ago
Michael DeHaan 08b3c77dc7 Tweak docs 12 years ago
Michael DeHaan c8d004434f Limit seperator docs. 12 years ago
Michael DeHaan 9870224991 Tweak fireball docs for 0.9 12 years ago
Jens Rantil 6e3e1c74c9 Fix minor spelling mistake in docsite 12 years ago
Jan-Piet Mens caf003c813 DOCUMENTATION strings 12 years ago
Michael DeHaan b46505d59d Update changelog and contrib.rst 12 years ago
Daniel Hokka Zakrisson b95bcf1b9d Use single-quotes to contain SSH keys as they may contain double-quotes
Fixes #1624.
12 years ago
Michael DeHaan 89bb1b8368 Fixup fireball installation playbook 12 years ago
Michael DeHaan 096607eea4 Allow fireball to transfer binary files, fixup fireball docs, make fetch work with fireball. 12 years ago
Michael DeHaan 8c0f83a2c9 Update "Who Uses Ansible" 12 years ago
Fabian Arrotin fba75aac0a Added Action.IO to who_uses_ansible and ansible-provisioning to contribs 12 years ago
Fabian Arrotin 2b3aeda33b Added jp_mens' presentation and removed dead links 12 years ago
Dag Wieers 2bccd7b1ac Fix example where imported ssh keys contain spaces
This fixes #1521
12 years ago
Michael DeHaan aa0af271d6 Quote some stuff in docs 12 years ago
Michael DeHaan 5bda1fc6cc Fix broken link 12 years ago
Michael DeHaan ac3983a249 revise docs text 12 years ago
Fabian Arrotin c5a66e96a2 Added the ansible_ssh_host and ansible_ssh_port variable in the patterns/inventory file 12 years ago
Michael DeHaan 2ae090b1db Update 'who uses' page 12 years ago
Michael DeHaan 8dbe6b6a74 Add HP on request 12 years ago
Michael DeHaan ebd9673ceb Tweak docsite re: resources/contrib page 12 years ago
Jan-Piet Mens 2d4e5ced90 Move contrib to .rst off the main docsite 12 years ago
Jeroen Hoekx b6ead4d9f8 Add D square to who_uses_ansible. 12 years ago
Nigel Metheringham ccd8d7c287 Spelling fixes 12 years ago
Nigel Metheringham dd5629cd51 Correct $last_result example in playbooks doc 12 years ago
Jan-Piet Mens feab57e270 Reformat code: examples consistently
- added terse syntax to modules.rst
 - added description of special variables to template module
12 years ago
Michael DeHaan 109632e3bc Revert "Vars specified via CLI have the highest priority."
Reverting as this as reported allows some variables to clobber each other.
We'll work on a different fix.

This reverts commit c5469f6367.
12 years ago
Dag Wieers 7d990fa167 Clarify how only_if works, also combined with with_items
- The old documentation stated not to quote the variable in the function, which is obviously wrong. When using lists or integers, we have to quote otherwise the startswith() method will trip over its non-existence.
- It was unclear that the only_if statement is processed for each item when doing with_items, so I added an example making it crystal clear how this can be used in your advantage (or why a non-existing list variable can break your logic if you expected the only_if to be processed once before running the task)
12 years ago
Michael DeHaan 7e2d6c0050 Clarify first_available_file is only for copy/template 12 years ago
Michael DeHaan ed9f5eed09 Merge pull request #1338 from alopropoz/extra_vars_override
Vars specified via CLI have the highest priority.
12 years ago
Michael DeHaan 31b45479e8 When using delegation, local_action should always use the local connection type. 12 years ago
Michael DeHaan e59f5d609b Merge pull request #1373 from jpmens/who1
Addition to WhoUses + typo fix
12 years ago
Serge van Ginderachter d04bd04f80 typo in handlers example yaml 12 years ago
Jan-Piet Mens b6eacd1631 Addition to WhoUses + typo fix 12 years ago
Michael DeHaan 21b1e6c5a4 Add who uses ansible page back. 12 years ago
Nigel Metheringham a457d24b97 Added comment about long lines in playbooks
I had trouble finding this information, so though it was worth
adding to docs... but am not sure its easy to find for someone
specifically to find.  At least I think this inclusion matches the
tone of document, but maybe this info should go into a FAQ
instead/as-well?
12 years ago
Michael DeHaan 50abc73bd2 Merge pull request #1353 from jpmens/moduledev1
Indicate module_formatter can produce boilerplate DOCUMENTATION
12 years ago
Jan-Piet Mens 9991dfee6c Indicate module_formatter can produce boilerplate DOCUMENTATION
add ./hacking/
12 years ago
Michael DeHaan 26ee03a43f Searchindex should not be part of source control 12 years ago
Michael DeHaan 2bef84e666 Rebuild docs 12 years ago
Michael DeHaan 97bc11795a more 0.8 docs 12 years ago
Michael DeHaan 0677891fc6 More docs 12 years ago
Michael DeHaan a98886c77f Further docs hacking 12 years ago
Michael DeHaan 1801ded34d more playbook docs 12 years ago
Michael DeHaan ca261e8961 more 0.8 documenting 12 years ago
Michael DeHaan 63100c9bc0 Docs + fix variable precedence of environment variables (ok, ok, I give in!) 12 years ago