Ansible
ansible的使用前提是确保ssh的秘钥登录
ansible <host-pattern> [options] host-pattern：指定运行组 -v：显示更详细信息 -i PATH：手工指定运行组，默认/etc/ansible/hosts -f NUM：并发线程数，默认5 -m MODE：指定模块 -a 'ARGS'：模块参数 -k：认证密码 -K：sudo密码 -u USERNAME：指定运行用户 --list：列出符合条件的主机列表 --limit=:指定主机组中的主机，可以通过:做分隔符，用“”引起来 使用密码登陆：开启配置文件/etc/ansible/ansible.cfg中host_key_checking = False
例：ansible all -m shell -a 'date'
在/etc/ansible/hosts文件中可以定义管控的服务器组
[root@localhost ansible]# cat /etc/ansible/hosts #标准定义 [a] 172.17.148.111:2222 #可以加端口 172.17.148.113:2222 172.17.148.[120:130] #根据范围定义 #主机名定义 [b] www.a.com www.b.com www.[a:z].com #根据范围定义 #未进行秘钥分发的主机可以使用用户名密码 [c] 172.17.148.115 ansible_ssh_user=root ansible_ssh_pass=1 #针对a组的变量，：vars固定写法 [a:vars] ansible_ssh_user=root ansible_ssh_pass=1 #组嵌套，：children固定写法 [aaaa:children] a #这是其他组 b
查看模块帮助：
ansible-doc -l：列出可以使用的模块
ansible-doc -s MODULE_NAME：查看模块帮助
常用模块
0.debug:输出日志模块,常用于调试
msg:输出想要输出的内容
var:json格式输出
verbosity:输出级别,vvv就是3
1.command：命令模块，默认模块，用于在远程主机执行命令。
当shell命令中包含参数的时候需要改用ansible all -m shell -a 'XXXXX'
使用shell模块时一定要加上 ignore_errors: True 忽略错误,防止后面的playbook无法继续执行
[root@localhost ansible]# ansible all -m shell -a date 172.17.148.111 | SUCCESS | rc=0 >> 2018年 08月 08日 星期三 15:27:45 CST 172.17.148.113 | SUCCESS | rc=0 >> 2018年 08月 08日 星期三 15:27:45 CST
2.cron：用于在远程主机上添加定时任务或删除定时任务
job：要执行的任务
name：给这个任务起个名
state：present为添加任务，absent为删除任务
day，hour，minut，month，weekday：指定时间
#新建个每天晚上18点就关机的任务，命名为“everyday poweroff” [root@localhost ansible]# ansible all -m cron -a 'hour="18" job="/usr/sbin/poweroff" name="everyday poweroff" state="present" ' #查看刚刚新建定时任务是否成功 [root@localhost ansible]# ansible all -a "crontab -l" #删除刚刚新建的任务 [root@localhost ansible]# ansible all -m cron -a 'name="everyday poweroff" state="absent"'
3.user：创建用户一类的信息
name：指定用户名
home：设置家目录
shell：设置shell
uid：指定uid
group：指定用户组
groups：指定用户附加组
system：指定为系统用户，yes或no
state：present创建，absent删除
append：当为yes时，groups中的组为追加，no->覆盖
remove：结合state=absent时，remove=yes就是userdel -r
[root@localhost ansible]# ansible all -m user -a 'name=test uid=377 system=yes password="111" state=present'
4.group：创建组一类的信息
name：指定组名
gid：指定gid
system：指定为系统组，yes或no
state：present创建，absent删除
[root@localhost ansible]# ansible all -m group -a 'name=test gid=377 system=yes state=present'
5.copy：复制文件
src：指定本地源文件
dest：指定远程目标文件，绝对路径
content：取代src，表示直接用此处指定的信息生成为目标文件内容
owner：指定属主
mode：指定权限
5.1fetch：拉取文件
src：指定远端文件
dest：指定本地存放路径
6.file：设置文件属性
path：指定文件路径，创建链接
src：指明源文件
state：link创建符号链接，hard创建硬链接,directory创建文件夹
7.ping：连通性测试
[root@localhost ansible]# ansible all -m ping
172.17.148.113 | SUCCESS => {
"changed": false,
"ping": "pong"
}
172.17.148.111 | SUCCESS => {
"changed": false,
"ping": "pong"
}
8.service：管理服务
enabled：true开机自启动，false取消开机启动
name：服务名称
state：状态，started，stopped，restarted，reloaded
9.script：将本地脚本复制到远程主机并运行，-a直接指定脚本就可以，要使用相对路径
10.yum：安装程序包
name：指定包名，可以带上版本号
state：present安装，absent卸载，latest安装最新版
11.setup：收集远程主机的facts，每个被管理节点在接收并运行管理命令之前，会将自己主机相关信息，如操作系统版本、ip地址等报告给远程的ansbile主机。例如nginx启动之前要创建的工作进程个数是根据cpu的信息创建的。这个模块出来的值只能用在playbook，因为直接playbook会先执行setup模块收集信息。
ansible all -m setup --tree /tmp/facts：以各主机名为文件名保存在/tmp/facts目录下
ansible all -m setup -a 'filter="ansible_processor"' 只查看cpu相关信息
12.template：和copy模块差不多，不过template模块会把文件中的{{ 参数 }}转换为对应的值，copy不会
13.archive：压缩归档，默认是tar.gz
path：指定要压缩文件的位置
dest：指定压缩完成后文件名称
exclude_path：指定排除目录
14.unarchive：解压文件
copy：在解压文件之前，是否先将文件复制到远程主机，默认为yes。若为no，则要求目标主机上压缩包必须存在。
creates：指定一个文件名，当该文件存在时，则解压指令不执行
dest：远程主机上的一个路径，即文件解压的路径，该路径必须存在
group：解压后的目录或文件的属组
list_files：如果为yes，则会列出压缩包里的文件，默认为no，2.0版本新增的选项
mode：解压后文件的权限
src：源文件位置，如果copy为yes，则需要指定压缩文件的源路径
owner：解压后文件或目录的属主
15.register: 储存变量
16.meta: flush_handlers 在剧本中,定义的handlers会在所有task执行完成之后才被执行,使用meta选项,可以确定在合适的时间执行handlers
playbook剧本
ansible-playbook playbook
-i PATH：指定用户文件，默认/etc/ansible/hosts
-v：详细输出
-e "key=value"：定义变量
-f NUM：线程数，默认5
--check：检测模式，不真正执行
--skip-tags TAG_NAME：不执行这个tag的任务，可以写多个
--tags TAG_NAME：只执行这个tag的任务
--start-at-task TAG_NAME：从这个tag任务开始执行
组成结构：
Inventory：要执行的主机组
Modules：调用的模块
Commands：运行的命令
Playbooks：由以下组成
Tasks：任务，调用模块完成的操作
Variables：变量
Templates：模板
Handlers：处理器，由某事件
Roles：角色
例1：
- hosts: webservers
vars:
- user_name: xxx
remote_user: root
tasks:
- name: 条件判断
user: name={{ user_name }}
when: ansible_xxx == "xxxxx"
- name: 提示notify
service: name=httpd state=started
notify:
- 任务名称1
- 任务名称2
- name：模板
template: src=源文件路径 dest=目标路径
tags:
- 当前任务tag名称
- name：item测试
yum：name={{ item }} state=present
with_items:
- 软件名1
- 软件名2
handlers:
- name: 任务名称1
service: name=httpd state=restarted
- name: 任务名称2
service: name=httpd state=restarted
1.hosts：将要执行任务的主机，多个可以用冒号分割
2.vars：一些参数，后面可以通过{{ 参数 }}调用,
- 参数1：值
- 参数2：值
3.remote_user：由哪个用户执行
4.tasks：执行的任务
- name：任务的名称
模块名称： 参数（这里和命令行的参数一样）
notify：当前任务执行后要通知哪个任务要执行
- 通知任务名称1
- 通知任务名称2
when： 参数 == "值"，当满足条件时才执行。这里的参数可以通过ansible all -m setup参考;多个条件when: (参数=="值") or (参数==“值”)
- name： 任物的名称
template： 模板的源文件中必定包含带有{{ 参数 }}的地方，参数内容会被替换成vars中对应的值，同样可以在/etc/ansible/hosts文件中对应主机后面填写参数
tags：
- 当前任务的标签
5.handlers：通过tasks中的notify调用后才执行的任务，级别和tasks一样
- name：通知任务名称1
模块名称： 参数
- name：通知任务名称2
模块名称： 参数
6.with_items：分组变量，固定格式
在一个task中调用，例如创建多个用户
tasks: - name: 创建用户 user: name={{ item }} with_items: - user1 - user2
同时可以迭代操作
tasks: - name: 创建用户,并放到对应的组中 user: name={{ item.name }} group={{ item.group }} with_items: - {{ name: 'user1' , group: 'group1' }} - {{ name: 'user2' , group: 'group2' }}
7.playbook中变量使用{{ key }}，仅能由字母数字下划线组成，且只能以字母开头，变量来源如下
1.通过命令行，ansible-playbook -e key=value指定，优先级最高
2.在/etc/ansible/hosts里面指定
3.在playbook中指定
4.setup模块输出带有ansible_开头的值，例如ansible_ens160.ipv4.address
5.在独立的变量YAML文件中定义
6.在role中定义
gather_facts：默认会执行setup模块，如果不启用，setup模块的内容都不可使用
例2：批量安装zabbix客户端的yaml文件
--- - hosts: server remote_user: root vars: - server_ip: 192.168.159.128 tasks: - name: 复制软件包到被安装主机 copy: src=/root/ansible/packges/zabbix-agent.rpm dest=/root/zabbix-agent.rpm - name: 安装软件 yum: name=/root/zabbix-agent.rpm - name: 替换配置文件 template: src=/root/ansible/zabbix_agentd.conf dest=/etc/zabbix/zabbix_agentd.conf notify: - restart server - name: 启动服务 service: name=zabbix-agent state=started handlers: - name: restart server service: name=zabbix-agent state=restarted #zabbix-agent中的Hostname一项配置需要替换，每台主机都不一样，可以在ansible的主机清单中指定其配置 #zabbix-agent配置文件 [root@localhost ansible]# cat zabbix_agentd.conf PidFile=/var/run/zabbix/zabbix_agentd.pid LogFile=/var/log/zabbix/zabbix_agentd.log LogFileSize=0 Server=127.0.0.1,{{ server_ip }} ServerActive=127.0.0.1,{{ server_ip }} Hostname={{ zabbix_hostname }} Include=/etc/zabbix/zabbix_agentd.d/*.conf #ansible主机清单 [server] 192.168.159.129 zabbix_hostname=nginx 192.168.159.130 zabbix_hostname=httpd
roles：
- roles角色文件夹存放目录：配置文件中指定
[root@bogon ~]# grep roles_path /etc/ansible/ansible.cfg #roles_path = /etc/ansible/roles
- roles文件夹下创建对应role，每个role都需要有如下的文件夹
/etc/ansible/roles/
├── nginx
│ ├── default
│ │ └── main.yml
│ ├── files
│ ├── handlers
│ │ └── main.yml
│ ├── meta
│ │ └── main.yml
│ ├── tasks
│ │ └── main.yml
│ ├── templates
│ └── vars
│ └── main.yml
└── tomcat
├── default
│ └── main.yml
├── files
├── handlers
│ └── main.yml
├── meta
│ └── main.yml
├── tasks
│ └── main.yml
├── templates
└── vars
└── main.yml
#files：存放由copy或script模块调用的文件
#templates：存放由template模块调用的文件
#tasks：文件夹内创建main.yml文件，定义各种tasks，其他文件需要再此文件中通过include包含
#handlers：文件夹内创建main.yml文件，定义各种handlers，其他文件需要再此文件中通过include包含
#vars：文件夹内创建main.yml文件，定义变量，其他文件需要再此文件中通过include包含
#meta：文件夹内创建main.yml文件，定义依赖关系，其他文件需要再此文件中通过include包含
#default：文件夹内创建main.yml文件，定义默认变量
- 在roles文件夹外定义playbook，文件名为site.yml
---------------
今天公司在aws海外区域部署了一套服务,aws默认有个centos用户,可以sudo使用root命令,服务器上又建立了一个developer用户,用来跑程序,每个jar包都做成systemd服务.每次Jenkins上版需要使用两个用户,developr用来备份传送jar包,centos用户用来sudo重启服务.
1.首先需要在业务服务器上做centos和developer用户在ansible服务器的免密登录(没有想到别的办法)
2.在ansible服务器的hosts文件里面只写服务器地址,不要写用户和密码
[test-aws-hdd-01] 1.2.3.4 ansible_ssh_port=22222
3.ansible的playbook需要这样写就可以同时使用两个用户了
---
# 使用developer用户拷贝jar包
- name: copy jar to server for developer!
hosts: test-aws-hdd-01
remote_user: developer
gather_facts: no
tasks:
# 备份老的jar包
- name: archive JAR
archive:
path: /data/gateway/tst-cloud-server-gateway-1.0.jar
dest: /data/gateway/tst-cloud-server-gateway-1.0.jar.gz
# 传送新的jar包
- name: copy sechedule-JAR to server
copy:
src: /data/jenkins/workspace/2.0-altest-yicloud-gateway/tst-cloud-server-gateway/target/tst-cloud-server-gateway-1.0.jar
dest: /data/gateway/tst-cloud-server-gateway-1.0.jar
#owner: developer
#group: developer
# 使用centos用户登录,sudo重启服务
- name: restart gateway service
service: name=gateway state=restarted enabled=true
remote_user: centos
become: yes
become_user: root
become_method: sudo
ansible lookup插件:当我需要从文件中读取配置时使用,下面案例是向nacos中以接口的形式添加配置文件
post请求中如果想要把&当字符串使用,需要换成%26,要不会被转换成key=value
[root@localhost ~]# vim ansible-tst/roles/gateway/tasks/main.yaml
- name: nacos接口导入网关配置文件
uri:
url: http://127.0.0.1:8848/nacos/v1/cs/configs
method: POST
body: dataId=gateway&group=test&content="{{ lookup('template','tst-iot-server-gateway-product.yaml') }}"
#lookup后面有file或template很多插件,file和template对应两个相应的模块,后面跟的文件不需要传到对应服务器就在本机就行
[root@localhost ~]# ll ansible-tst/roles/gateway/templates/
总用量 8
-rw-r--r-- 1 root root 6380 6月 3 16:33 tst-iot-server-gateway-product.yaml
