ansible/docs/docsite/rst/user_guide/modules.rst

.. _working_with_modules:

Working With Modules
====================

.. toctree::
   :maxdepth: 1

   modules_intro
   ../reference_appendices/common_return_values
   modules_support
   ../modules/modules_by_category


Ansible ships with a number of modules (called the 'module library')
that can be executed directly on remote hosts or through :doc:`Playbooks <playbooks>`.

Users can also write their own modules. These modules can control system resources,
like services, packages, or files (anything really), or handle executing system commands.


.. seealso::

   :doc:`intro_adhoc`
       Examples of using modules in /usr/bin/ansible
   :doc:`playbooks`
       Examples of using modules with /usr/bin/ansible-playbook
   :doc:`../dev_guide/developing_modules`
       How to write your own modules
   :doc:`../dev_guide/developing_api`
       Examples of using modules with the Python API
   :doc:`../reference_appendices/interpreter_discovery`
       Configuring the right Python interpreter on target hosts
   `Mailing List <https://groups.google.com/group/ansible-project>`_
       Questions? Help? Ideas?  Stop by the list on Google Groups
   `irc.freenode.net <http://irc.freenode.net>`_
       #ansible IRC chat channel
Doc build warning/broken link clean-a-palooza (#37382) * Doc build warning/broken link clean-a-palooza, WIP commit 1. * Fixed broken anchor * Fixing additional broken links; converting from doc to ref. * Fix anchor 2018-03-14 19:44:21 +00:00			`.. _working_with_modules:`

Core Docs Refactor and Redesign (#36067) * Docs refactor as outlined in https://github.com/ansible/proposals/issues/79. Moves content into 'guides'; refactors TOC; fixes CSS; design tweaks to layout and CSS; fixes generated plugin, CLI and module docs to fix links accodingly; more. * Adding extra blank line for shippable 2018-02-13 15:23:55 +00:00			`Working With Modules`
			`====================`
Docs updates 2012-03-08 18:36:47 +00:00
Split content into subpages. 2013-12-24 23:05:41 +00:00			`.. toctree::`
moar docs added docs for new v2 features restructures modules bar and core/extras info into their own pages changed templates to refer to the new pages added some missing ansible.cfg options more info on gathering setting 2015-07-17 17:53:13 +00:00			`:maxdepth: 1`
Split content into subpages. 2013-12-24 23:05:41 +00:00
moar docs added docs for new v2 features restructures modules bar and core/extras info into their own pages changed templates to refer to the new pages added some missing ansible.cfg options more info on gathering setting 2015-07-17 17:53:13 +00:00			`modules_intro`
Fixes more rST errors (#39042) * removes include, avoids duplicate label rST warnings * reduces literal_block errors on playbooks_filters * addresses TOC errors * ref error on modules page * trying ref for list_of_database_modules 2018-04-20 00:02:48 +00:00			`../reference_appendices/common_return_values`
Doc module meta (#20093) * updated module docs to reflect unification/meta * new doc page * also remove module refs to old core/extra * Update modules_support.rst Light edit. 2017-01-10 20:58:22 +00:00			`modules_support`
Core Docs Refactor and Redesign (#36067) * Docs refactor as outlined in https://github.com/ansible/proposals/issues/79. Moves content into 'guides'; refactors TOC; fixes CSS; design tweaks to layout and CSS; fixes generated plugin, CLI and module docs to fix links accodingly; more. * Adding extra blank line for shippable 2018-02-13 15:23:55 +00:00			`../modules/modules_by_category`
More exciting anchor tags, document more loop features! 2013-10-04 22:34:39 +00:00
Add auto-gen TOCs to a bunch of pages. 2012-08-28 19:41:10 +00:00
Fixing the MySQL docs 2012-08-03 15:31:43 +00:00			`Ansible ships with a number of modules (called the 'module library')`
Revert "Revert "Tiny RST link fix in modules documentation"" This reverts commit 658dc7a3661669c15f2b696651ae2522097b44f3. 2013-11-11 18:23:03 +00:00			that can be executed directly on remote hosts or through :doc:`Playbooks <playbooks>`.
Further modifications to the module formatter to adjust to the new theme, and some misc docs text corrections. 2013-12-25 18:23:58 +00:00
moar docs added docs for new v2 features restructures modules bar and core/extras info into their own pages changed templates to refer to the new pages added some missing ansible.cfg options more info on gathering setting 2015-07-17 17:53:13 +00:00			`Users can also write their own modules. These modules can control system resources,`
			`like services, packages, or files (anything really), or handle executing system commands.`
Minor docs restructuring 2012-03-08 18:53:48 +00:00
Move see also blocks to bottom of each page to include reading docs, remove 'fork me' to avoid text overlap, simply menu nav so folks find the chapter link. 2012-03-31 13:29:31 +00:00
			`.. seealso::`

Resolving some doc errors. 2013-09-29 23:16:59 +00:00			:doc:`intro_adhoc`
doc fixes 2012-04-12 22:20:52 +00:00			`Examples of using modules in /usr/bin/ansible`
Move see also blocks to bottom of each page to include reading docs, remove 'fork me' to avoid text overlap, simply menu nav so folks find the chapter link. 2012-03-31 13:29:31 +00:00			:doc:`playbooks`
doc fixes 2012-04-12 22:20:52 +00:00			`Examples of using modules with /usr/bin/ansible-playbook`
Core Docs Refactor and Redesign (#36067) * Docs refactor as outlined in https://github.com/ansible/proposals/issues/79. Moves content into 'guides'; refactors TOC; fixes CSS; design tweaks to layout and CSS; fixes generated plugin, CLI and module docs to fix links accodingly; more. * Adding extra blank line for shippable 2018-02-13 15:23:55 +00:00			:doc:`../dev_guide/developing_modules`
link module dev guide from modules page 2012-03-31 14:21:28 +00:00			`How to write your own modules`
Core Docs Refactor and Redesign (#36067) * Docs refactor as outlined in https://github.com/ansible/proposals/issues/79. Moves content into 'guides'; refactors TOC; fixes CSS; design tweaks to layout and CSS; fixes generated plugin, CLI and module docs to fix links accodingly; more. * Adding extra blank line for shippable 2018-02-13 15:23:55 +00:00			:doc:`../dev_guide/developing_api`
Move see also blocks to bottom of each page to include reading docs, remove 'fork me' to avoid text overlap, simply menu nav so folks find the chapter link. 2012-03-31 13:29:31 +00:00			`Examples of using modules with the Python API`
Python interpreter discovery (#50163) * Python interpreter discovery * No longer blindly default to only `/usr/bin/python` * `ansible_python_interpreter` defaults to `auto_legacy`, which will discover the platform Python interpreter on some platforms (but still favor `/usr/bin/python` if present for backward compatibility). Use `auto` to always use the discovered interpreter, append `_silent` to either value to suppress warnings. * includes new doc utility method `get_versioned_doclink` to generate a major.minor versioned doclink against docs.ansible.com (or some other config-overridden URL) * docs revisions for python interpreter discovery (cherry picked from commit 5b53c0012ab7212304c28fdd24cb33fd8ff755c2) * verify output on some distros, cleanup 2019-02-28 07:52:02 +00:00			:doc:`../reference_appendices/interpreter_discovery`
			`Configuring the right Python interpreter on target hosts`
Prefer https:// links in the docs site All the changed urls are availible by way of https://. Most of them already redirect. 2018-07-21 13:48:47 +00:00			`Mailing List <https://groups.google.com/group/ansible-project>`_
Add IRC and google groups links to each page 2012-03-31 13:55:37 +00:00			`Questions? Help? Ideas? Stop by the list on Google Groups`
			`irc.freenode.net <http://irc.freenode.net>`_
			`#ansible IRC chat channel`