ansible的常用模块介绍

ansible 常用命令

/usr/bin/ansible　 #Ansibe AD-Hoc 临时命令执行工具，常用于临时命令的执行

/usr/bin/ansible-doc #Ansible 模块功能查看工具

/usr/bin/ansible-galaxy　　#下载/上传优秀代码或Roles模块 的官网平台，基于网络的

/usr/bin/ansible-playbook #Ansible 定制自动化的任务集编排工具

/usr/bin/ansible-pull　　 #Ansible远程执行命令的工具，拉取配置而非推送配置（使用较少，海量机器时使用，对运维的架构能力要求较高）

/usr/bin/ansible-vault　　 #Ansible 文件加密工具

/usr/bin/ansible-console　 #Ansible基于Linux Consoble界面可与用户交互的命令执行工具

ansible-doc 命令

ansible-doc命令常用于获取模块信息及其使用帮助

//列出所有已安装的模块;注:按q退出
ansible-doc -l
//-s列出yum模块描述信息和操作动作
ansible-doc -s yum

ansible 常用模块

命令格式: ansible [主机] [-m 模块] [-a args]

ping模块

此模块用于进行主机连通性测试

ansible all -m ping

command 模块

这个模块可以直接在远程主机上执行命令，并将结果返回本主机。

查看command模块信息

ansible-doc -s command

常用的参数：

chdir　　# 在执行命令之前，先切换到该目录
creates 　# 一个文件名，当这个文件存在，则该命令不执行,可以
用来做判断
removes # 一个文件名，这个文件不存在，则该命令不执行

常用的参数：

chdir　　# 在执行命令之前，先切换到该目录
creates 　# 一个文件名，当这个文件存在，则该命令不执行,可以
用来做判断
removes # 一个文件名，这个文件不存在，则该命令不执行

cron模块

该模块适用于管理cron计划任务的，其使用的语法跟我们的crontab文件中的语法一致

查看cron模块信息

ansible-doc -s cron

常用选项：

day= #日应该运行的工作( 1-31, *, */2, )

hour= #小时 ( 0-23, *, */2, )

minute= #分钟( 0-59, *, */2, )

month= #月( 1-12, *, /2, )

weekday= #周 ( 0-6 for Sunday-Saturday, )

job= #指明运行的命令是什么

name= #定时任务描述，用于删除任务

reboot #任务在重启时运行，不建议使用，建议使用special_time

special_time #特殊的时间范围，参数：reboot（重启时），annually（每年），monthly（每月），weekly（每周），daily（每天），hourly（每小时）

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

user #以哪个用户的身份执行

例：

//添加计划任务

ansible webserver -m cron -a 'minute="*/1" job="/bin/echo hello" name="test cron job"'

//查看计划任务

ansible webserver -a 'crontab -l'

//移除计划任务

ansible webserver -m cron -a 'name="test cron job" state=absent'

user模块

该模块主要是用来管理用户账号

user模块是请求的是useradd，userdel，usermod三个指令

查看user模块信息

ansible-doc -s user

主要选项：

comment　　# 用户的描述信息

createhome　　# 是否创建家目录

force　　# 在使用state=absent时, 行为与userdel –force一致.

group　　# 指定基本组

groups　　# 指定附加组，如果指定为(groups=)表示删除所有组

home　　# 指定用户家目录

move_home　　# 如果设置为home=时, 试图将用户主目录移动到指定的目录

name　　# 指定用户名

non_unique　　# 该选项允许改变非唯一的用户ID值

password　　# 指定用户密码

remove　　# 在使用state=absent时, 行为是与userdel –remove一致

shell　　# 指定默认shell

state　　# 设置帐号状态，不指定为创建，指定值为absent表示删除

system　　# 当创建一个用户，设置这个用户是系统用户。这个设置不能更改现有用户

uid　　# 指定用户的uid

例:

//创建用户test01

ansible mysql -m user -a 'name="test01"'

//查看创建的用户信息

ansible mysql -a 'tail /etc/passwd'

//删除用户test01

ansible mysql -m user -a 'name="test01" state=absent'

group模块

该模块主要用于添加或删除组。

group模块请求的是groupadd，groupdel，groupmod三个指令。

查看group模块信息

ansible-doc -s group

1

常用的选项：

gid=　　#设置组的GID号

name=　　#指定组的名称

state=　　#指定组的状态，默认为创建，设置值为absent为删除

system=　　#设置值为yes，表示创建为系统组

例：

ansible mysql -m user -a 'name="test01"'

//创建组

ansible mysql -m group -a 'name=mysql gid=306 system=yes'

//查看组信息

ansible mysql -a 'tail /etc/group'

//使用user模块向组里添加成员

ansible mysql -m user -a 'name=test01 uid=306 system=yes group=mysql'

ansible mysql -a 'id test01'

shell模块

该模块用于在远程主机上调用shell解释器运行命令，支持shell的各种功能，例如管道等。

查看shell模块信息

ansible-doc -s shell

1

例：

//创建用户使用无交互模式给用户设置密码

ansible mysql -m shell -a 'echo abc123 | passwd --stdin test01'

copy模块

这个模块用于将文件复制到远程主机，同时支持给定内容生成文件和修改权限等

查看copy模块信息

ansible-doc -s copy

1

常用选项：

src　　　　#被复制到远程主机的本地文件。可以是绝对路径，也可以是相对路径。如果路径是一个目录，则会递归复制，用法类似于"rsync"

content　　　#用于替换"src"，可以直接指定文件的值

dest　　　　#必选项，将源文件复制到的远程主机的绝对路径

backup　　　#当文件内容发生改变后，在覆盖之前把源文件备份，备份文件包含时间信息

directory_mode　　　　#递归设定目录的权限，默认为系统默认权限

force　　　　#当目标主机包含该文件，但内容不同时，设为"yes"，表示强制覆盖；设为"no"，表示目标主机的目标位置不存在该文件才复制。默认为"yes"

others　　　　#所有的 file 模块中的选项可以在这里使用

owner #应该拥有文件/目录的用户名，将提供给chown

mode #目标文件或目录的权限,将提供给chmod

例：

//复制本地文件/etc/fstab到mysql列表中的主机/opt目录下并改名为fstab.back

ansible mysql -m copy -a 'src=/etc/fstab dest=/opt/fstab.back owner=root mode=640'

ansible mysql -a 'ls -l /opt'

ls -l /etc/fstab

//将hello world!写入/opt/fstab.back

ansible mysql -m copy -a 'content="hello world!" dest=/opt/fstab.back'

ansible mysql -a 'cat /opt/fstab.back'

file模块

该模块主要用于设置文件的属性，比如创建文件、创建链接文件、删除文件等。

查看file模块信息

ansible-doc -s file

1

常用选项：

force　　#需要在两种情况下强制创建软链接，一种是源文件不存在，但之后会建立的情况下；另一种是目标软链接已存在，需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no

group　　#定义文件/目录的属组。后面可以加上mode：定义文件/目录的权限

owner　　#定义文件/目录的属主。后面必须跟上path：定义文件/目录的路径

recurse　　#递归设置文件的属性，只对目录有效，后面跟上src：被链接的源文件路径，只应用于state=link的情况

dest　　#被链接到的路径，只应用于state=link的情况

state　　#状态，有以下选项：

directory：如果目录不存在，就创建目录

file：即使文件不存在，也不会被创建

link：创建软链接

hard：创建硬链接

touch：如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间

absent：删除目录、文件或者取消链接文件

例：

ansible mysql -m user -a 'name=mysql system=yes'

ansible mysql -m group -a 'name=mysql system=yes'

//修改/opt/fstab.back文件参数（属主、属组、权限）

ansible mysql -m file -a 'owner=mysql group=mysql mode=644 path=/opt/fstab.back'

//创建/opt/fstab.back文件的软链接/opt/fstab.link

ansible mysql -m file -a 'path=/opt/fstab.link src=/opt/fstab.back state=link'

yum模块

该模块主要用于软件的安装

查看yum模块信息

ansible-doc -s yum

1

常用选项：

name=　　#所安装的包的名称

state=　　#present—>安装， latest—>安装最新的, absent—> 卸载软件。

update_cache　　#强制更新yum的缓存

conf_file　　#指定远程yum安装时所依赖的配置文件（安装本地已有的包）。

disable_pgp_check　　#是否禁止GPG checking，只用于presentor latest。

disablerepo　　#临时禁止使用yum库。 只用于安装或更新时。

enablerepo　　#临时使用的yum库。只用于安装或更新时。

例：

//yum安装httpd

ansible mysql -m yum -a 'name=httpd'

//查看是否安装

ansible mysql -a 'rpm -q httpd'

//卸载httpd

ansible mysql -m yum -a 'name=httpd state=absent'

ansible mysql -a 'rpm -q httpd'

service模块

该模块用于服务程序的管理

查看service模块信息

ansible-doc -s service

1

常用选项：

arguments #命令行提供额外的参数

enabled #设置开机启动。

name= #服务名称

runlevel #开机启动的级别，一般不用指定。

sleep #在重启服务的过程中，是否等待。如在服务关闭以后等待2秒再启动。(定义在剧本中。)

state #有四种状态，分别为：started—>启动服务， stopped—>停止服务， restarted—>重启服务， reloaded—>重载配置

例：

ansible webserver -m yum -a 'name=httpd'

//查看web服务器httpd运行状态

ansible webserver -a 'systemctl status httpd'

//启动httpd服务

ansible webserver -m service -a 'name=httpd enabled=true state=started'

//关闭防火墙

ansible all -m service -a 'name=firewalld state=stopped'

//查看是否开启

ansible webserver -a 'systemctl status httpd'

script模块

该模块用于将本机的脚本在被管理端的机器上运行

查看script模块信息

ansible-doc -s script

1

例：

//先写个脚本

vim test.sh

#!/bin/bash

echo "hello ansible from script" > /opt/script.txt

chmod +x test.sh

//使用script执行脚本ansible mysql -m script -a 'test.sh'cat /opt/script.txt