ansible基础

ansible 系统架构

原文：https://www.jianshu.com/p/575ced3a08fa

• ansible简介
  ansible是新出现的自动化运维工具，ansible是一个配置管理和应用部署工具,基于Python开发，集合了众多运维工具（puppet、cfengine、chef、func、fabric.SaltStack ）的优点，实现了批量系统配置、批量程序部署、批量运行命令等功能。ansible是基于模块工作的，本身没有批量部署的能力。真正具有批量部署的是ansible所运行的模块，ansible只是提供一种框架,根据官方提供的信息，当前使用ansible的用户有:
  美国国家航空航天局（NASA /ˈnæsə/）
  evernote(印象笔记),rackspace(全球三大云计算中心之一),atlassian,twitter(全球互联网上访问量最大的十个网站之一)等
  ansible在生产环境当中的应用
• 自动化部署应用
• 自动化管理配置
• 自动化持续交付
• 自动化(aws)云服务器管理
• ansible的优点

1. ansible糅合了众多老牌运维工具的优点，基本上pubbet和saltstack能实现的功能全部能实现
2. 轻量级，无需在客户端安装agent，更新时，只需在操作机上进行一次更新即可；
3. ansible是一个工具，ansible不需要启动服务，仅仅只是一个工具，可以轻松的实现分布式扩展
4. 批量任务执行可以写成脚本，而且不用分发到远程就可以执行
5. ansible是一致性，高可靠性，安全性设计的轻量级自动化工具
6. 使用python编写，维护更简单，ruby语法过于复杂；

• 特性
  (1)、no agents：不需要在被管控主机上安装任何客户端；
  (2)、no server：无服务器端，使用时直接运行命令即可；
  (3)、modules in any languages：基于模块工作，可使用任意语言开发模块；
  (4)、yaml，not code：使用yaml语言定制剧本playbook；
  (5)、ssh by default：基于SSH工作；
  (6)、strong multi-tier solution：可实现多级指挥。

ansible的基本架构
1.连接插件(connectior plugins) 用于连接主机 用来连接被管理端
2.核心模块(core modules) 连接主机实现操作， 它依赖于具体的模块来做具体的事情
3.自定义模块(custom modules) 根据自己的需求编写具体的模块
4.插件(plugins) 完成模块功能的补充
5.playbooks(剧本) ansible的配置文件,将多个任务定义在剧本中，由ansible自动执行
6.host inventory（主机清单）定义ansible需要操作主机的范围
最重要的一点是 ansible是模块化的 它所有的操作都依赖于模块
https://www.processon.com/mindmap/58d6713be4b0359bbccc00aa 架构图

image

比如我需要创建一个文件 那么我就需要调用file模块 我需要copy文件，那么我就需要copy模块
我需要测试机器的存活率，那么就需要ping模块
ansible all -m ping

image.png

 

ansible安装

• ansible只是一个进程 不需要添加数据库也不需要启动和运行守护进程它只是一个进程你可以轻松使用它安装在任何一点主机上面（除了windows）ansible管理机不能安装到windows上面
• 版本的选择 因为2.0有非常大的改进 一般都会使用2.0以上的版本
• 控制机的要求 因为ansible是python写的 所以需要在安装了python2.6或者2.7以上的python版本才可以安装
• 管理节点的要求 需要安装ssh python版本在2.5以上
• 安装有3个方式

1. yum -y install ansible wget -O /etc/yum.repos.d/epel.repo http://mirrors.aliyun.com/repo/epel-6.repo（下载yum源）
2. pip install ansible
3. 从github下载

$ git clone git：//github.com/ansible/ansible.git --recursive
$ cd ./ansible
$ make rpm
$ sudo rpm -Uvh ./rpm-build/ansible-*.noarch.rpm

任务执行模式

ansible系统由控制主机对被管节点的操作方式有两种ad_hoc和playbook

• ad_hoc单命令模式 可以对多台主机执行单个命令

ansible all -a "/bin/echo hello"

• playbook通过多个tasks的集合完成一类功能如web的安装部署，数据库服务器的批量备份等

---
- hosts: webservers
  vars:
    http_port: 80
    max_clients: 200
  remote_user: root
  tasks:
  - name: ensure apache is at the latest version
    yum: name=httpd state=latest
  - name: write the apache config file
    template: src=/srv/httpd.j2 dest=/etc/httpd.conf
    notify:
    - restart apache
  - name: ensure apache is running (and enable it at boot)
    service: name=httpd state=started enabled=yes
  handlers:
    - name: restart apache
      service: name=httpd state=restarted

安装完ansible后，发现ansible一共为我们提供了七个指令：ansible、ansible-doc、ansible-galaxy、ansible-lint、ansible-playbook、ansible-pull、ansible-vault 。这里我们只查看usage部分，详细部分可以通过 “指令 -h” 的方式获取。
1、ansible
[root@localhost ~]# ansible -h Usage: ansible [options]

ansible是指令核心部分，其主要用于执行ad-hoc命令，即单条命令。默认后面需要跟主机和选项部分，默认不指定模块时，使用的是command模块。如：
[root@localhost ~]# ansible 127.0.0.1 -a ‘date‘ 127.0.0.1 | SUCCESS | rc=0 >>Sun May 28 11:00:40 CST 2017

默认使用的模块是可以在ansible.cfg 中进行修改的。ansible命令下的参数部分解释如下

参数：
 -a ‘Arguments‘, --args=‘Arguments‘ 命令行参数
 -m NAME, --module-name=NAME 执行模块的名字，默认使用 command 模块，所以如果是只执行单一命令可以不用 -m参数 
-i PATH, --inventory=PATH 指定库存主机文件的路径,默认为/etc/ansible/hosts. 
-u Username， --user=Username 执行用户，使用这个远程用户名而不是当前用户 
-U --sud-user=SUDO_User sudo到哪个用户，默认为 root -k --ask-pass 登录密码，提示输入SSH密码而不是假设基于密钥的验证 
-K --ask-sudo-pass 提示密码使用sudo -s --sudo sudo运行 
-S --su 用 su 命令 -l --list 显示所支持的所有模块 
-s --snippet 指定模块显示剧本片段 
-f --forks=NUM 并行任务数。NUM被指定为一个整数,默认是5。 #ansible testhosts -a "/sbin/reboot" -f 10 重启testhosts组的所有机器，每次重启10台
 --private-key=PRIVATE_KEY_FILE 私钥路径，使用这个文件来验证连接
-v --verbose 详细信息 all 针对hosts 定义的所有主机执行 
-M MODULE_PATH, --module-path=MODULE_PATH 要执行的模块的路径，默认为/usr/share/ansible/ 
--list-hosts 只打印有哪些主机会执行这个 playbook 文件，不是实际执行该 playbook 文件 
-o --one-line 压缩输出，摘要输出.尝试一切都在一行上输出。 
-t Directory, --tree=Directory 将内容保存在该输出目录,结果保存在一个文件中在每台主机上。 
-B 后台运行超时时间 -P 调查后台程序时间 -T Seconds, --timeout=Seconds 时间，单位秒s 
-P NUM, --poll=NUM 调查背景工作每隔数秒。需要- b 
-c Connection, --connection=Connection 连接类型使用。可能的选项是paramiko(SSH),SSH和地方。当地主要是用于crontab或启动。 
--tags=TAGS 只执行指定标签的任务 例子:ansible-playbook test.yml --tags=copy 只执行标签为copy的那个任务 
--list-hosts 只打印有哪些主机会执行这个 playbook 文件，不是实际执行该 playbook 文件
--list-tasks 列出所有将被执行的任务 
-C, --check 只是测试一下会改变什么内容，不会真正去执行;相反,试图预测一些可能发生的变化 
--syntax-check 执行语法检查的剧本,但不执行它 
-l SUBSET, --limit=SUBSET 进一步限制所选主机/组模式 --limit=192.168.0.15 只对这个ip执行 
--skip-tags=SKIP_TAGS 只运行戏剧和任务不匹配这些值的标签 --skip-tags=copy_start 
-e EXTRA_VARS, --extra-vars=EXTRA_VARS 额外的变量设置为键=值或YAML / JSON 
#cat update.yml 
--- 
- hosts: {{ hosts }} 
  remote_user: {{ user }} 
  .............. 
  #ansible-playbook update.yml --extra-vars "hosts=vipers user=admin" 传递{{hosts}}、{{user}}变量,hosts可以是 ip或组名 
-l,--limit 对指定的 主机/组 执行任务 --limit=192.168.0.10，192.168.0.11 或 -l 192.168.0.10，192.168.0.11 只对这个2个ip执行任务

2、ansible-doc

[root@localhost ~]# ansible-doc -hUsage: ansible-doc [options] [module...]Options: -a, --all Show documentation for all modules -h, --help show this help message and exit -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) -v, --verbose verbose mode (-vvv for more, -vvvv to enable connection debugging) --version show program‘s version number and exit

该指令用于查看模块信息，常用参数有两个-l 和 -s ，具体如下
//列出所有已安装的模块# ansible-doc -l//查看具体某模块的用法，这里如查看command模块# ansible-doc -s command

3、ansible-galaxy
ansible-galaxy 指令用于方便的从https://galaxy.ansible.com/ 站点下载第三方扩展模块，我们可以形象的理解其类似于centos下的yum、python下的pip或easy_install 。如下示例：

[root@localhost ~]# ansible-galaxy install aeriscloud.docker- downloading role ‘docker‘, owned by aeriscloud- downloading role from https://github.com/AerisCloud/ansible-docker/archive/v1.0.0.tar.gz- extracting aeriscloud.docker to /etc/ansible/roles/aeriscloud.docker- aeriscloud.docker was installed successfully

这个安装了一个aeriscloud.docker组件，前面aeriscloud是galaxy上创建该模块的用户名，后面对应的是其模块。在实际应用中也可以指定txt或yml 文件进行多个组件的下载安装。这部分可以参看官方文档。
4、ansible-lint
ansible-lint是对playbook的语法进行检查的一个工具。用法是ansible-lint playbook.yml 。
5、ansible-playbook
该指令是使用最多的指令，其通过读取playbook 文件后，执行相应的动作，这个后面会做为一个重点来讲。
6、ansible-pull
该指令使用需要谈到ansible的另一种模式－－－pull 模式，这和我们平常经常用的push模式刚好相反，其适用于以下场景：你有数量巨大的机器需要配置，即使使用非常高的线程还是要花费很多时间；你要在一个没有网络连接的机器上运行Anisble，比如在启动之后安装。这部分也会单独做一节来讲。
7、ansible-vault
ansible-vault主要应用于配置文件中含有敏感信息，又不希望他能被人看到，vault可以帮你加密/解密这个配置文件，属高级用法。主要对于playbooks里比如涉及到配置密码或其他变量时，可以通过该指令加密，这样我们通过cat看到的会是一个密码串类的文件，编辑的时候需要输入事先设定的密码才能打开。这种playbook文件在执行时，需要加上 –ask-vault-pass参数，同样需要输入密码后才能正常执行。具体该部分可以参查官方博客。

ansible配置文件 ansible.cfg

查看配置文件设置
http://docs.ansible.com/ansible/intro_configuration.html#poll-interval

* inventory–这个参数表示资源清单inventory文件配置，资源清单就是一些ansible需要链接管理的主机列表。安装完ansible之后默认所在的inventory列表配置如下：  

inventory = /etc/ansible/hosts    

* library–Ansible的操作动作，无论是本地或远程，都使用一小段代码来执行。这小段代码成为模块，这个library参数就是只想存放在Ansible模块的目录。Ansible支持多个目录方式，只要用冒号（：）隔开就可以，同时也会检查当前执行playbook位置下的./library位置。默认的配置如下：

library = /usr/share/ansible  

* forks–设置默认情况下Ansible最多能有多少个进程同时工作，默认设置最多5个进程并行处理。具体需要设置多少个，可以根据控制主机的性能和被管理节点的数量来确定。默认参数配置如下： forks=20 你没有优化的优化的情况下执行比较慢

forks = 5

* sudo_user–这个设置默认执行命令的用户，在playbook中重新设置这个参数。默认参数配置如下：

sudo_user = root  

* remote_port–这个是指定链接被管节点的管理端口，默认22。除非设置了特殊的SSH端口，不然这个参数一般是不需要修改的。默认配置如下：

remote_port = 22

* host_key_checking–这个设置是否检查SSH主机的秘钥。可以设置为True或者False。默认配置如下：

host_key_checking = false  

* timeout–这是设置SSH链接的超时间隔，单位是秒。默认配置实例如下：

timeout = 60

* log_path–Ansible系统默认是不记录日志的，如果想把Ansible系统的输出记录到日志文件中，需要设置log\_path来指定一个存储Ansible日志的文件。配置实例如下：

log_path = /var/log/ansible.log  
poll_interval 异步执行任务的时候多久检查一次任务装填
poll_interval = 15

选择远程的工具   默认情况下就是smart(智能)模式  自动选择连接方式
只有当你需要优化执行速度的时候才需要修改这个选项
transport = smart 

module_set_locale  设置本地的环境变量  
inventory      = /etc/ansible/hosts     这个是默认库文件位置,脚本,或者存放可通信主机的目录  
#library        = /usr/share/my_modules/   Ansible默认搜寻模块的位置  
remote_tmp     = $HOME/.ansible/tmp   Ansible 通过远程传输模块到远程主机,然后远程执行,执行后在清理现场.在有些场景下,你也许想使用默认路径希望像更换补丁一样使用  
pattern        = *    如果没有提供“hosts”节点,这是playbook要通信的默认主机组.默认值是对所有主机通信  
forks          = 5    在与主机通信时的默认并行进程数 ，默认是5d  
poll_interval  = 15    当具体的poll interval 没有定义时,多少时间回查一下这些任务的状态, 默认值是5秒  
sudo_user      = root   sudo使用的默认用户 ，默认是root  
#ask_sudo_pass = True   用来控制Ansible playbook 在执行sudo之前是否询问sudo密码.默认为no  
#ask_pass      = True    控制Ansible playbook 是否会自动默认弹出密码  
transport      = smart   通信机制.默认 值为’smart’。如果本地系统支持   ControlPersist技术的话,将会使用(基于OpenSSH)‘ssh’,如果不支持讲使用‘paramiko’.其他传输选项包括‘local’, ‘chroot’,’jail’等等  
#remote_port    = 22    远程SSH端口。 默认是22  
module_lang    = C   模块和系统之间通信的计算机语言，默认是C语言  
gathering = implicit   控制默认facts收集（远程系统变量）. 默认值为’implicit’, 每一次play,facts都会被收集
#roles_path    = /etc/ansible/roles   roles 路径指的是’roles/’下的额外目录,用于playbook搜索Ansible roles
#host_key_checking = False    检查主机密钥
sudo_exe = sudo     如果在其他远程主机上使用另一种方式执sudu操作.可以使用该参数进行更换
#what flags to pass to sudo   传递sudo之外的参数
#sudo_flags = -H

#SSH timeout    SSH超时时间
timeout = 10
#remote_user = root   使用/usr/bin/ansible-playbook链接的默认用户名，如果不指定，会使用当前登录的用户名
#log_path = /var/log/ansible.log     日志文件存放路径
#module_name = command     ansible命令执行默认的模块
#executable = /bin/sh     在sudo环境下产生一个shell交互接口. 用户只在/bin/bash的或者sudo限制的一些场景中需要修改
#jinja2_extensions = jinja2.ext.do,jinja2.ext.i18n      允许开启Jinja2拓展模块
#private_key_file = /root/.ssh/id_rsa        私钥文件存储位置
ansible_managed = Ansible managed: {file} modified on %Y-%m-%d %H:%M:%S by {uid} on {host}   这个设置可以告知用户,Ansible修改了一个文件,并且手动写入的内容可能已经被覆盖.
#display_skipped_hosts = True     显示任何跳过任务的状态 ，默认是显示
#error_on_undefined_vars = False      如果所引用的变量名称错误的话, 将会导致ansible在执行步骤上失败
#system_warnings = True    允许禁用系统运行ansible相关的潜在问题警告
#deprecation_warnings = True     允许在ansible-playbook输出结果中禁用“不建议使用”警告
#command_warnings = False    当shell和命令行模块被默认模块简化的时,Ansible 将默认发出警告
#nocows = 1    默认ansible可以调用一些cowsay的特性   开启/禁用：0/1
#nocolor = 1  输出带上颜色区别， 开启/关闭：0/1

---

3. 配置Linux主机SSH无密码访问

3.1 生成秘钥

#ssh-keygen -t rsa

3.2 将秘钥拷贝到预管理的节点上

#ssh-copy-id -i /root/.ssh/id_rsa.pub [email protected]

4. ansible执行

4.1测试主机连通性

修改主机和配置

#vim /etc/ansible/hosts

[xxx]

10.0.0.1

10.0.0.2

ansible all -m ping -k -k指令是增加密码验证

4.2批量执行命令

ansible all -m shell -a '/bin/echo hello ansible'

4.3帮助
学习一个软件最重要的2个东西 第一个帮助文档 第二个官方文档

ansible-doc -h

ansible-doc -l

ansible-doc -s yum

有助于我们排错
查看详细信息 -v -vvv

官方文档 http://docs.ansible.com

python接口的调用帮助文档 需要进python去看

python环境下

import ansible

from ansible.runner import Runner

from ansible.playbook import PlayBook

help(ansible.runner)

help(ansible.playbook)

5.ansible组件

5.1ansible inventory

所有的机器信息都存放到ansible的inventory组件里面，默认ansible的inventory是一个静态的ini格式的文件/etc/ansible/hosts 当然还可以通过ANSIBLE_HOSTS环境变量指定或者运行ansible和ansible-playbook的时候用-i参数临时设置
a、中括号中的名字代表组名，你可以根据你自己的需求将庞大的主机分成具有标识的组，如上面我分了两个组webservers和dbservers组；

b、主机(hosts)部分可以使用域名、主机名、IP地址表示；当然使用前两者时，也需要主机能反解析到相应的IP地址，一般此类配置中多使用IP地址；

• 定义主机和主机组

[docker] #定义了一组叫docker
172.16.1.11 #组下面的主机

172.11.11.11 # ansible_ssh_pass='123456'

[docker:vars] #针对docker组使用inventroy内置变量定义了ssh登陆密码

ansible_ssh_pass='123456'

[ansible:children]#定义了一个ansible组 下面包含一个docker组

docker

• 多个inventory列表

配置支持多个inventory
首先需要修改ansible.cfg中hosts的定义改成一个目录比如 hostfile = /data/inventory

然后我们在目录里面放入多个hosts文件

[root@ceshi2 data]# tree inventory

inventory

├── docker

└── hosts

不同的文件可以存放不同的主机:

cat inventory\/hosts

172.16.4.11 ansible_ssh_pass='123456'

cat inventory/docker

[docker]

172.16.1.11 #组下面的主机

172.11.11.11 # ansible_ssh_pass='123456'

[docker:vars] #针对docker组使用inventroy内置变量定义了ssh登陆密码

ansible_ssh_pass='123456'

[ansible:children]#定义了一个ansible组 下面包含一个docker组

docker

inventory内置参数

ansible_ssh_host # 要连接的主机名
ansible_ssh_port # 端口号默认是22
ansible_ssh_user # ssh连接时默认使用的用户名
ansible_ssh_pass # ssh连接时的密码
ansible_sudo_pass # 使用sudo连接用户是的密码
ansible_ssh_private_key_file # 秘钥文件如果不想使用ssh-agent管理时可以使用此选项
ansible_shell_type # shell的类型默认sh
ansible_connection # SSH 连接的类型： local , ssh , paramiko在 ansible 1.2 之前默认是 paramiko ，后来智能选择，优先使用基于 ControlPersist 的 ssh （支持的前提）
ansible_python _ interpreter #用来指定 python 解释器的路径，同样可以指定ruby 、perl 的路径

• 动态Inventory

动态inventory的意思是所有的变量可以从外部获取,也就是说我们可以从CMDB以及zabbix系统拉取所有的主机信息然后使用ansible进行管理。引用inventory只需要把ansible.cfg文件中的inventory定义值改成一个执行脚本即可。
脚本实例查看例子2-2-1

#!/usr/bin/env python
# coding=utf-8
import json
host1ip = ['192.168.1.15']
host2ip = ['192.168.1.110']
group = 'test11'
group2 = 'test22'
hostdata = {group:{"hosts":host1ip},group2:{"hosts":host2ip}}
print json.dumps(hostdata,indent=4)

执行

[root@vagrant-centos65 opt]# ansible -i inverti.py all  -a 'uptime' -k
SSH password: 
192.168.1.15 | SUCCESS | rc=0 >>
 07:25:27 up  3:56,  3 users,  load average: 0.00, 0.00, 0.00
192.168.1.110 | SUCCESS | rc=0 >>
 07:25:27 up 7 min,  3 users,  load average: 0.00, 0.02, 0.00

5.2ansible Ad-Hoc命令

ad-hoc是点对点的执行ansible命令，介绍一下日常的Ad-Hoc命令

ansible docker -m shell -a 'hostname' -o

-o的意思是异步执行

ansible docker -B 120 -P 0 -m shell -a 'sleep 10;hostname' -o #加了-P 0 之后会返回一个job_id 可以通过jobID去查看执行的结果

ansible 172.17.42.101 -m async_status -a 'jid='5265654654''

当-P 大于0的时候会轮询去查询执行结果

其他的一些常用的命令我们会在以后的例子里面给大家讲

5.3ansible playbook

playbook是一个剧本，当我们ansible日常命令ad-hoc命令功能完成不了时，就需要playbook来实现了

在实际工作过程中我们大部分的时间都在编写playbook 会在后面的课程单独讲

5.4 ansible facts CMDB

facts是ansible用于采集被管机器设备信息的一个功能,我们可以使用setup模块差机器的所有的facts信息

ansible 172.17.1.1 -m setup 收集到信息后可以直接在后面YAML脚本中引用

5.5 role

role是对我们日常使用的playbook的目录结构进行规范化，下面使用一个案例来介绍role

案例在2-2-3

5.6 ansible Galaxy

这个是官网的分享role的功能平台,可以自己去下载别人写好的role来使用网址是https://galaxy.ansible.com/list

/roles

Options:

-a MODULE_ARGS, --args=MODULE_ARGS

module arguments

-k, --ask-pass ask for SSH password

-K, --ask-sudo-pass ask for sudo 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

connection type to use (default=smart)

-f FORKS, --forks=FORKS

specify number of parallel processes to use

(default=6)

-h, --help show this help message and exit

-i INVENTORY, --inventory-file=INVENTORY

specify inventory host file

(default=/etc/ansible/hosts)

-l SUBSET, --limit=SUBSET

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

module name to execute (default=command)

-M MODULE_PATH, --module-path=MODULE_PATH

specify path(s) to module library

(default=/usr/share/ansible)

-o, --one-line condense output

-P POLL_INTERVAL, --poll=POLL_INTERVAL

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

--private-key=PRIVATE_KEY_FILE

use this file to authenticate the connection

-s, --sudo run operations with sudo (nopasswd)

-U SUDO_USER, --sudo-user=SUDO_USER

desired sudo user (default=root)

-T TIMEOUT, --timeout=TIMEOUT

override the SSH timeout in seconds (default=10)

-t TREE, --tree=TREE log output to this directory

-u REMOTE_USER, --user=REMOTE_USER

connect as this user (default=root)

-v, --verbose verbose mode (-vvv for more, -vvvv to enable

connection debugging)

--version show program's version number and exit