Ansible运维工具

摘要：与最大的区别是无需在被控主机部署任何客户端代理，默认直接通过通道进行远程命令执行或下发配置相同点是都具备功能强大灵活的系统管理状态配置，两者都提供丰富的模板及，对云计算平台大数据都有很好的支持。临时禁止使用库。强制更新的缓存。

运维工具按需不需要有代理程序来划分的话分两类：

agent（需要有代理工具）：基于专用的agent程序完成管理功能，puppet, func, zabbix

agentless（无须代理工具）：基于ssh服务完成管理，ansible, fabric

　　Ansible是一个简单的自动化运维管理工具，基于Python语言实现，由Paramiko和PyYAML两个关键模块构建，可用于自动化部署应用、配置、编排task(持续交付、无宕机更新等)。主版本大概每2个月发布一次。

　　Ansible与Saltstack最大的区别是Ansible无需在被控主机部署任何客户端代理，默认直接通过SSH通道进行远程命令执行或下发配置：相同点是都具备功能强大、灵活的系统管理、状态配置，两者都提供丰富的模板及API，对云计算平台、大数据都有很好的支持。

    部署简单，只需在主控端部署Ansible环境，被控端无需做任何操作；

    默认使用SSH协议对设备进行管理；

    主从集中化管理；

    配置简单、功能强大、扩展性强；

    支持API及自定义模块，可通过Python轻松扩展；

    通过Playbooks来定制强大的配置、状态管理；

    对云计算平台、大数据都有很好的支持；

    提供一个功能强大、操作性强的Web管理界面和REST API接口——AWX平台。

    幂等性：一种操作重复多次结果相同

简评：
(1)、轻量级，无需在客户端安装agent，更新时，只需在操作机上进行一次更新即可；
(2)、批量任务执行可以写成脚本，而且不用分发到远程就可以执行；
(3)、使用python编写，维护更简单，ruby语法过于复杂；
(4)、支持sudo。

Ansible核心组件说明：

    Ansible：Ansible的核心程序

    Host Lnventory：记录了每一个由Ansible管理的主机信息，信息包括ssh端口，root帐号密码，ip地址等等。可以通过file来加载，可以通过CMDB加载

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

    Core Modules：Ansible执行任何管理任务都不是由Ansible自己完成，而是由核心模块完成；Ansible管理主机之前，先调用core Modules中的模块，然后指明管理Host Lnventory中的主机，就可以完成管理主机。

    Custom Modules：自定义模块，完成Ansible核心模块无法完成的功能，此模块支持任何语言编写。

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

(1)、SSH免密钥登录设置

ansiblemaster：10.1.6.172 Centos7.2

ansibleslave1：10.1.6.72 Centos7.2

ansibleslave2：10.1.6.73 Centos7.2

ansibleslave3：10.1.6.68 Centos6.8

生成公钥/私钥

ssh-keygen -N ""

分发密钥

# ssh-copy-id root@10.1.6.73
# ssh-copy-id root@10.1.6.72
# ssh-copy-id root@10.1.6.68

测试

注意

[root@ansible_master ~]# ssh-copy-id -i ~/.ssh/id_rsa.pub 10.1.6.72

-bash: ssh-copy-id: command not found

报错了
解决方法：

yum -y install openssh-clients

安装

# yum install ansible

程序：

ansible
ansible-playbook 
ansible-doc

配置文件：

/etc/ansible/ansible.cfg

host_key_checking = False

主机清单：

/etc/ansible/hosts

插件目录：

/usr/share/ansible_plugins/

常用选项

ansible -m MOD_NAME -a MOD_ARGS
表示调用什么模块，使用模块的那些参数

ansible -h

[root@localhost ~]# ansible -h
Usage: ansible [options]

Options:
-a MODULE_ARGS, --args=MODULE_ARGS 模块的参数,如果执行默认COMMAND的模块，即是命令参数,如：“date”,"pwd"等等

                    module arguments    模块参数

-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, --background=SECONDS 后台运行超时时间

                    run asynchronously, failing after X seconds
                    (default=N/A)

-C, --check don"t make any changes; instead, try to predict some 只是测试一下会改变什么内容，不会真正去执行;相反,试图预测一些可能发生的变化

                    of the changes that may occur

-c CONNECTION, --connection=CONNECTION 连接类型使用。可能的选项是paramiko(SSH),SSH和地方。当地主要是用于crontab或启动。

                    connection type to use (default=smart)

-f FORKS, --forks=FORKS 并行任务数。NUM被指定为一个整数,默认是5

                    specify number of parallel processes to use
                    (default=5)

-h, --help show this help message and exit 打开帮助文档API
-i INVENTORY, --inventory-file=INVENTORY 指定库存主机文件的路径,默认为/etc/ansible/hosts

                    specify inventory host file
                    (default=/etc/ansible/hosts)

-l SUBSET, --limit=SUBSET 进一步限制所选主机/组模式 --limit=192.168.91.135 只对这个ip执行

                    further limit selected hosts to an additional pattern

--list-hosts outputs a list of matching hosts; does not execute

                    anything else

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

                    module name to execute (default=command)

-M MODULE_PATH, --module-path=MODULE_PATH 要执行的模块的路径，默认为/usr/share/ansible/

                    specify path(s) to module library
                    (default=/usr/share/ansible/)

-o, --one-line condense output 压缩输出，摘要输出.尝试一切都在一行上输出。
-P POLL_INTERVAL, --poll=POLL_INTERVAL 调查背景工作每隔数秒。需要- b

                    set the poll interval if using -B (default=15)

--private-key=PRIVATE_KEY_FILE 私钥路径，使用这个文件来验证连接

                    use this file to authenticate the connection

-S, --su run operations with su 用 su 命令
-R SU_USER, --su-user=SU_USER 指定SU的用户，默认是root用户

                    run operations with su as this user (default=root)

-s, --sudo run operations with sudo (nopasswd)
-U SUDO_USER, --sudo-user=SUDO_USER sudo到哪个用户，默认为 root

                    desired sudo user (default=root)

-T TIMEOUT, --timeout=TIMEOUT 指定SSH默认超时时间， 默认是10S

                    override the SSH timeout in seconds (default=10)

-t TREE, --tree=TREE log output to this directory 将日志内容保存在该输出目录,结果保存在一个文件中在每台主机上。
-u REMOTE_USER, --user=REMOTE_USER 远程用户， 默认是root用户

                    connect as this user (default=root)

--vault-password-file=VAULT_PASSWORD_FILE

                    vault password file

-v, --verbose verbose mode (-vvv for more, -vvvv to enable 详细信息

                    connection debugging)

--version show program"s version number and exit 输出ansible的版本

vim /etc/ansible/hosts

定义方式：

直接指明主机地址或主机名

  blue.example.com
  192.168.100.1

定义一个主机组[组名]把地址或主机名加进去

  [webservers]
  alpha.example.org
  beta.example.org
  192.168.1.100

  #组成员可以使用通配符来匹配，如下
  www[001:006].example.com  #表示从www001-www006主机

如果你没有使用公钥，想要使用密码，你也可以这样写（适用于第一次登陆控制）

  格式：【主机名】 【主机地址】 【主机密码】  默认是root用户来进行的

  [keepalived]
  keepalived1  ansible_ssh_host=192.168.146.136 ansible_ssh_pass="test"
  keepalived2  ansible_ssh_host=192.168.146.137 ansible_ssh_pass="test"

[testhost]
10.6.0.152
10.6.0.153 ansible_ssh_host=10.6.0.153 ansible_ssh_pass="yanjin"
10.6.0.153 ansible_ssh_host=10.6.0.153 ansible_ssh_pass="yanjin"

一般用法:

ansible-doc -l 获取模块信息

ansible-doc -s MOD_NAME 获取指定模块的使用帮助

[root@localhost ~]# ansible-doc -h
Usage: ansible-doc [options] [module...]

Show Ansible module documentation 显示Ansible模块文档

Options:
--version show program"s version number and exit 显示ansible-doc的版本号
-h, --help show this help message and exit 显示命令参数API文档
-M MODULE_PATH, --module-path=MODULE_PATH 查询模块，--module-path=MODULE_PATH 指定模块的路径

                    Ansible modules/ directory

-l, --list List available modules 显示已存在的所有模块列表
-s, --snippet Show playbook snippet for specified module(s) 显示playbook制定模块的用法
-v Show version number and exit 显示ansible-doc的版本号

测试：成功

ansible 10.6.0.152 -m command -a "id root"

10.6.0.152 | SUCCESS | rc=0 >>

uid=0(root) gid=0(root) groups=0(root)
ansible 10.6.0.153 -m command -a "id root"
10.6.0.153 | SUCCESS | rc=0 >>
uid=0(root) gid=0(root) groups=0(root)

ansible testhost -m command -a "id root"
10.6.0.152 | SUCCESS | rc=0 >>
uid=0(root) gid=0(root) groups=0(root)
10.6.0.153 | SUCCESS | rc=0 >>
uid=0(root) gid=0(root) groups=0(root)

[root@master ~]# ansible proxy -m command -a "ls -lh /var/log/squid/access.log"
10.6.0.100 | SUCCESS | rc=0 >>
-rw-r----- 1 squid nogroup 0 Nov 17 11:02 /var/log/squid/access.log
[root@master ~]# ansible proxy -m command -a "ls -lh /var/log/squid/store.log"
10.6.0.100 | SUCCESS | rc=0 >>
-rw-r----- 1 squid nogroup 320 Nov 17 11:03 /var/log/squid/store.log
[root@master ~]#

常用模块：

=================================

=================================

=================================

ansible storm_cluster -m command -a "ls –al /tmp/resolv.conf"

–

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

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

注意：command和shell模块的核心参数直接为命令本身；而其它模块的参数通常为“key=value”格式；

================================

================================

用法：
(1) 复制文件

-a "src=  dest=  "

(2) 给定内容生成文件

    -a "content=  dest=  "

常用用法

    第一种：直接复制

    第二种：生成内容的复制

ansible test -m copy -a "src=/root/test dest=/home/testcopy mode=640"
10.6.0.152 | SUCCESS => {
    "changed": true,
    "checksum": "da39a3ee5e6b4b0d3255bfef95601890afd80709",
    "dest": "/home/testcopy",
    "gid": 0,
    "group": "root",
    "md5sum": "d41d8cd98f00b204e9800998ecf8427e",
    "mode": "0640",
    "owner": "root",
    "size": 0,
    "src": "/root/.ansible/tmp/ansible-tmp-1479352868.18-83082559134161/source",
    "state": "file",
    "uid": 0

}

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

===============================

===============================

用法：
(1) 创建目录：

-a "path=。。。  state=directory"

(2) 创建链接文件：

-a "path=。。。  src=...  state=link"

(3) 删除文件：

-a "path=。。。  state=absent"

相关选项如下：

force：需要在两种情况下强制创建软链接，一种是源文件不存在，但之后会建立的情况下；另一种是目标软链接已存在，需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no
group：定义文件/目录的属组
mode：定义文件/目录的权限
owner：定义文件/目录的属主
path：必选项，定义文件/目录的路径
recurse：递归设置文件的属性，只对目录有效
src：被链接的源文件路径，只应用于state=link的情况
dest：被链接到的路径，只应用于state=link的情况
state：

   directory：如果目录不存在，就创建目录
   file：即使文件不存在，也不会被创建
   link：创建软链接
   hard：创建硬链接
   touch：如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间
   absent：删除目录、文件或者取消链接文件

==============================

==============================

==============================

ansible all -m cron -a "name="sync time" state=absent" 表示删除此任务

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 )

=========================

=========================

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

==============================

==============================

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

启动httpd服务：

ansible all -m service -a "name=httpd state=started"

开机自启动

ansible all -m service -a "name=httpd  enabled=true"

================================
## group: 组管理

================================

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

name: 添加或删除组
action: group

gid # 设置组的GID号
name= # 管理组的名称
state # 指定组状态，默认为创建，设置值为absent为删除
system # 设置值为yes，表示为创建系统组

================================

================================

-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 #指明密码的过期时间

例：创建用户并添加密码