ansible工具

ansible运维

ansible简介

  • 官方的title是:Ansible is Simple IT Automation 即 简单的自动化it工具
  • ansible跟其他it自动化技术的区别在于其关注点并非是配置管理,应用部署或it流程工作流,而是提供一个统一的界面来协调所有的it自动化功能,因此ansible的系统更加易用,部署更快。
  • ansible可以让用户避免编写脚本或代码来管理应用,同事还能搭建工作流实现it任务的自动化执行,it自动化可以降低技术门槛及对传统it的依赖,从而加快项目的交付速度

ansible的优缺点

  • 优点
    • 轻量级,他不需要去客户端安装agent(代理),更新是,只需要在主控机(操作机)上记性一次更新即可
    • 批量任务执行可以写成脚本,而且不用发布到远程就可以执行
    • 使用python编写,维护更简单
    • 支持sudo
  • 缺点
    • 因为不需要代理,直接基于ssh执行,所以执行效率相对较低
    • 对window备管节点需要加强

ansible架构及工作原理

  • ansible基本架构如下图所示

    img

    • ansible core: ansible自身核心模块
    • host inventory: 主机库,定义可管控的主机列表
    • connection plugins:连接插件,一般默认基于ssh协议连接
    • modules: core modules (自带模块), custome models(自定义模块)
    • playbooks: 剧本,按照所设定编排的顺序执行完成安排任务

ansible工作原理如图

img

  1. 主控端支持local,ssh,zeromq三种方式连接被控端,默认使用基于ssh的连接--------这部分对应基本架构架构图中的连接模块;

  2. 可以按应用类型等法师进行Host Inventory(主机群)分类,管理节点通过各类模块实现相应的操作,---单个模块,单条命令称为ad-hoc

  3. 管理节点统一通过playbooks实现多个task的集合实现一类功能,如web服务的安装部署,数据库服务端的批量备份等,palybooks我们可以理解为剧本,通过组合多条ad-hoc操作的配置文件

  4. ansible默认是通过ssh通道来管理的,也就是它所说的免客户端方式来管理,底层是通过paramiko来实现的

  5. ansible执行过程大体过程如下图,其中暖色的代表模块化

    img

部署安装

名称 IP 操作系统 用途
ansible-server 192.168.11.17 centos7 管理端
client-1 192.168.11.18 centos7
client-2 192.168.11.19 centos7

1. yum安装

需要先配置epel源,能帮助我们解决软件包的依赖关系
yum install http://mirrors.163.com/centos/7.4.1708/extras/x86_64/Packages/epel-release-7-9.noarch.rpm
# epel源 并安装ansible
	ll /etc/yum.repos.d/epel*
	
# 安装
yum install ansible -y

2. 源码安装

  1. 参考博客: https://blog.51cto.com/tengxiansheng/1863688

  2. 源码安装需要首先确保安装了git ,因为它的源码是保存在GitHub,我们需要利用git将其clone下来然后本地编译安装

    安装git yum install -y git

    安装ansible

    git clone https://github.com/ansible/ansible.git -recursive
    cd ./ansible
    source ./hacking/env-setup
    

    具体安装过程自己可以尝试哦,这里就不截图展示了。

    验证安装是否安装OK可以参考上面的ansible --version

3. pip安装

  1. 解决依赖

    yum install python-pip python-devel gcc gcc-c++ glibc-devel zlib-devel openssl-devel -y
    
  2. pip 安装ansible

    pip install ansibele --upgrade
    
    验证安装是否安装OK可以参考上面的ansible --version    
    
    ansible --version  查看版本
    

ansible配置文件

  • 两个核心文件:ansible.cfg和hosts文件,默认都存放在/etc/ansible目录下。

  • ansible.cfg:主要设置一些ansible初始化的信息,比如日志存放路径、模块、插件等配置信息

  • hosts:机器清单,进行分组管理

1. ansible.cfg文件

  • 文件配置常用参数

    使用化境变量方式来配置
    
    大多数的Ansible参数可以通过设置带有ANSIBLE_开头的环境变量进行配置,参数名称必须都是大写字母,如下配置:
    
    export ANSIBLE_SUDO_USER=root
    
    设置了环境变量之后,ANSIBLE_SUDO_USER就可以在playbook中直接引用。
    
    2、设置ansible.cfg配置参数
    
    Ansible有很多配置参数,下面列出常用的配置参数:
    
    1)inventory
    
    该参数表示资源清单inventory文件的位置,资源清单就是一些Ansible需要连接管理的主机列表
    
    inventory = /root/ansible/hosts
    
    2)library
    
    Ansible的操作动作,无论是本地或远程,都使用一小段代码来执行,这小段代码称为模块,这个library参数就是指向存放Ansible模块的目录
    
    library = /usr/share/ansible
    
    3)forks
    
    设置默认情况下Ansible最多能有多少个进程同时工作,默认设置最多5个进程并行处理。具体需要设置多少个,可以根据控制主机的性能和被管理节点的数量来确定。
    
    forks = 5
    
    4)sudo_user
    
    这是设置默认执行命令的用户,也可以在playbook中重新设置这个参数
    
    sudo_user = root
    
    5)remote_port
    
    这是指定连接被关节点的管理端口,默认是22,除非设置了特殊的SSH端口,不然这个参数一般是不需要修改的
    
    remote_port = 22
    
    6)host_key_checking
    
    这是设置是否检查SSH主机的密钥。可以设置为True或False
    
    host_key_checking = False
    
    7)timeout
    
    这是设置SSH连接的超时间隔,单位是秒。
    
    timeout = 20
    
    8)log_path
    
    Ansible系统默认是不记录日志的,如果想把Ansible系统的输出记录到人i治稳健中,需要设置log_path来指定一个存储Ansible日志的文件
    
    log_path = /var/log/ansible.log
    
    另外需要注意,执行Ansible的用户需要有写入日志的权限,模块将会调用被管节点的syslog来记录,口令是不会出现的日志中的
    
    9)host_key_checking
    
    如果有台被管节点重新安装系统并在known_hosts中有了与之前不同的密钥信息,就会提示一个密钥不匹配的错误信息,直到被纠正为止,在使用Ansible时,如果有台被管理节点没有在known_hosts中被初始化,将会在使用Ansible或定时执行Ansible时提示对key信息的确认。
    
    如果你不想出现这种情况,并且你明白禁用此项行为的含义,只要修改该参数为False即可
    
    host_key_checking = False
    

2. ansible hosts配置

  • 配置被控端主机地址的配置

    1. 编辑/etc/ansible/hosts
    2. 添加本机的public SSH key到目标机器的authorized_keys #ssh-copy-id
    3. 添加本机的私钥到Ansible
    4. 运行ansible all -m ping 测试是否添加成功
  • lnventory 分组

    • Ansible可同时操作属于一个组的多台主机,组和主机之间的关系通过inventory文件配置,默认文件路径为/etc/ansible/hosts
  • 常见参数配置

        ansible_ssh_host                    # 目标主机地址
        ansible_ssh_port                    # 目标主机端口,默认22
        ansible_ssh_user                    # 目标主机用户
        ansible_ssh_pass                    # 目标主机ssh密码
        ansible_sudo_pass                 # sudo密码
        ansible_sudo_exe                    
        ansible_connection               # 与主机的连接类型,比如:local,ssh或者paramiko
        ansible_ssh_private_key_file  # 私钥地址
        ansible_shell_type                 # 目标系统的shell类型
        ansible_python_interpreter   # python版本
    

    详细参数:https://www.cnblogs.com/LuisYang/p/5960660.html

  • 格式

    [test]     # 组名  
    10.0.0.1  # 主机ip  或者10.0.0.1:65522 自定义端口
    
  • 简单配置

    [defaults]
    inventory      = /etc/ansible/hosts
    sudo_user=root
    remote_port=22
    host_key_checking=False
    remote_user=root
    log_path=/var/log/ansible.log
    module_name=command
    private_key_file=/root/.ssh/id_rsa
    no_log:True
    
  • 参数

ansible常用模块

常用参数:

  • -m 模块
  • -i PYTH , -i 后面跟库存主机文件的路劲,默认为/etc/ansible/hosts
  • -a (arguments) 命令行参数

实例:

ansible tests1 -m copy -a 'src=/tmp/test.txt dest=/tmp/test/test.txt"

AAsWYF.png

ansible <host-pattern> [-f forks] [-m module_name] [-a args] [options] 
  • host-pattern:这次的命令对哪些主机生效;
  • -f forks:启动的并发线程数,就是一次并行处理多少主机;
  • -m module_name:要使用的模块;
  • -a args:模块特有的参数。

1. command 执行模块

  • 作为ansible的默认模块,可以允许远程主机范围内的所有shell命令。

    注意: 在command的命令中含有像$ HOME'这样的变量和像``<“',”>“, `“”“”,“”;“”和“”&“'将无法正常工作(如果需要这些功能,请使用[shell]模块)

    ansible 192.168.168.11* -m command -a 'ip addr show dev eth0'
    
    参数:
    – chdir:在运行命令之前,切换到此目录。
    

2. shell 执行模块

  • 功能:执行远程主机的shell脚本文件

    ansible all -m shell -a "/home/test.sh"
    
    
    参数:
    – chdir:在运行命令之前,切换到此目录。
    – executable:更改用于执行命令的shell(bash,sh)。 应该是可执行文件的绝对路径。
    

3. copy复制模块

  • 功能: 实现主控端向目标主机copy文件。

    ansible all -m copy -a "src=/home/test.sh dest=/tmp/ owner=root group=root mode=0755" 
    
    #src 主控端文件位置
    #dest 被控端目标位置
    #owner 文件复制过去后的所有者
    #group 文件复制过去后的所属组
    #mode  文件的权限设定,执行a+x这种方式
    
    

4. Fetch 抓取模块

  • 用途:用于从被控端 中拷贝文件到主控端

  • 注意: 不能拷贝目录

    ansible pythonserver -m fetch -a "src=/root/123 dest=/root"
    
    SSH password:
    - fetch:
        src: 在远程拉取的文件,并且必须是一个file,不能是目录
        dest: 用来存放文件的目录,例如存放目录为backup,源文件名称为/etc/profile在主机pythonserver中,那么保存为/backup/pythonserver/etc/profile
    

5. yum 安装模块

  • 功能:安装 软件包

     ansible all -m yum -a "name=httpd state=latest disable_gpg_check=yes enablerepo=epel"
    #name 包名
    #state (Choices: present, installed, latest, absent, removed)[Default: present]
    #disable_gpg_check:禁止gpg检查
    #enablerepo:只启动指定的repo
    

6. cron 计划模块

  • 功能: 被控端的crontab配置,用于管理计划任务的

  • 参考博客: https://blog.51cto.com/noodle/1769528

    ansible all -m cron -a "name='test' hour='2-5' minute='*/5' day='1' month='3,4' weekday='1' job='ls -l' user=tom"
    
    
    backup:对远程主机上的原任务计划内容修改之前做备份
     cron_file:如果指定该选项,则用该文件替换远程主机上的cron.d目录下的用户的任务计划
     minute分,hour时,day日,month月,weekday周
     job: 要执行的任务,依赖于state=present
     name: 该任务的描述
     special_time: 指定什么时候执行,参数:reboot,yearly,annually,monthly,weekly,daily,hourly
     state: 确认该任务计划是创建还是删除
     user: 以哪个用户身份执行
    

7. service 服务模块

  • 功能: 服务管理,

    [root@localhost ~]# ansible all -m service -a "name=httpd state=restarted"    #启动服务
    [root@localhost ~]# ansible all -m service -a "name=httpd state=running"      #查看服务状态
    [root@localhost ~]# ansible all -m service -a "name=httpd state=stoped"       #停止服务
    
    
    
    参数:
    enabled=:是否开机自动启动,取值为true或false;
    name=:服务名字;
    state=:状态,取值有started,stoped,restarted。
    

8. template 模板模块

  • 基于模板方式生成一个文件复制到远程主机(template使用Jinjia2格式作为文件模版,进行文档内变量的替换的模块。它的每次使用都会被ansible标记为”changed”状态。)

    - template:
        src: /mytemplates/foo.j2   
        dest: /etc/file.conf   
        owner: bin
        group: wheel
        mode: 0644
    
    
    – backup: 如果原目标文件存在,则先备份目标文件 
    – src:在ansible控制器上的Jinja2格式化模板的路径。 这可以是相对或绝对的路径。 
    – dest:将模板渲染到远程机器上的位置。 
    force:是否强制覆盖,默认为yes 
    – owner:目标文件属主 
    – group:目标文件属组 
    – mode:目标文件的权限模式,模式可以被指定为符号模式(例如,u + rwx或u = rw,g = r,o = r)
    

9. file 文件模块

  • 功能:用于远程主机上的文件操作,对文件的所有权,组合模式进行更改

    # 更改文件所有权,组和模式。 当使用八进制数指定模式时,第一个数字应始终为0。
    - file:
        path: /etc/foo.conf
        owner: foo
        group: foo
        mode: 0644
    
    # touch创建文件,使用符号模式设置权限(相当于0644)
    - file:
        path: /etc/foo.conf
        state: touch
        mode: "u=rw,g=r,o=r"
    
    # touch创建文件,添加/删除一些权限
    - file:
        path: /etc/foo.conf
        state: touch
        mode: "u+rw,g-wx,o-rwx"
    
    # 创建一个目录,如果它不存在
    - file:
        path: /etc/some_directory
        state: directory
        mode: 0755
    
    
    
    – force:需要在两种情况下强制创建软链接,一种是源文件不存在但之后会建立的情况下;另一种是目标软链接已存在,需要先取消之前的软链,然后创建新的软链,有两个选项:yes|no 
    – group:定义文件/目录的属组 
    – mode:定义文件/目录的权限 
    – owner:定义文件/目录的属主 
    – path:必选项,定义文件/目录的路径 
    – recurse:递归的设置文件的属性,只对目录有效 
    – src:要被链接的源文件的路径,只应用于state=link的情况 
    – dest:被链接到的路径,只应用于state=link的情况 
    – state: 
       directory:如果目录不存在,创建目录 
       file:即使文件不存在,也不会被创建 
       link:创建软链接 
       hard:创建硬链接 
       touch:如果文件不存在,则会创建一个新的文件,如果文件或目录已存在,则更新其最后修改时间 
       absent:删除目录、文件或者取消链接文件
    

10 user 用户模块

  • 功能: 远程主机用户管理

    [root@localhost ~]# ansible all -m user -a "name=jerry comment=' doubi jerry'"   #添加用户 详细参数参考ansible-doc user
    [root@localhost ~]# ansible all -m user -a "name=jerry state=absent remove=yes"  #删除用户
    

11 ping 模块

  • 功能: 检查指定节点机器是否还能连通,用法很简单,不涉及参数,主机如果在线,则回复pong

  • 还用个hping 模块,

    ansible erp -m ping
    

13 raw 执行原始命令模块

  • 执行原始的命令,而不是通过模块子系统。在任何情况下,使用shell或命令模块是合适的。给定原始的参数直接通过配置的远程shell运行。可返回标准输出、错误输出和返回代码。此模块没有变更处理程序支持。

    这个模块不需要远程系统上的Python,就像脚本模块一样。此模块也支持Windows目标。

14 pip 管理python库依赖 模块

  • 用于管理Python库依赖项,为了使用pip模块,必须提供参数name或者requirements

    # 安装bottle python包。
    - pip:
        name: bottle
    
    # 在0.11版安装bottle python包。
    - pip:
        name: bottle
        version: 0.11
    
    # 使用远程协议(bzr +,hg +,git +,svn +)安装MyApp。 您不必在extra_args中提供'-e'选项。
    - pip:
        name: svn+http://myrepo/svn/MyApp#egg=MyApp
    
    # 使用远程协议(bzr +,hg +,git +)安装MyApp。
    - pip:
        name: git+http://myrepo/app/MyApp
    
    # 从本地压缩包安装MyApp
    - pip:
        name: file:///path/to/MyApp.tar.gz
    
    # 将bottle安装到指定的virtualenv中,继承全局安装的模块
    - pip:
        name: bottle
        virtualenv: /my_app/venv
        virtualenv_site_packages: yes
    
    # 使用Python 2.7将bottle安装到指定的virtualenv中
    - pip:
        name: bottle
        virtualenv: /my_app/venv
        virtualenv_command: virtualenv-2.7
    
    # 在用户主目录中安装bottle。
    - pip:
        name: bottle
        extra_args: --user
    
    # 安装指定的python requirements
    - pip:
        requirements: /my_app/requirements.txt
    
    # 在指定的virtualenv中安装指定的python requirements。
    - pip:
        requirements: /my_app/requirements.txt
        virtualenv: /my_app/venv
    
    # 安装指定的python requirements和自定义pip源URL
    - pip:
        requirements: /my_app/requirements.txt
        extra_args: -i https://example.com/pypi/simple
    
    # 专门为Python 3.3安装bottle,使用'pip-3.3'可执行文件。
    - pip:
        name: bottle
        executable: pip-3.3
    
    # 安装 bottle,如果已安装,强制重新安装
    - pip:
        name: bottle
        state: forcereinstall
    
    
  • 参数

    – chdir: 执行pip命令前cd进入的目录 
    – name:要安装的Python库的名称或远程包的URL。 
    – requirements:一个pip requirements.txt文件的路径,它应该是远程系统的本地文件,如果使用chdir选项,则可以将文件指定为相对路径。 
    – version:指定的Python库的安装版本。 
    – extra_args:额外的参数传递给pip。 
    – executable:显式可执行文件或可执行文件的路径名,用于为系统中安装的特定版本的Python运行pip。 例如pip-3.3,如果系统中安装了Python 2.7和3.3,并且想要为Python 3.3安装运行pip。 它不能与“virtualenv”参数一起指定(在2.1中添加)。 默认情况下,它将采用适用于python解释器的版本。 pip3在python 3上,pip2或pip在python 2上。 
    – virtualenv:要安装到的virtualenv目录的可选路径。 它不能与’executable’参数一起指定(在2.1中添加)。 如果virtualenv不存在,则将在安装软件包之前创建它。 可选的virtualenv_site_packages,virtualenv_command和virtualenv_python选项会影响virtualenv的创建。 
    – virtualenv_command:用于创建虚拟环境的命令或路径名。 例如pyvenv,virtualenv,virtualenv2,~/bin /virtualenv,/usr/local/bin/virtualenv。 
    – virtualenv_python:用于创建虚拟环境的Python可执行文件。 例如python3.5,python2.7。 未指定时,将使用用于运行ansible模块的Python版本。 当virtualenv_command使用pyvenv或-m venv模块时,不应使用此参数。 
    – state:状态(present,absent,latest, forcereinstall),表示是安装还卸载 
       present:默认的,表示为安装 
       lastest: 安装为最新的版本 
       absent:表示删除 
       forcereinstall:“forcereinstall”选项仅适用于可ansible 2.1及更高版本。
    

15 group 组模块

  • 功能: 分组

     ansible web -m group -a 'name=g1 gid=666 state=present system=yes'
    
    – gid:指定用的gid。 
    – name:指定用户名。 
    – state:是创建还是删除。(present,absent) 
    – system:如果是,则表示创建的组是系统组。
    

16 get_url模块(类似wget下载)

  • 模块主要用于从http、ftp、https服务器上下载文件(类似于wget),主要有如下选项:

    - name: Download foo.conf
      get_url:
        url: http://example.com/path/file.conf
        dest: /etc/foo.conf
        mode: 0440
    
    - name: Download file with custom HTTP headers
      get_url:
        url: http://example.com/path/file.conf
        dest: /etc/foo.conf
        headers: 'key:value,key:value'
    
    - name: Download file with check (sha256)
      get_url:
        url: http://example.com/path/file.conf
        dest: /etc/foo.conf
        checksum: sha256:b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c
    
    
    
    – sha256sum:下载完成后进行sha256 check; 
    – timeout:下载超时时间,默认10s 
    – url:下载的URL 
    – url_password、url_username:主要用于需要用户名密码进行验证的情况 
    – dest:将文件下载到哪里的绝对路径。如果dest是目录,则使用服务器提供的文件名,或者如果没有提供,将使用远程服务器上的URL的基本名称。 
    – headers:以格式“key:value,key:value”为请求添加自定义HTTP标头。
    
    

17 unarchive 解压模块

  • 功能: 用于解压文件

    - name: 将foo.tgz解压缩到/var/lib/foo中
      unarchive:
        src: foo.tgz
        dest: /var/lib/foo
    
    - name: 解压远程计算机上已存在的文件
      unarchive:
        src: /tmp/foo.zip
        dest: /usr/local/bin
        remote_src: yes
    
    - name: 解压文档需要下载的文件(2.0中添加)
      unarchive:
        src: https://example.com/example.zip
        dest: /usr/local/bin
        remote_src: yes
    
    参数:
    – copy:在解压文件之前,是否先将文件复制到远程主机,默认为yes。若为no,则要求目标主机上压缩包必须存在。 
    – creates:指定一个文件名,当该文件存在时,则解压指令不执行 
    – dest:远程主机上的一个路径,即文件解压的绝对路径。 
    – group:解压后的目录或文件的属组 
    – list_files:如果为yes,则会列出压缩包里的文件,默认为no,2.0版本新增的选项 
    – mode:解压后文件的权限 
    – src:如果copy为yes,则需要指定压缩文件的源路径 
    – owner:解压后文件或目录的属主
    --------------------- 
    
    

18 script 复制并执行 模块

  • 功能: script模块将本地脚本复制到远程主机并运行之

     ansible web -m script -a 'time.sh'
    

19 setup 模块

  • 类似saltstack的grains静态信息收集,收集一些主机硬件信息或者以及其他如fqdn等等

  • 使用setup获取ip地址以及主机名使用filter过滤等等

    获取内存信息
    ansible db -m setup -a 'filter=ansible_memory_mb'
    
    
    获取主机名
    ansible db -m setup -a 'filter=ansible_nodename'
    
posted @ 2019-03-14 20:14  云丛  阅读(434)  评论(0编辑  收藏  举报