Ansible模块

1. Command模块

1.1 详解

  • 使用ansible自带模块执行命令 如果要用 > < | & ' ' 使用shell模块

1.2 例如:

[root@node2 ~/.ssh]# ansible all -m command -a "ls /root/.ssh"
node4 | success | rc=0 >>
authorized_keys
known_hosts
​
node3 | success | rc=0 >>
authorized_keys
known_hosts

1.3 相关命令如下

  • creates:一个文件名,当该文件存在,则该命令不执行
  • xxxfree_form:要执行的linux指令
  • chdir:在执行指令之前,先切换到该目录
  • removes:一个文件名,当该文件不存在,则该选项不执行
  • executable:切换shell来执行指令,该执行路径必须是一个绝对路径

1.4 相关命令如下

  • creates:一个文件名,当该文件存在,则该命令不执行
  • free_form:要执行的linux指令
  • chdir:在执行指令之前,先切换到该目录
  • removes:一个文件名,当该文件不存在,则该选项不执行
  • executable:切换shell来执行指令,该执行路径必须是一个绝对路径

2 shell模块

2.1 详解

  • 执行linux命令时可以用
    • 调用bash执行命令 类似 cat /tmp/stanley.md | awk -F'|' '{print $1,$2}' &> /tmp/stanley.txt 这些复杂命令,即使使用shell也会失败,解决办法:写到脚本时,copy到远程,执行,再把需要的结果拉回执行命令的机器(执行Ansible命令的机器往往称为:Master机或者中控机或者堡垒机)。
      注意:command和shell模块的核心参数直接为命令本身;而其它模块的参数通常为“key=value”格式

3 Copy模块

3.1 详解

复制本地文件至远程服务器,并且能够改属性等

3.1 例如:

  • 直接复制
    ansible模块1.png

  • 生成内容的复制
    ansible模块2.png
    ansible模块3.png

注意:这两种方法是互斥的,即src和content不能同时使用

3.3 相关选项如下:

backup:在覆盖之前,将源文件备份,备份文件包含时间信息。有两个选项:yes|no
content:用于替代“src”,可以直接设定指定文件的值
dest:必选项。要将源文件复制到的远程主机的绝对路径,如果源文件是一个目录,那么该路径也必须是个目录
directory_mode:递归设定目录的权限,默认为系统默认权限
force:如果目标主机包含该文件,但内容不同,如果设置为yes,则强制覆盖,如果为no,则只有当目标主机的目标位置不存在该文件时,才复制。默认为yes
others:所有的file模块里的选项都可以在这里使用
src:被复制到远程主机的本地文件,可以是绝对路径,也可以是相对路径。如果路径是一个目录,它将递归复制。在这种情况下,如果路径使用“/”来结尾,则只复制目录里的内容,如果没有使用“/”来结尾,则包含目录在内的整个内容全部复制,类似于rsync。

4 File模块

4.1 详解

设置文件属性

4.2 例如

-a "path=PATH state=directory" # 创建目录
[root@node2 ~]# ansible all -m file -a "path=/tmp/hehe state=directory"

-a "path=PATH src=FILE state=link" #创建链接文件
[root@node2 ~]# ansible all -m file -a "path=/root/haha src=/tmp/hehe state=link"

-a "path=PATH state=absent" #删除文件
[root@node2 ~]# ansible all -m file -a "path=/root/haha state=absent"

4.3 相关选项如下

force:需要在两种情况下强制创建软链接,一种是源文件不存在,但之后会建立的情况下;另一种是目标软链接已存在,需要先取消之前的软链,然后创建新的软链,有两个选项:yes|no
group:定义文件/目录的属组
mode:定义文件/目录的权限
owner:定义文件/目录的属主
path:必选项,定义文件/目录的路径
recurse:递归设置文件的属性,只对目录有效
src:被链接的源文件路径,只应用于state=link的情况
dest:被链接到的路径,只应用于state=link的情况
state:
directory:如果目录不存在,就创建目录
file:即使文件不存在,也不会被创建
link:创建软链接
hard:创建硬链接
touch:如果文件不存在,则会创建一个新的文件,如果文件或目录已存在,则更新其最后修改时间
absent:删除目录、文件或者取消链接文件

5 fetch模块

5.1 详解

从远程服务器拉取文件至本机,只能fetch文件,不能fetch目录,如果拉目录,先tar/zip 再拉到本机即可

5.2 例如

[root@node2 ~]# ansible all -m fetch -a "src=/tmp/txt dest=/root/txt.txt"

6 Cron模块

6.1 详解

管理cron计划任务

6.2 例如

[root@node2 ~]# ansible all -m corn -a "minute='*/5' job='/usr/sbin/ntpdate 172.16.0.1 &> /dev/null' name='Synctime'" #每5分钟同步一下时间
[root@node2 ~]# ansible all -m corn -a "state=absent name='Synctime'" #删除上面的定时任务

6.3 相关命令如下

  • a "": 设置管理节点生成定时任务
    action: cron
    backup= # 如果设置,创建一个crontab备份
    cron_file= #如果指定, 使用这个文件cron.d,而不是单个用户crontab
    day= # 日应该运行的工作( 1-31, *, */2, etc )
    hour= # 小时 ( 0-23, *, */2, etc )
    job= #指明运行的命令是什么
    minute= #分钟( 0-59, *, */2, etc )
    month= # 月( 1-12, *, */2, etc )
    name= #定时任务描述
    reboot # 任务在重启时运行,不建议使用,建议使用special_time
    special_time # 特殊的时间范围,参数:reboot(重启时),annually(每年),monthly(每月),weekly(每周),daily(每天),hourly(每小时)

    state #指定状态,prsent表示添加定时任务,也是默认设置,absent表示删除定时任务

    user # 以哪个用户的身份执行
    weekday # 周 ( 0-6 for Sunday-Saturday, *, etc )

7 yum模块

7.1 详解

yum安装软件,也有apt,zipper

7.2 例如

[root@node2 ~]# ansible all -m yum -a "name=httpd state=latest" #安装httpd包

7.3 相关命令如下

conf_file #设定远程yum安装时所依赖的配置文件。如配置文件没有在默认的位置。
disable_gpg_check #是否禁止GPG checking,只用于present' orlatest'。
disablerepo #临时禁止使用yum库。只用于安装或更新时。
enablerepo #临时使用的yum库。只用于安装或更新时。
name= #所安装的包的名称
state #present安装, latest安装最新的, absent 卸载软件。
update_cache #强制更新yum的缓存。

8 Server模块

8.1 详解

服务程序管理

8.2 例如

[root@node2 ~]# ansible all -m service -a "name=httpd state=restarted" #重启httpd
[root@node2 ~]# ansible all -m service -a "name=httpd enabled=true" #开机启动

8.3 相关命令如下

arguments #命令行提供额外的参数
enabled #设置开机启动。
name= #服务名称
runlevel #开机启动的级别,一般不用指定。
sleep #在重启服务的过程中,是否等待。如在服务关闭以后等待2秒再启动。
state #started启动服务, stopped停止服务, restarted重启服务, reloaded重载配置

9 group模块

9.1 详解

组管理

9.2 例如and相关信息

[root@node2 ~]# ansible-doc -s group

  • name: 添加或删除组
    action: group
    gid # 设置组的GID号
    name= # 管理组的名称
    state # 指定组状态,默认为创建,设置值为absent为删除
    system # 设置值为yes,表示为创建系统组

10 user模块

10.1 详解

用户管理

10.1 相关信息如下

-a ""
action: user
comment # 用户的描述信息
createhom # 是否创建家目录
force # 在使用state=absent'是, 行为与userdel --force'一致.
group # 指定基本组
groups # 指定附加组,如果指定为('groups=')表示删除所有组
home # 指定用户家目录
login_class #可以设置用户的登录类 FreeBSD, OpenBSD and NetBSD系统.
move_home # 如果设置为home='时, 试图将用户主目录移动到指定的目录 name= # 指定用户名 non_unique # 该选项允许改变非唯一的用户ID值 password # 指定用户密码 remove # 在使用state=absent'时, 行为是与 `userdel --remove'一致.
shell # 指定默认shell
state #设置帐号状态,不指定为创建,指定值为absent表示删除
system # 当创建一个用户,设置这个用户是系统用户。这个设置不能更改现有用户。
uid #指定用户的uid
update_password # 更新用户密码
expires #指明密码的过期时间


ansible all -m user -a 'name=magedu home=/tmp/magedu/ shell=/bin/bash uid=2000 comment="test user" group=root'

11 ping模块

检测主机存活

12 Setup模块

获取指定主机facts
#指定应用selinux的配置文件。
state=enforcing|permissive|disabled #对应于selinux配置文件的SELINUX。
policy=targeted|minimum|mls #对应于selinux配置文件的SELINUXTYPE
facts就是变量,内建变量 。每个主机的各种信息,cpu颗数、内存大小等。会存在facts中的某个变量中。调用后返回很多对应主机的信息,在后面的操作中可以根据不同的信息来做不同的操作。如redhat系列用yum安装,而debian系列用apt来安装软件。

12.1 例如

ansible node3 -m setup

13 selinux模块

管理selinux模块

13.1 例如

ansible all -m selinux -a 'state=disabled'

13.2 相关命令

conf #指定应用selinux的配置文件。
state=enforcing|permissive|disabled #对应于selinux配置文件的SELINUX。
policy=targeted|minimum|mls #对应于selinux配置文件的SELINUXTYPE

14 script模块

14.1 详解

发送脚本到各被管理节点,并执行;不需要参数

14.2 例如

ansible all -m script -a 'test.sh' #直接在-a 后面指定脚本即可

文章发布自:刘俊辉的个人博客,转载请注明出处,谢谢!