Ansible

Posted fina

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Ansible相关的知识,希望对你有一定的参考价值。

Ansible

Ansible 是一种 agentless(基于 ssh),可实现批量配置、命令执行和控制,基于 Python 实现的自动化运维工具。
其特性有:

  • 模块化:通过调用相关模块,完成指定任务,且支持任何语言编写的自定义模块
  • playbook:剧本,可根据需要一次执行完剧本中的所有任务或某些任务
        
    /usr/bin/ansible: 命令行工具
    ansible 命令通用格式:ansible

1、安装ansible(依赖于epel源)

wget -O /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo

yum install ansible -y 

执行ansible报错

ERROR! Unexpected Exception, this is probably a bug: (cryptography 0.8.2 (/usr/lib64/python2.7/site-packages), Requirement.parse(‘cryptography>=1.1‘))

解决方法
rpm -qa |grep python-crypto    把列出的 rpm 包全部删除
rpm -e python-cryptography --nodeps    强制删除

2、定义HOSTS文件,配置主机,配置登陆方式

cd /etc/ansible/
cp  hosts{,.bak}

2-1使用配置文件认证方式(不推荐这种方式)

vim hosts
[webs]
192.168.2.100 ansible_ssh_user=root ansible_ssh_pass=123456
192.168.2.101 ansible_ssh_user=root ansible_ssh_pass=123456 ansible_ssh_port=22

[dbs]
192.168.2.102 ansible_ssh_user=root ansible_ssh_pass=123456 ansible_ssh_port=22

若报这个错,需用SSH连接一次即可

[[email protected] ansible]# ansible

192.168.2.101 | FAILED! => {
    "msg": "Using a SSH password instead of a key is not possible because Host Key checking is enabled and sshpass does not support this.  Please add this host‘s fingerprint to your known_hosts file to manage this host."
}

[[email protected] ansible]# ssh 192.168.2.101
The authenticity of host ‘192.168.2.101 (192.168.2.101)‘ can‘t be established.
ECDSA key fingerprint is 58:da:34:71:b4:08:0c:95:c3:ff:72:15:c4:05:10:24.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added ‘192.168.2.101‘ (ECDSA) to the list of known hosts.
[email protected]‘s password: 
Last login: Tue Oct 23 13:26:43 2018 from 192.168.2.254

2-2基于密钥方式登陆

ssh-keygen -t rsa
ssh-copy-id -i /root/.ssh/id_rsa.pub [email protected]192.168.2.100
ssh-copy-id -i /root/.ssh/id_rsa.pub [email protected]192.168.2.101
ssh-copy-id -i /root/.ssh/id_rsa.pub [email protected]192.168.2.102

配置完测下

ansible all -m ping
192.168.2.101 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}
192.168.2.100 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}
192.168.2.102 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}

3、如何查看模块帮助
ansible-doc -l 列出哪些模块
ansible-doc -s MODULE_NAME 查看模块参数

语法
ansible <host-pattern> [options]
-f forks:启动的并发线程数
-m module_name:要使用的模块
-a args:模块物有的参数

常用模块

command:命令模块,默认模块,用于在远程执行命令

  • creates:一个文件名,当该文件存在,则该命令不执行
  • free_form:要执行的 linux 指令
  • chdir:在执行指令之前,先切换到该目录
  • removes:一个文件名,当该文件不存在,则该选项不执行
  • executable:切换 shell 来执行指令,该执行路径必须是一个绝对路径
    ansible all -a ‘date‘
    ansible all -m command ‘date‘

cron:计划任务模块

  • minute=/hour=/day=/month=/weekday= 某个值不写,默认就是 *
  • name: 必选项,任务描述信息
  • job: 执行的任务,要加引号
  • state:present(创建)/absent(删除)
ansible all -m cron -a ‘minute="30" hour="3" job="usr/sbin/ntpdate ntp.aliyun.com" name="ntp date time"‘

查看下结果 
[[email protected] ~]# ansible all -a ‘crontab -l‘
删除此计划任务
ansible all -m cron -a ‘name="ntp date time" state=absent‘

user模块

  • name: 用户名
  • password: 为用户设置登陆密码,此密码是明文密码加密后的密码
  • update_password:always/on_create
    • always: 只有当密码不相同时才会更新密码 (默认)
    • on_create: 只为新用户设置密码
  • shell: 用户的 shell 设定
  • groups: 用户组设定
  • home: 指定用户的家目录
  • state:present/absent
  • append:yes/no
    • yes: 增量添加 group
    • no: 全量变更 group, 只设置 groups 指定的 group 组 (默认)
  • remove: 配合 state=absent 使用,删除用户的家目录 ->remove=yes
  • expires: 设置用户的过期时间,值是一个时间戳
创建用户
ansible dbs -m user -aname="user1"192.168.2.102 | SUCCESS => {
    "changed": true, 
    "comment": "", 
    "createhome": true, 
    "group": 1000, 
    "home": "/home/user1", 
    "name": "user1", 
    "shell": "/bin/bash", 
    "state": "present", 
    "system": false, 
    "uid": 1000
}
删除用户
ansible dbs -m user -aname="user1" state=absent‘

group模块

  • name: 组名称
  • gid: 指定 GID
  • state:present/absent
  • system:yes/no
ansible dbs -m group -a ‘name=mysql gid=306 system=yes‘
ansible dbs -m user -a ‘name=mysql uid=306 system=yes group=mysql‘

验证下
ansible dbs -a ‘grep mysql /etc/passwd‘

copy模块

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

content=取代src=,表明用此处的信息生成目标文件
使用信息输出目标文件
ansible dbs -m copy -a ‘content="ansbile test" dest=/tmp/test.ans‘
ansible dbs -a ‘cat /tmp/test.ans‘

file模块:设定文件属性

  • group:定义文件 / 目录的属组
  • mode:定义文件 / 目录的权限
  • owner:定义文件 / 目录的属主
  • path:必选项,定义文件 / 目录的路径 指定符号链接文件路径
  • recurse:递归设置文件的属性,只对目录有效
  • src:被链接的源文件路径,只应用于 state=link 的情况
  • dest:被链接到的路径,只应用于 state=link 的情况
  • state:
    • directory:如果目录不存在,就创建目录
    • file:即使文件不存在,也不会被创建
    • link:创建软链接
    • hard:创建硬链接
    • touch:如果文件不存在,则会创建一个新的文件,如果文件或目录已存在,则更新其最后修改时间
    • absent:删除目录、文件或者取消链接文件
更换文件权限
ansible dbs -m file -a ‘owner=mysql group=mysql mode=600 path=/tmp/test.ans‘
创建链接文件
ansible dbs -m file -a ‘path=/tmp/fstab.link src=/tmp/fstab.ans state=link‘

ping模块

测试远程主机的是否在线

ansible all -m ping

service模块指定服务运行状态

  • enabled=是否开机自动启动,取值为true或者false
  • name=服务名称
  • state=状态,会有started stoped restarted
  • runlevel: 运行级别
ansible dbs -m service -a ‘enabled=true name=mysqld state=started‘

shell模块

虽然执行成功,但密码没有设置成功,可能当做本地的命令符号
注意:尤其是用到管道等功能的复杂命令,使用shell模块

ansible all  -a ‘echo password|passwd --stdin user1‘
若使用到管理符号请使用shell模块
ansible all  -m shell -a ‘echo password|passwd --stdin user1‘

script模块

将本地脚本复制到远程主机并运行
注意:要使用相对路径指定脚本

ansible all -m script -a ‘/root/test.sh‘

yum模块

安装程序包

  • name=指明要安装的程序包,可以带上版本号
  • state=present,latest表示安装,absent表示卸载
ansible dbs -m yum -a ‘name=vsftpd‘

setup模块

查看远程主机的相关 facts 变量信息

ansible all -m setup

playbook组成结构

inventory
modules
ad hoc commands
playbooks
    tasks:任务
    variables:变量
    templates:模板
    handlers:处理器
    roles:角色

示例1 安装httpd包,配置文件,启动服务

vim webs.yml
- hosts: webs
  remote_user: root
  tasks:
  - name: install httpd package
    yum: name=httpd
  - name: install httpd config
    copy: src=/root/httpd.conf dest=/etc/httpd/conf/httpd.conf
  - name: start httpd service
    service: enabled=true name=httpd state=started

示例2 若更改配置文件,触发handlers将重启服务

vim webs.yml
- hosts: webs
  remote_user: root
  tasks:
  - name: install httpd package
    yum: name=httpd
  - name: install httpd config
    copy: src=/root/httpd.conf dest=/etc/httpd/conf/httpd.conf
    notify:
    - restart httpd
  - name: start httpd service
    service: enabled=true name=httpd state=started
  handlers:
  - name: restart httpd
    service: name=httpd state=restarted

示例3 引用变量

- hosts: webs
  remote_user: root
  vars:
  - package: httpd
  - service: httpd
  tasks:
  - name: install httpd package
    yum: name={{ package }}
  - name: install httpd config
    copy: src=/root/httpd.conf dest=/etc/httpd/conf/httpd.conf
    notify:
    - restart httpd
  - name: start httpd service
    service: enabled=true name={{ service }} state=started
  handlers:
  - name: restart httpd
    service: name={{ package }} state=restarted

输出facts中的某个变量并输入到文件

- hosts: dbs
  remote_user: root
  tasks:
  - name: copy file
    copy: content="{{ ansible_all_ipv4_addresses }}" dest=/tmp/vars.ans

when 条件测试
满足条件ansible_fqdn == "db1",将执行tasks

vim when.yml
- hosts: all
  remote_user: root
  vars:
  - username: user1
  tasks:
  - name: crate {{ username }} user
    user: name={{ username }}
    when: ansible_fqdn == "db1"

迭代:重复同类task时使用
调用:item
定义循环列表:with_items
- httpd
- php
- mysql-server

注意:with_items中的列表值也可以是字典,但引用时要使用tiem.KEY
- {name: httpd, conf: configfile/httpd.conf}
- {name: php, conf: configfile/php.ini}
- {name: mysql-server, conf: configfile/my.cnf}

http_port 变量定义在/etc/ansible/hosts文件里

[[email protected] ~]# grep port /etc/ansible/hosts
192.168.2.100 http_port=80 
192.168.2.101 http_port=8080

[[email protected] ~]# vim webs.yml
- hosts: webs
  remote_user: root
  vars:
  - package: httpd
  - service: httpd
  tasks:
  - name: install httpd package
    yum: name={{ package }}
  - name: install httpd config
    template: src=/root/httpd.conf.t1 dest=/etc/httpd/conf/httpd.conf
    notify:
    - restart httpd
  - name: start httpd service
    service: enabled=true name={{ service }} state=started
  handlers:
  - name: restart httpd
    service: name={{ package }} state=restarted
  • tags:在playbook可以为某个或某些任务定义一个标签,在执行此playbook时,通过为ansible-playbook命令使用--tags选项能实现仅运行指定的tasks而非所有的:
    template: src=/root/httpd.conf.t1 dest=/etc/httpd/conf/httpd.conf
    tags:
    - conf

    特殊tags: always

--tags="conf" --tars="restart"

- hosts: webs
  remote_user: root
  vars:
  - package: httpd
  - service: httpd
  tasks:
  - name: install httpd package
    yum: name={{ package }}
    tags:
    - always
  - name: install httpd config
    template: src=/root/httpd.conf.t1 dest=/etc/httpd/conf/httpd.conf
    tags:
    - conf
    notify:
    - restart httpd
  - name: start httpd service
    service: enabled=true name={{ service }} state=started
    tags:
    - restart
  handlers:
  - name: restart httpd
    service: name={{ package }} state=restarted

roles:

目录名同角色名
目录结构有固定格式

  • files:静态文件
  • templates:jinjia2模板文件
  • tasks:至少有mail.yml文件,定义名tasks
  • handlers:至少有一个mail.yml定义handlers
  • vars:至少有一个mail.yml文件,定义变量
  • meta:定义依赖关系等信息
  • site.yml中定义playbook,额外也可以有其它的yml文件
创建目录
mkdir -pv ansible_playbooks/roles/{webs,dbs}/{tasks,files,templates,meta,handlers,vars}
查看创建的目录结构 
[[email protected] ~]# tree ansible_playbooks/
ansible_playbooks/
├── roles
│   ├── dbs
│   │   ├── files
│   │   ├── handlers
│   │   ├── meta
│   │   ├── tasks
│   │   ├── templates
│   │   └── vars
│   └── webs
│       ├── files
│       │   └── httpd.conf
│       ├── handlers
│       │   └── main.yml
│       ├── meta
│       ├── tasks
│       │   └── main.yml
│       ├── templates
│       │   └── httpd.conf.j2
│       └── vars
│           └── main.yml
└── site.yml

下面是相关的配置文件

vim /root/ansible_playbooks/roles/webs/handlers/main.yml
- name: restart httpd
  service: name=httpd state=restarted
vim /root/ansible_playbooks/roles/webs/tasks/main.yml
- name: install httpd package
  yum: name=httpd
- name: install conf file
  template: src=httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf
  tags:
  - conf
  notify:
  - restart httpd
- name: start httpd service
  service: name=httpd state=started enabled=true
grep "{{" /root/ansible_playbooks/roles/webs/templates/httpd.conf.j2 
Listen {{ http_port }}
ServerName {{ ansible_fqdn }}
vim /root/ansible_playbooks/roles/webs/vars/main.yml
http_port: "{{ 8888 }}"

验证下

[root@ansibles ~]#ansible-playbook ansible_playbooks/site.yml
[root@ansibles ~]# ansible webs -a ‘ss -tnl‘|grep 8888
LISTEN     0      128         :::8888                    :::*                  
LISTEN     0      128         :::8888                    :::*



























以上是关于Ansible的主要内容,如果未能解决你的问题,请参考以下文章

从jenkinsfile启动包含vault文件引用的Ansible playbook

ansible代码分析第一篇--主文件—ansible分析

python代码调用ansible

Ansible

基于ansible的zabbix源代码安装

需要代码来使用 Ansible 检查服务器连接