官术网_书友最值得收藏!

Ansible modules

Ansible ships with a number of modules (called the module library) that can be executed directly on remote hosts or through playbooks.Tasks in playbooks call modules to do the work. 

Ansible has many modules, most of which are community contributed and maintained. Core modules are maintained by the Ansible core engineering team and will always ship with Ansible itself.

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.

Here is the list of modules available by Ansible: http://docs.ansible.com/ansible/latest/modules_by_category.html#module-index.
If you use Dash (https://kapeli.com/dash) or Zeal (https://zealdocs.org/), you can download the offline version for easy reference.

Modules can be executed via the command line as well. We will be using modules to write all the tasks inside our playbooks. All modules technically return JSON format data. 

Modules should be idempotent and should avoid making any changes if they detect that the current state matches the desired final state. When using Ansible playbooks, these modules can trigger change events in the form of notifying handlers to run additional tasks.

Documentation for each module can be accessed from the command line with the ansible-doc tool:

$ ansible-doc apt

We can list all the modules available on our host:

$ ansible-doc -l

Start the Apache web server on all nodes grouped under webservers by executing the httpd module. Note the use of the -m flag:

$ ansible webservers -m service -a "name=httpd state=started"

This snippet shows the exact same command but inside a playbook in YAML syntax:

- name: restart webserver
  service:
    name: httpd
    state: started

Each module contains multiple parameters and options, get to know more about the features of the modules by looking at their documentation and examples.

主站蜘蛛池模板: 浙江省| 西丰县| 威宁| 溆浦县| 连云港市| 宁武县| 额敏县| 独山县| 苗栗市| 台南县| 儋州市| 金乡县| 霍州市| 金沙县| 武定县| 同仁县| 徐水县| 兴城市| 眉山市| 德昌县| 遵化市| 黄浦区| 商水县| 凤山县| 安宁市| 金塔县| 安宁市| 金寨县| 白城市| 疏勒县| 岳普湖县| 乐昌市| 峡江县| 成安县| 巨野县| 广灵县| 伽师县| 丹江口市| 无锡市| 阿合奇县| 沙洋县|