ansible 详解基本篇

Ansible是一种常用的自动运维化工具，基于python开发，分布式，无需客户端，轻量级，配置语言采用YAML。

安装方式yum

yum install epel-release&&yum install ansible -y

pip install ansible

ansible 2.9以后支持补全功能依赖插件python的argcomplete插件。

yum -y install python-argcomplete

pip install python-argcomplete

ansible的特性：

1.丰富的模块化管理

2.通过yaml格式 编写playbok批量部署服务

3.基于OpenSSH服务相对比较安全

4.一个任务执行一次和执行多次的结果相同

5.aramiko(python对ssh的实现)，PyYaml，jinja2(模块语言)三个关键模块

6.管理模式非常简单，一条命令可以影响上千台主机

工作原理：

ansible 的架构图



Ansible：Ansible核心程序。

HostInventory：记录由Ansible管理的主机信息，包括端口、密码、ip等。

Playbooks：“剧本”YAML格式文件，多个任务定义在一个文件中，定义主机需要调用哪些模块来完成的功能。

CoreModules：核心模块，主要操作是通过调用核心模块来完成管理任务。

CustomModules：自定义模块，完成核心模块无法完成的功能，支持多种语言。

ConnectionPlugins：连接插件，Ansible和Host通信使用

ansible 执行任务的方式分为两种

ad-HOC 点对点模式

使用单个模块，支持批量执行单条命令。ad-hoc 命令是一种可以快速输入的命令 例如对大量服务器执行shell 或者执行某个linux命令。

playbook 模式（剧本模式）

通过编写yaml格式文件组合多个task任务，实现一个想要达到的功能，相对于多个点对点模式组合操作配置，playbook这个功能非常强大

ansible执行过程

首先读取ansible.cfg中的配置， 根据规则获取Inventory中的管理主机列表，进行配置任务

加载自己的配置文件，默认/etc/ansible/ansible.cfg；

查找对应的主机配置文件，找到要执行的主机或者组；

加载自己对应的模块文件，如 command；

通过ansible将模块或命令生成对应的临时py文件(python脚本)， 并将该文件传输至远程服务器；

对应执行用户的家目录的.ansible/tmp/XXX/XXX.PY文件；

给文件 +x 执行权限；

执行并返回结果；

删除临时py文件，sleep 0退出；

ansible 配置文件

inventory = /etc/ansible/hosts #这个参数表示资源清单inventory文件的位置

library = /usr/share/ansible #指向存放Ansible模块的目录，支持多个目录方式，只要用冒号（：）隔开就可以

forks = 5 #并发连接数，默认为5

sudo_user = root #设置默认执行命令的用户

remote_port = 22 #指定连接被管节点的管理端口，默认为22端口，建议修改，能够更加安全

host_key_checking = False #设置是否检查SSH主机的密钥，值为True/False。关闭后第一次连接不会提示配置实例

timeout = 60 #设置SSH连接的超时时间，单位为秒

log_path = /var/log/ansible.log #指定一个存储ansible日志的文件（默认不记录日志）

主机清单配置

/etc/ansible/hosts 文件配置方式如下

第一种标明主机地址或者主机名的方式

第二种是不同应用名称分组的方式，组成员我们可以使用通配符

常用命令集

/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 -l 列出所有模块信息



ansible-doc 模块名称 列出指定模块名称



ansible-doc -s mysql_user 显示playbook的详细用法

ansible-doc 命令详细参数

Options:

-h, --help show this help message and exit　　# 显示命令参数API文档

-l, --list List available modules　　#列出可用的模块

-M MODULE_PATH, --module-path=MODULE_PATH　　#指定模块的路径

specify path(s) to module library (default=None)

-s, --snippet Show playbook snippet for specified module(s)　　#显示playbook制定模块的用法

-v, --verbose verbose mode (-vvv for more, -vvvv to enable　　# 显示ansible-doc的版本号查看模块列表：

connection debugging)

--version show program's version number and exit

ansible 命令详解

ansible [-f forks] [-m module_name] [-a args]

-a MODULE_ARGS　　　#模块的参数，如果执行默认COMMAND的模块，即是命令参数，如： “date”，“pwd”等等

-k，--ask-pass #ask for SSH password。登录密码，提示输入SSH密码而不是假设基于密钥的验证

--ask-su-pass #ask for su password。su切换密码

-K，--ask-sudo-pass #ask for sudo password。提示密码使用sudo，sudo表示提权操作

--ask-vault-pass #ask for vault password。假设我们设定了加密的密码，则用该选项进行访问

-B SECONDS #后台运行超时时间

-C #模拟运行环境并进行预运行，可以进行查错测试

-c CONNECTION #连接类型使用

-f FORKS #并行任务数，默认为5

-i INVENTORY #指定主机清单的路径，默认为/etc/ansible/hosts

--list-hosts #查看有哪些主机组

-m MODULE_NAME #执行模块的名字，默认使用 command 模块，所以如果是只执行单一命令可以不用 -m参数

-o #压缩输出，尝试将所有结果在一行输出，一般针对收集工具使用

-S #用 su 命令

-R SU_USER #指定 su 的用户，默认为 root 用户

-s #用 sudo 命令

-U SUDO_USER #指定 sudo 到哪个用户，默认为 root 用户

-T TIMEOUT #指定 ssh 默认超时时间，默认为10s，也可在配置文件中修改

-u REMOTE_USER #远程用户，默认为 root 用户

-v #查看详细信息，同时支持-vvv，-vvvv可查看更详细信息

ansible使用前第一种方式免密



密钥拷贝到需要操作的客户端



如果没有ssh-copy-id 命令 需要安装yum -y install openssh-clientsansible

ansible 常用模块

首先我们确保客户端机器是否在线，使用ping命令进行测试

ansible web -m ping



注：/etc/ansible/hosts 组名不能用特殊符号

command 模块

ansible web -m command -a '命令'



命令模块接受命令名称，后面是空格分隔的列表参数。给定的命令将在所有选定的节点上执行。它不会通过shell进行处理，比如$HOME和操作如"<"，">"，"|"，";"，"&" 工作（需要使用（shell）模块实现这些功能）。注意，该命令不支持| 管道命令。

下面来看一看该模块下常用的几个命令：

chdir　　　　　　 # 在执行命令之前，先切换到该目录

executable # 切换shell来执行命令，需要使用命令的绝对路径

free_form 　 # 要执行的Linux指令，一般使用Ansible的-a参数代替。

creates 　# 一个文件名，当这个文件存在，则该命令不执行,可以

用来做判断

removes # 一个文件名，这个文件不存在，则该命令不执行

[root@server ~]# ansible web -m command -a 'chdir=/data/ ls'	#先切换到/data/ 目录，再执行“ls”命令
192.168.37.122 | SUCCESS | rc=0 >>
aaa.jpg
fastdfs
mogdata
tmp
web
wKgleloeYoCAMLtZAAAWEekAtkc497.jpg

192.168.37.133 | SUCCESS | rc=0 >>
aaa.jpg
fastdfs
mogdata
tmp
web
wKgleloeYoCAMLtZAAAWEekAtkc497.jpg

[root@server ~]# ansible web -m command -a 'creates=/data/aaa.jpg ls'		#如果/data/aaa.jpg存在，则不执行“ls”命令
192.168.37.122 | SUCCESS | rc=0 >>
skipped, since /data/aaa.jpg exists

192.168.37.133 | SUCCESS | rc=0 >>
skipped, since /data/aaa.jpg exists

[root@server ~]# ansible web -m command -a 'removes=/data/aaa.jpg cat /data/a'		#如果/data/aaa.jpg存在，则执行“cat /data/a”命令
192.168.37.122 | SUCCESS | rc=0 >>
hello

192.168.37.133 | SUCCESS | rc=0 >>
hello

shell 模块

ansible web -m shell -a '命令可以有管道符号'

copy 模块

ansible web -m copy -a 'src=* dest=*'

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

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

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

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

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

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

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

复制文件



给定内容生成文件赋予指定权限



覆盖内容并备份源文件

file 模块

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

　　下面是一些常见的命令：

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

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

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

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

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

state　　#状态，有以下选项：

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

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

link：创建软链接

hard：创建硬链接

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

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

创建目录



创建文件



创建链接文件



删除文件

fetch 模块

该模块用于从远程某主机获取（复制）文件到本地。

dest 用来存放文件的目录

src 在远程拉取的文件，并且必须是一个file，不能是目录

远程拷贝文件到本地

cron 模块

该模块适用于管理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 # 以哪个用户的身份执行

添加时间同步crontab定时任务



删除计划任务

yum 模块

yum 安装服务

name=　　#所安装的包的名称

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

update_cache　　#强制更新yum的缓存

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

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

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

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

安装htop命令

ansible web -m yum -a 'name=htop state=present'

service 模块

服务管理模块

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

enabled #设置开机启动。

name= #服务名称

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

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

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

设置nginx服务启动并开机自启



停止nginx服务

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

创建一个用户并指定uid



删除指定用户

group 模块使用

gid=　　#设置组的GID号

name=　　#指定组的名称

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

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

创建组



删除组

script 模块使用

script模块是使用本地的shell脚本在client端执行

执行test.sh脚本因为脚本在当前目录下所有没有加绝对路径

**setup 模块使用 **

该模块主要用于收集信息，是通过调用facts组件来实现的。

　　facts组件是Ansible用于采集被管机器设备信息的一个功能，我们可以使用setup模块查机器的所有facts信息，可以使用filter来查看指定信息。整个facts信息被包装在一个JSON格式的数据结构中，ansible_facts是最上层的值。

　　facts就是变量，内建变量 。每个主机的各种信息，cpu颗数、内存大小等。会存在facts中的某个变量中。调用后返回很多对应主机的信息，在后面的操作中可以根据不同的信息来做不同的操作。如redhat系列用yum安装，而debian系列用apt来安装软件。

① 查看信息

　我们可以直接用命令获取到变量的值，具体我们来看看例子：



保存查询结果到本地目录