Ansible

Ansible version : 2.6.2

常用模块（三）

系统模块

系统模块详细地址：https://docs.ansible.com/ansible/latest/modules/list_of_system_modules.html

• cron
• hostname
• ping
• user
• service
• systemd

模块：cron

概述

• 【cron】模块管理crontab和环境变量条目。允许创建环境变量和命名的crontab条目，更新或删除它们。
• 管理环境变量时：不添加注释行，但当模块需要查找/检查状态时，使用name参数来查找环境变量定义行。
• 管理crontab作业时，该模块包含一行，其中包含crontab条目的描述为"#Ansible: <name>"或者对应于传递给模块的name将来Ansible /模块调用都使用这个条目来查找/检查状态。name参数应该是唯一的，更改name值将导致创建一个新的cron任务(或删除另一个任务)。
• 使用％等符号时，必须正确转义它们。

参数

例子

playbook

指定时间执行

- name: Ensure a job that runs at 2 and 5 exists. Creates an entry like "0 5,2 * * ls -alh > /dev/null"
  cron:
    name: "check dirs"
    minute: "0"
    hour: "5,2"
    job: "ls -alh > /dev/null"

删除一个旧条目

- name: 'Ensure an old job is no longer present. Removes any job that is prefixed by "#Ansible: an old job" from the crontab'
  cron:
    name: "an old job"
    state: absent

重启之后，执行

- name: Creates an entry like "@reboot /some/job.sh"
  cron:
    name: "a job for reboot"
    special_time: reboot
    job: "/some/job.sh"

创建环境变量

- name: Creates an entry like "PATH=/opt/bin" on top of crontab
  cron:
    name: PATH
    env: yes
    value: /opt/bin

在声明的指定变量之后

- name: Creates an entry like "APP_HOME=/srv/app" and insert it after PATH declaration
  cron:
    name: APP_HOME
    env: yes
    value: /srv/app
    insertafter: PATH

环境变量变量

- name: Removes "APP_HOME" environment variable from crontab
  cron:
    name: APP_HOME
    env: yes
    state: absent

模块：hostname

概要

• 设置系统的主机名，支持大多数操作系统/分发，包括使用systemd的操作系统。
• 这个模块不会修改/etc/hosts,可以使用【template】或者【replace】模块修改。
• Windows, HP-UX ,AIX不支持。

参数

例子

playbook

- hostname:
    name: web01

模块：ping

概要

• 这个模块总是在成功之后返回pong。在playbook中毫无意义。但是在使用/usr/bin/ansible来确认登录可用和配置了可用的python
• 这个不是IMCP的ping，只是远端的python简单的测试模块
• 对于windows目标，使用win_ping
• 对于网络目标，使用net_ping

参数

例子

playbook

设置data值为crash

# Induce an exception to see what happens
- ping:
    data: crash

返回值

模块：user

概述

• 管理用户账户和用户属性
• 对于windows主机，使用win_user模块

参数

例子

创建指定uid以及主要的admin组的用户

- name: Add the user 'johnd' with a specific uid and a primary group of 'admin'
  user:
    name: johnd
    comment: John Doe
    uid: 1040
    group: admin

追加组

- name: Add the user 'james' with a bash shell, appending the group 'admins' and 'developers' to the user's groups
  user:
    name: james
    shell: /bin/bash
    groups: admins,developers
    append: yes

删除用户

- name: Remove the user 'johnd'
  user:
    name: johnd
    state: absent
    remove: yes

创建2048位的ssh key

- name: Create a 2048-bit SSH key for user jsmith in ~jsmith/.ssh/id_rsa
  user:
    name: jsmith
    generate_ssh_key: yes
    ssh_key_bits: 2048
    ssh_key_file: .ssh/id_rsa

设置过期时间

- name: Added a consultant whose account you want to expire
  user:
    name: james18
    shell: /bin/zsh
    groups: developers
    expires: 1422403387

删除过期时间

- name: starting at version 2.6, modify user, remove expiry time
  user:
    name: james18
    expires: -1

模块：service

概述

• 控制远程主机上的服务。支持的init系统包括BSD init，OpenRC，SysV，Solaris SMF，systemd，upstart。
• 对于Windows目标，请改用【win_service】模块。

参数

例子

如果没启动，则启动服务

- name: Start service httpd, if not running
  service:
    name: httpd
    state: started

重启服务

- name: Restart service httpd, in all cases
  service:
    name: httpd
    state: restarted

启用服务

- name: Enable service httpd, and not touch the running state
  service:
    name: httpd
    enabled: yes

基于进程启动

- name: Start service foo, based on running process /usr/bin/foo
  service:
    name: foo
    pattern: /usr/bin/foo
    state: started

带参数重启

- name: Restart network service for interface eth0
  service:
    name: network
    state: restarted
    args: eth0

模块：systemd

概述

• 控制远程主机上的systemd服务。

参数

注意

• 自从2.4开始，以下选项之一state，enabled，masked，daemon_reload，除daemon_reloa'之外的所有内容都需要name。
• 在2.4之前，你总是需要name。

例子

起服务

- name: Make sure a service is running
  systemd:
    state: started
    name: httpd

重启服务前先reload

- name: restart service cron on centos, in all cases, also issue daemon-reload to pick up config changes
  systemd:
    state: restarted
    daemon_reload: yes
    name: crond

强制重载配置

- name: just force systemd to reread configs (2.4 and above)
  systemd:
    daemon_reload: yes