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 Console界面可与用户交互的命令执行工具

其中最主要用到的命令是：

ansible <host-pattern> [-f forks] [-m module_name] [-a args]
ansible 主机清单中的主机组 -f 开启线程数 -m 模块 -a 模块需要的参数


ansible 主机名 [-m 模块] [-a] '语句'

ansible命令模块

主机一	web-1
主机二	web-2

Ping

 ansible all ping   # 可以查看对应的主机是否连通

command 模块

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

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

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

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

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

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

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

如果不可以加入模块的话 默认是这个 command

ansible web-1 -m command -a '命令'
ansible web-1 -m command -a 'chair=/opt/ ls'  
# 可以直接切换到web-1主机的 opt 目录下面执行 ls命令

shell 模块

万金油模块，所有的shell中命令都可以使用这个模块进行使用

ansible web-2 -m shell -a '命令'

copy 模块

这个模块用于将文件复制到远程主机，同时支持给定内容生成文件和修改权限等。 　　其相关选项如下：

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

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

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

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

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

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

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

ansible web-1 -m copy -a 'src=/root/a.txt dest=/opt/a.txt'
# 后面加入 backup=yes 可以备份
# mode=777 可设置文件权限
ansible web-1 -m copy -a 'content="aaa" dest=/opt/a.txt backup=yes force=yes'

file 模块

该模块主要用于设置文件的属性，比如创建文件、创建链接文件、删除文件等。 　　下面是一些常见的命令：

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

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

mode：定义文件/目录的权限

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

path：定义文件/目录的路径

recurse　　#递归设置文件的属性，只对目录有效，后面跟上

src：被链接的源文件路径，只应用于state=link的情况

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

state　　#状态，有以下选项：

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

link：创建软链接

hard：创建硬链接

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

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

ansible web-1 -m file -a 'path=/opt/ppt state=directory'
# 创建一个目录 用户名 组 都是 root
# 可以添加其他的参数进行更多的配置

fetch 模块

该模块用于从远程某主机获取（复制）文件到本地。 　　有两个选项：

dest：用来存放文件的目录

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

ansible web-1 -m fetch 'dest=/root/ src=/opt/ppt'
# 会在本地目录创建一个 /root/web-1/opt/ppt

cron 模块

该模块适用于管理cron计划任务的。 　　其使用的语法跟我们的crontab文件中的语法一致，同时，可以指定以下选项：

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 web-1 -m dron -a 'name="ls" minute=* job="ls /opt/" state=present' 

yum 模块

顾名思义，该模块主要用于软件的安装。 　　其选项如下：

name=　　 #所安装的包的名称

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

update_cache　　#强制更新yum的缓存

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

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

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

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

ansible web-1 -m yum -a 'name=httpd state=present'

service 模块

该模块用于服务程序的管理。 　　其主要选项如下：

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

enabled #设置开机启动。
name= #服务名称

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

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

state #有四种状态，分别为：

started—>启动服务，

stopped—>停止服务，

restarted—>重启服务，

reloaded—>重载配置

ansible web-1 -m service -a 'name=httpd state=started'

user 模块

该模块主要是用来管理用户账号。 　　其主要选项如下：

comment　　# 用户的描述信息

createhome　　# 是否创建家目录

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

group　　# 指定基本组

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

home　　 # 指定用户家目录

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

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

password　　# 指定用户密码,对密码加密可以使用python的crypt和passlib remove　　# 在使用state=absent时, 行为是与userdel –remove一致
shell　　# 指定默认shell

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

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

uid　　# 指定用户的uid

ansible web-1  -m user -a 'name=yp'
# 创建一个用户为yp

group 模块

该模块主要用于添加或删除组。 　　常用的选项如下：

gid=　　#设置组的GID号

name=　　#指定组的名称

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

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

ansible web -m group -a 'name=sanguo gid=12222'

script 模块

该模块用于将本机的脚本在被管理端的机器上运行。 　　该模块直接指定脚本的路径即可，我们通过例子来看一看到底如何使用的： 　　首先，我们写一个脚本，并给其加上执行权限：

ansible web-1 -m script -a '/tmp/df.sh'ag-0-1heu3kavsag-1-1heu3kavs

setup 模块

facts组件是Ansible用于采集被管机器设备信息的一个功能，我们可以使用setup模块查机器的所有facts信息，可以使用filter来查看指定信息。整个facts信息被包装在一个JSON格式的数据结构中，ansible_facts是最上层的值。
　　facts就是变量，内建变量 。每个主机的各种信息，cpu颗数、内存大小等。会存在facts中的某个变量中。调用后返回很多对应主机的信息，在后面的操作中可以根据不同的信息来做不同的操作。如redhat系列用yum安装，而debian系列用apt来安装软件。

ansible web -m setup -a 'filter="*mem*"'   #查看内存
ansible web -m setup    # 查看所有信息

get_url模块

用途： 用于将文件或软件从http、https或ftp下载到本地节点上

常用参数：

dest： 指定将文件下载的绝对路径---必须
url： 文件的下载地址（网址）---必须
url_username: 用于http基本认证的用户名
url_password： 用于http基本认证的密码
validate_certs： 如果否，SSL证书将不会验证。这只应在使用自签名证书的个人控制站点上使用
owner： 指定属主
group： 指定属组
mode： 指定权限

ansible -i /etc/ansible/hosts  zabbix -m get_url -a "url=ftp://10.3.131.50/soft/wechat.py dest=/tmp"

stat模块

 用途：检查文件或文件系统的状态
注意：
对于Windows目标，请改用win_stat模块

选项：
path：文件/对象的完整路径（必须）

案例：

name: install_apcu | Check if apcu local file is already configured.
stat: path={{ php_apcu_file_path }}
connection: local
register: php_apcu_file_result
常用的返回值判断：
exists： 判断是否存在
isuid： 调用用户的ID与所有者ID是否匹配ag-0-1heu3kavsag-1-1heu3kavsag-0-1heu3kavsag-1-1heu3kavs

unarchive模块

用途：从本地机器上复制存档后，将其解包。
说明：
该unarchive模块将解压缩一个存档。
默认情况下，它将在解包之前将源文件从本地系统复制到目标。
设置remote_src=yes为解包目标上已经存在的档案。
对于Windows目标，请改用win_unzip模块。

常用选项：

dest：远程绝对路径，档案应该被解压缩
exec：列出需要排除的目录和文件
src：指定源
creates：一个文件名，当它已经存在时，这个步骤将不会被运行。

ansible -i /etc/ansible/hosts web -m unarchive -a 'src=/root/easy-springmvc-maven.zip dest=/tmp'

- name: Extract foo.tgz into /var/lib/foo
 unarchive:
   src: foo.tgz
   dest: /var/lib/foo

- name: Unarchive a file that is already on the remote machine
 unarchive:
   src: /tmp/foo.zip
   dest: /usr/local/bin
   remote_src: yes

- name: Unarchive a file that needs to be downloaded (added in 2.0)
 unarchive:
   src: https://example.com/example.zip
   dest: /usr/local/bin
   remote_src: yes

unarchive模块

用途：从本地机器上复制存档后，将其解包。
说明：
该unarchive模块将解压缩一个存档。
默认情况下，它将在解包之前将源文件从本地系统复制到目标。
设置remote_src=yes为解包目标上已经存在的档案。
对于Windows目标，请改用win_unzip模块。

常用选项：

dest：远程绝对路径，档案应该被解压缩
exec：列出需要排除的目录和文件
src：指定源
creates：一个文件名，当它已经存在时，这个步骤将不会被运行。

ansible -i /etc/ansible/hosts web -m unarchive -a 'src=/root/easy-springmvc-maven.zip dest=/tmp'

- name: Extract foo.tgz into /var/lib/foo
 unarchive:
   src: foo.tgz
   dest: /var/lib/foo

- name: Unarchive a file that is already on the remote machine
 unarchive:
   src: /tmp/foo.zip
   dest: /usr/local/bin
   remote_src: yes

- name: Unarchive a file that needs to be downloaded (added in 2.0)
 unarchive:
   src: https://example.com/example.zip
   dest: /usr/local/bin
   remote_src: yes