2013-12-25 19:23:58 +01:00
|
|
|
About Modules
|
|
|
|
=============
|
2012-03-08 19:36:47 +01:00
|
|
|
|
2013-12-25 00:05:41 +01:00
|
|
|
.. toctree::
|
2013-12-25 00:51:46 +01:00
|
|
|
:maxdepth: 4
|
2013-12-25 00:05:41 +01:00
|
|
|
|
2013-10-05 00:34:39 +02:00
|
|
|
.. _modules_intro:
|
|
|
|
|
2012-08-28 21:41:10 +02:00
|
|
|
Introduction
|
|
|
|
````````````
|
|
|
|
|
2012-08-03 17:31:43 +02:00
|
|
|
Ansible ships with a number of modules (called the 'module library')
|
2013-11-11 19:23:03 +01:00
|
|
|
that can be executed directly on remote hosts or through :doc:`Playbooks <playbooks>`.
|
2013-12-25 19:23:58 +01:00
|
|
|
|
|
|
|
Users can also write their own modules. These modules can control system resources, like services, packages, or files (anything really), or
|
2012-08-03 17:31:43 +02:00
|
|
|
handle executing system commands.
|
2012-03-08 19:53:48 +01:00
|
|
|
|
2012-03-31 16:38:24 +02:00
|
|
|
Let's review how we execute three different modules from the command line::
|
|
|
|
|
2014-04-08 16:45:55 +02:00
|
|
|
ansible webservers -m service -a "name=httpd state=started"
|
2012-03-31 16:38:24 +02:00
|
|
|
ansible webservers -m ping
|
|
|
|
ansible webservers -m command -a "/sbin/reboot -t now"
|
|
|
|
|
2012-08-03 17:31:43 +02:00
|
|
|
Each module supports taking arguments. Nearly all modules take ``key=value``
|
2013-12-25 19:23:58 +01:00
|
|
|
arguments, space delimited. Some modules take no arguments, and the command/shell modules simply
|
|
|
|
take the string of the command you want to run.
|
2012-03-09 04:50:00 +01:00
|
|
|
|
2012-03-31 16:38:24 +02:00
|
|
|
From playbooks, Ansible modules are executed in a very similar way::
|
|
|
|
|
|
|
|
- name: reboot the servers
|
2012-08-03 17:31:43 +02:00
|
|
|
action: command /sbin/reboot -t now
|
2012-03-31 16:38:24 +02:00
|
|
|
|
2013-12-25 20:08:14 +01:00
|
|
|
Which can be abbreviated to::
|
2012-10-23 15:14:01 +02:00
|
|
|
|
|
|
|
- name: reboot the servers
|
|
|
|
command: /sbin/reboot -t now
|
|
|
|
|
2013-12-25 19:23:58 +01:00
|
|
|
All modules technically return JSON format data, though if you are using the command line or playbooks, you don't really need to know much about
|
|
|
|
that. If you're writing your own module, you care, and this means you do not have to write modules in any particular language -- you get to choose.
|
2012-03-08 19:36:47 +01:00
|
|
|
|
2012-08-01 05:19:41 +02:00
|
|
|
Modules are `idempotent`, meaning they will seek to avoid changes to the system unless a change needs to be made. When using Ansible
|
2013-12-25 19:23:58 +01:00
|
|
|
playbooks, these modules can trigger 'change events' in the form of notifying 'handlers' to run additional tasks.
|
2012-03-22 06:01:02 +01:00
|
|
|
|
2013-12-25 19:23:58 +01:00
|
|
|
Documentation for each module can be accessed from the command line with the ansible-doc tool::
|
2012-03-08 19:36:47 +01:00
|
|
|
|
2013-12-25 19:23:58 +01:00
|
|
|
ansible-doc yum
|
2012-03-31 15:29:31 +02:00
|
|
|
|
|
|
|
.. seealso::
|
|
|
|
|
2013-09-30 01:16:59 +02:00
|
|
|
:doc:`intro_adhoc`
|
2012-04-13 00:20:52 +02:00
|
|
|
Examples of using modules in /usr/bin/ansible
|
2012-03-31 15:29:31 +02:00
|
|
|
:doc:`playbooks`
|
2012-04-13 00:20:52 +02:00
|
|
|
Examples of using modules with /usr/bin/ansible-playbook
|
2013-09-30 01:16:59 +02:00
|
|
|
:doc:`developing_modules`
|
2012-03-31 16:21:28 +02:00
|
|
|
How to write your own modules
|
2013-09-30 01:30:10 +02:00
|
|
|
:doc:`developing_api`
|
2012-03-31 15:29:31 +02:00
|
|
|
Examples of using modules with the Python API
|
2012-04-13 00:20:52 +02:00
|
|
|
`Mailing List <http://groups.google.com/group/ansible-project>`_
|
2012-03-31 15:55:37 +02:00
|
|
|
Questions? Help? Ideas? Stop by the list on Google Groups
|
|
|
|
`irc.freenode.net <http://irc.freenode.net>`_
|
|
|
|
#ansible IRC chat channel
|
|
|
|
|