Ansible入门与实践

一、ansible介绍

Ansible是一个简单的自动化运维管理工具，基于Python语言实现，由Paramiko和PyYAML两个关键模块构建，可用于自动化部署应用、配置、编排task(持续交付、无宕机更新等)。主版本大概每2个月发布一次。
Ansible与Saltstack最大的区别是Ansible无需在被控主机部署任何客户端代理，默认直接通过SSH通道进行远程命令执行或下发配置。

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通信使用

二、ansible安装

在使用ansible之前需要配置ssh免密钥登陆

#yum安装就可以了
yum install ansible -y

　　

三、ansible命令介绍

ansible: # Ansibe AD-Hoc 临时命令执行工具，常用于临时命令的执行
ansible-doc: # Ansible 模块功能查看工具
ansible-galaxy: # 下载/上传优秀代码或Roles模块的官网平台，基于网络的
ansible-playbook: # Ansible 定制自动化的任务集编排工具
ansible-pull: # Ansible远程执行命令的工具（使用较少，海量机器时使用，对运维的架构能力要求较高）
ansible-vault: # Ansible 文件加密工具
ansible-console: # Ansible基于Linux Consoble界面可与用户交互的命令执行工具

四、ansible配置文件介绍

/etc/ansible/ansible.cfg （一般默认就好）

[defaults]
#inventory      = /etc/ansible/hosts  # 主机列表配置文件
#library        = /usr/share/my_modules/ # 库文件存放目录
#remote_tmp     = $HOME/.ansible/tmp  # 生成的临时py命令文件存放在远程主机的目录
#local_tmp      = $HOME/.ansible/tmp # 本机的临时命令执行目录
#forks          = 5     # 默认并发数
#poll_interval  = 15    # 默认的线程池
#sudo_user      = root  # 默认sudo 用户
#ask_sudo_pass = True
#ask_pass      = True
#transport      = smart
#remote_port    = 22
#module_lang    = C
#module_set_locale = False
host_key_checking = False  ### 检查对应服务器的host_key

[privilege_escalation]
[paramiko_connection]
[ssh_connection]
[accelerate]
[selinux]
[colors]

五、ansible主机清单文件介绍与使用

/etc/ansible/hosts

可以根据服务器的用途等创建对应的组

[root@master ~]# egrep -v "^$|^#" /etc/ansible/hosts
[test]
master ansible_ssh_host=172.31.0.180
node ansible_ssh_host=172.31.0.181

六、ansible常用命令

[root@node2 ~/.ssh]# ansible -h
Usage: ansible <host-pattern> [options]

Options:
  -a MODULE_ARGS, --args=MODULE_ARGS    #模块的参数,如果执行默认COMMAND的模块，即是命令参数,如：“date”,"pwd"等等
                        module arguments    #模块参数
  --ask-become-pass     ask for privilege escalation password # Ansible su切换用户的时候使用该参数输入密码
  -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  # ansible-valut 加密文件
  -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)
  -e EXTRA_VARS, --extra-vars=EXTRA_VARS  # 调用外部变量
  -f FORKS, --forks=FORKS    # Ansible一次命令执行并发的线程数,默认是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的版本

七、检测节点是否存活或联通

[root@master ~]# ansible all  -m ping
node | SUCCESS => {
    "changed": false,
    "ping": "pong"
}
master | SUCCESS => {
    "changed": false,
    "ping": "pong"
}

八、Ansible模块介绍与使用

1、command模块（默认模块）:使用ansible自带模块执行命令，如果要用 > < | & ' ' 使用shell模块

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

例如：
[root@master ~]# ansible  test -a 'hostname'
node | CHANGED | rc=0 >>
node

master | CHANGED | rc=0 >>
master

2、shell 模块:调用bash执行命令，可以使用> < | & ' '这些符号完成一些复杂的命令

常用参数
free_form参数 ：必须参数，指定需要远程执行的命令，但是并没有具体的一个参数名叫free_form，具体解释参考 command 模块。
chdir参数 : 此参数的作用就是指定一个目录，在执行对应的命令之前，会先进入到 chdir 参数指定的目录中。
creates参数 ：使用此参数指定一个文件，当指定的文件存在时，就不执行对应命令，可参考command 模块中的解释。
removes参数 ：使用此参数指定一个文件，当指定的文件不存在时，就不执行对应命令，可参考 command 模块中的解释。
executable参数：默认情况下，shell 模块会调用远程主机中的 /bin/sh 去执行对应的命令，通常情况下，远程主机中的默认 shell 都是 bash。如果你想要使用其他类型的 shell 执行命令，则可以使用此参数指定某种类型的 shell 去执行对应的命令。指定 shell 文件时，需要使用绝对路径。

例如：
[root@master ~]# ansible test -m shell -a  'ip a|awk "NR==7{print $2}"'
node | CHANGED | rc= >>
    inet 172.31.0.181/ brd 172.31.0.255 scope global dynamic eth0

master | CHANGED | rc= >>
    inet 172.31.0.180/ brd 172.31.0.255 scope global dynamic eth0

3、copy模块： 复制本地文件至远程服务器，并且能够改属性等

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

例如:
#将master的hosts文件复制到test模块中所有的/mnt目录下并设置权限为760
ansible  test -m copy -a 'src=/etc/hosts dest=/mnt mode=760'
[root@master ~]# ll /mnt/
total
-rwxrw----  root root  Jan  : hosts

4、file模块：设置文件属性

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

例如：在/mnt下创建一个test.txt文件
 ansible test  -m file -a 'path=/mnt/test.txt state=touch'
 [root@master ~]# ll /mnt/
total
-rwxrw----  root root  Jan  : hosts
-rw-r--r--  root root    Jan  : test.txt
#创建一个软连接
 ansible test  -m file -a 'path=/mnt/test_link src=/mnt/test.txt state=link'
 [root@master ~]# ll /mnt/
total
lrwxrwxrwx  root root  Jan  : test_link -> /mnt/test.txt
-rw-r--r--  root root   Jan  : test.txt

5、cron模块: 管理cron计划任务

常用命令与参数
backup=    # 如果设置，创建一个crontab备份
cron_file=          #如果指定, 使用这个文件cron.d，而不是单个用户crontab
day=       # 日应该运行的工作( -, *, */, etc )
hour=      # 小时 ( -, *, */, etc )
job=       #指明运行的命令是什么
minute=    #分钟( -, *, */, etc )
month=     # 月( -, *, */, etc )
name=     #定时任务描述
reboot    # 任务在重启时运行，不建议使用，建议使用special_time
special_time       # 特殊的时间范围，参数：reboot（重启时）,annually（每年）,monthly（每月）,weekly（每周）,daily（每天）,hourly（每小时）

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

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

例如：创建一个每年3月3日10:50份执行的定时任务
[root@master ~]# ansible test -m cron -a 'name=test_cron month=3 day=3  hour=10 minute=50 job="/bin/date  >/tmp/date.log"'
node | CHANGED => {
    "changed": true,
    "envs": [],
    "jobs": [
        "test_cron"
    ]
}
master | CHANGED => {
    "changed": true,
    "envs": [],
    "jobs": [
        "test_cron"
    ]
}
[root@master ~]# crontab  -l
#Ansible: test_cron
    * /bin/date  >/tmp/date.log

#删除定时任务
[root@master ~]# ansible test -m cron -a 'name=test_cron state=absent'
node | CHANGED => {
    "changed": true,
    "envs": [],
    "jobs": []
}
master | CHANGED => {
    "changed": true,
    "envs": [],
    "jobs": []
}
[root@master ~]# crontab  -l|wc -l

6、yum模块：yum安装软件

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

例如：下载lrzsz安装包
[root@master ~]# ansible test -m yum -a 'name=lrzsz state=latest'

7、service模块: 服务程序管理

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

例如：启动httpd服务
[root@master ~]# ansible test -m service -a 'name=httpd state=started'

8、group模块: 组管理

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

例如：创建一个aaa的组，gid设置为2222
[root@master ~]# ansible test -m group -a 'name=aaa gid=2222'
node | CHANGED => {
    "changed": true,
    "gid": ,
    "name": "aaa",
    "state": "present",
    "system": false
}
master | CHANGED => {
    "changed": true,
    "gid": ,
    "name": "aaa",
    "state": "present",
    "system": false
}

#查看
[root@master ~]# cat /etc/group|grep aaa
aaa:x::

删除aaa组

[root@master ~]# ansible test -m group -a 'name=aaa state=absent'

master | CHANGED => {
    "changed": true,
    "name": "aaa",
    "state": "absent"
}
node | CHANGED => {
    "changed": true,
    "name": "aaa",
    "state": "absent"
}

9、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        # 指定用户密码（password需要openssl加密）
remove          # 在使用 `state=absent'时, 行为是与 `userdel --remove'一致.
shell           # 指定默认shell
state           #设置帐号状态，不指定为创建，指定值为absent表示删除
system          # 当创建一个用户，设置这个用户是系统用户。这个设置不能更改现有用户。
uid             #指定用户的uid
update_password  # 更新用户密码
expires         #指明密码的过期时间

例如：创建一个qqq账号，指定uid为9999，指定密码为123456（password需要openssl加密）
#密码加密（password不能使用未加密的密码）
[root@master ~]# echo "" | openssl passwd - -salt $(< /dev/urandom tr -dc '[:alnum:]' | head -c ) -stdin
$$9fG3Nmvo$zfXmZvlm4aykJ3ZIUO5dx0

[root@master ~]# ansible test -m user -a 'name=qqq uid=9999  password="$1$9fG3Nmvo$zfXmZvlm4aykJ3ZIUO5dx0"'
node | CHANGED => {
    "changed": true,
    "comment": "",
    "create_home": true,
    "group": ,
    "home": "/home/qqq",
    "name": "qqq",
    "password": "NOT_LOGGING_PASSWORD",
    "shell": "/bin/bash",
    "state": "present",
    "system": false,
    "uid":
}

#登录测试
[root@master ~]# ssh  qqq@172.31.0.181
qqq@172.31.0.181's password: 

Welcome to Alibaba Cloud Elastic Compute Service !

[qqq@node ~]$ id
uid=(qqq) gid=(qqq) groups=(qqq)

#删除qqq账号
[root@master ~]# ansible test -m user -a 'name=qqq state=absent remove=yes'
node | CHANGED => {
    "changed": true,
    "force": false,
    "name": "qqq",
    "remove": true,
    "state": "absent"
}

10、script模块 发送脚本到各被管理节点，并执行;不需要参数

例如：
[root@master ~]# ll
total
-rwxr-xr-x  root root  Jan  : test.sh
[root@master ~]# cat test.sh
#!/bin/bash
source /etc/profile
date +%Y-%m-%d:%T >/mnt/test.log

[root@master ~]# ansible test -m script -a '/root/test.sh'
node | CHANGED => {
    "changed": true,
    "rc": ,
    "stderr": "Shared connection to 172.31.0.181 closed.\r\n",
    "stderr_lines": [
        "Shared connection to 172.31.0.181 closed."
    ],
    "stdout": "",
    "stdout_lines": []
}
master | CHANGED => {
    "changed": true,
    "rc": ,
    "stderr": "Shared connection to 172.31.0.180 closed.\r\n",
    "stderr_lines": [
        "Shared connection to 172.31.0.180 closed."
    ],
    "stdout": "",
    "stdout_lines": []
}
#查看
[root@master ~]# cat  /mnt/test.log
--:::