1、Ansible安装及Ansible各模块作用、使用方法

Ansible功能

1、批量执行远程命令,可以对远程的多台主机同时进行命令的执行 
2、批量安装和配置软件服务,可以对远程的多台主机进行自动化的方式配置和管理各种服务 
3、编排高级的企业级复杂的IT架构任务, Ansible的Playbook和role可以轻松实现大型的IT复杂架构 
4、提供自动化运维工具的开发API, 有很多运维工具,如jumpserver就是基于 ansible 实现自动化管理功能

Ansible架构

主机清单：Ansible管理主机的清单文件,默认为 /etc/ansible/hosts
调用模块：Ansible执行命令的功能模块,多数为内置核心模块,也可自定义
插件：模块功能的补充,如连接类型插件,循环插件,变量插件,过滤插件等,该功能不常用
API：供第三方程序调用的应用程序编程接口

Ansible安装

包安装：
apt -y install ansible  (ubuntu不支持用ansuble管理rokey系统)
yum -y install ansible

pip安装：
yum -y install python39 rust
pip3 install ansible

[root@ubuntu2004 ~]#ansible --version
ansible 2.9.6
  config file = /etc/ansible/ansible.cfg    #配置文件
  configured module search path = ['/root/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python3/dist-packages/ansible
  executable location = /usr/bin/ansible    #命令
  python version = 3.8.10 (default, Jun 22 2022, 20:18:18) [GCC 9.4.0] #python依赖版本

配置文件：/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                    #默认并发数
#sudo_user     = root                 #默认sudo 用户
#ask_sudo_pass = True                 #每次执行ansible命令是否询问ssh密码
#ask_pass     = True
#remote_port   = 22 
#host_key_checking = False#检查对应服务器的host_key,建议取消此行注释,实现第一次连 接自动信任目标主机 #log_path=/var/log/ansible.log        #日志文件,建议启用
#module_name = command                #默认模块,可以修改为shell模块

[privilege_escalation]                #普通用户提权配置
#become=True 
#become_method=sudo                  
#become_user=root 
#become_ask_pass=False

管理主机清单：

配置文件：/etc/ansible/ansible.cfg定义了主机清单存放文件
管理主机清单：/etc/ansible/hosts
[webservers]
10.0.0.101
10.0.0.102

[appservers]
10.0.0.8
10.0.0.18

管理之前需要打通guk验证，打通脚本

管理之前需要打通guk验证
ssh-keygen 生成公钥私钥对然后拷贝过去
也可用脚本直接生成公私钥然后推送推送
ubuntu使用脚本前安装sshpass
[root@ubunt ~]# apt -y install sshpass
[root@ubunt ~]# cat ssh_key.sh 
#!/bin/bash	
IPLIST="
10.0.0.101
10.0.0.102
10.0.0.8
10.0.0.18"

#rpm -q sshpass &> /dev/null || yum -y install sshpass   
[ -f /root/.ssh/id_rsa ] || ssh-keygen -f /root/.ssh/id_rsa  -P ''
export SSHPASS=centos1
for IP in $IPLIST;do
    { sshpass -e ssh-copy-id -o StrictHostKeyChecking=no $IP; } &
done 
wait
执行完脚本查看是否打通
[root@ubunt ~]# ssh 10.0.0.18
Last login: Sun Oct  2 14:31:00 2022 from 10.0.0.1

查看被管理机器

[root@ubunt ~]# ansible all --list-hosts  全部的
  hosts (4):
    10.0.0.101
    10.0.0.102
    10.0.0.8
    10.0.0.18
[root@ubunt ~]# ansible appservers --list-host  组的
  hosts (2):
    10.0.0.8
    10.0.0.18

Ansible常用模块（ansible-doc 模块名，可查模块使用方法）

https://docs.ansible.com/ansible/2.9/modules/modules_by_category.html

列出所有模块并统计数量 
[root@ubunt ~]# ansible-doc -l |wc -l

查看nginx相关模块
[root@ubunt ~]# ansible-doc -l |grep nginx
查看nginx状态页模块使用方法：
[root@ubunt ~]# ansible-doc nginx_status_info
简要使用方法
[root@ubunt ~]# ansible-doc -s nginx_status_info

1、ping模块

[root@ubunt ~]# ansible-doc -l |grep ping
用ping模块查看清单中被管理组的状态
如：[root@ubunt ~]# ansible webservers -m ping

2、command默认模块，允许后面加linux命令,可省略，但不支持通配符，可用shell模块带替,但都不支持幂等性

[root@ubunt ~]# ansible all -m command -a "sleep 100"

把默认模块设置成shell模块
vim /etc/ansible/ansible.cfg
module_name = shell

3、在远程主机上运行ansible服务器上的脚本script

script模块（在远程主机上运行ansible服务器上的脚本，不具备幂等性）
如：
[root@ubunt ~]# ansible all -m script -a 'test.sh'  #写完整脚本路径

4、复制ansible服务器主控端或远程主机的文件到远程主机 copy模块

copy模块
功能：1、把ansible服务器主控端文件复制到远程主机。2、把远程主机上的文件复制到远程主机
src：控制端的源文件路径
content：源文件的内容
dest：被控制端的文件路径
owner：属主
group：属组
mode：权限
backup：是否备份
remote_src： no是默认值，表示src文件在ansible主机，yes表示src文件在远程主机  #重要的指令

范例
#如目标存在,默认覆盖,此处指定先备（没有写remote_src，表明文件在ansible主控端） 
ansible webservers -m copy -a "src=/root/test1.sh dest=/tmp/test2.sh owner=wang mode=600 backup=yes" 
#指定内容,直接生成目标文件 
ansible webservers -m copy -a "content='fan 123456\nchao 654321\n' dest=/etc/rsync.pas owner=root group=root mode=0600"
#复制/etc目录自身,注意/etc/后面没有/ 
ansible webservers -m copy -a "src=/etc dest=/backup" 
#复制/etc/下的文件,不包括/etc/目录自身,注意/etc/后面有/ 
ansible webservers -m copy -a "src=/etc/ dest=/backup" 
#复制/etc/suders,并校验语法,下面的 %s 表示src指定的文件名 
ansible webservers -m copy -a "src=/etc/sudoers dest=/etc/sudoers.edit remote_src=yes validate='/usr/sbin/visudo -csf'%s"

5、用于将文件从http、https或ftp下载到被管理机节点上 get_url模块

get_url模块
功能：用于将文件从http、https或ftp下载到被管理机节点上

url   #下载文件的URL,支持HTTP,HTTPS或FTP协议 
dest  #下载到目标路径(绝对路径),如果目标是一个目录,就用原文件名,如果目标设置了名称就用目标 设置的名称 owner #指定属主 
group #指定属组 
mode  #指定权限 
force #如果yes,dest不是目录,将每次下载文件,如果内容改变替换文件.如果no,则只有在目标不存在 时才会下载 checksum  #对目标文件在下载后计算摘要,以确保其完整性         
#示例: checksum="sha256:D98291AC[...]B6DC7B97",
      checksum="sha256:http://example.com/path/sha256sum.txt" 
url_username #用于HTTP基本认证的用户名. 对于允许空密码的站点,此参数可以不使用 `url_password' url_password #用于HTTP基本认证的密码. 如果未指定`url_username'参数,则不会使用 `url_password'参数 
validate_certs #如果“no”,SSL证书将不会被验证. 适用于自签名证书在私有网站上使用 timeout  #URL请求的超时时间,秒为单位

范例
下载并MD5验证
ansible webservers -m get_url -a 'url=http://nginx.org/download/nginx-1.18.0.tar.gz dest=/usr/local/src/nginx.tar.gz checksum="md5:b2d33d24d89b8b1f87ff5d251aa27eb8"'

去webservers下的机器上去查看是否完成（下完不带版本号）
[root@ubuntu2004 ~]#ls /usr/local/src/
nginx.tar.gz

6、从被控制机上把文件拉到控制机上（不能拉文件夹，和copy相反）Fetch模块

Fetch模块
src      #被控制端的源文件路径,只支持文件 
dest     #ansible控制端的目录路径

范例1：ansible all -m fetch -a 'src=/etc/os-release dest=/data/os'（目录无需创建，自动生成）
范例2：打包 ansible all -a 'tar cf /root/etc.tar /etc'
拉到控制端  ansible all -m fetch -a 'src=/root/etc.tar dest=/data/'

7、修改文件属性，创建文件、目录和软链接等 file模块

file模块
path       #在被控端创建的路径 （和dest，name功能相同）
owner      #属主 
group      #属组 
mode       #权限 
recurse    #yes表示递归授权
state      #状态 
=touch     #创建文件
=directory #创建目录 
=link      #软链接 
=hard      #硬链接 
src        #创建软硬链接时，指定源文件
absent     #删除

范例：创建文件夹
[root@ubunt ~]# ansible all -m file -a 'path=/data/ state=directory'
创建文件（如果没有文件夹，会失败）
[root@ubunt ~]# ansible all -m file -a 'path=/data/test.txt state=touch'
创建软链接（对/etc/hosts创建软连接为/data/hosts.links）
[root@ubunt ~]# ansible all -m file -a 'src=/etc/hosts dest=/data/hosts.links state=link'
删除软链接
[root@ubunt ~]# ansible all -m file -a 'path=/data/hosts.links state=absent'

递归修改目录属性，但不递归至自目录
ansible all -m file -a "path=/data/mysql state=directory owner=mysql group=mysql"

递归修改目录及自目录的属性
ansible all -m file -a "path=/data/mysql state=directory owner=mysql group=mysql recurse=yes"

8、检查文件或文件系统的状态 stat模块

stat模块
path #文件/对象的完整路径（必须）

范例：ansible 127.0.0.1 -m stat -a 'path=/etc/passwd'

9、解包解压缩 unarchive模块

unarchive模块
将ansible主机上的压缩包传到远程主机后解压至特定目录，设置remote_src=no,此为默认值，可省略
将远程主机上或非ansible的其他主机的某个压缩包压缩到远程主机本机的指定路径下，需要设置remote_src=yes

remote_src #和copy功能一样且选项互斥,yes表示源文件在远程被控主机或其它非ansible的其它主机上如网上,no表示文件在ansible主机上,默认值为no, 此选项代替copy选项

copy #默认为yes,当copy=yes,拷贝的文件是从ansible主机复制到远程主机上,如果设置为copy=no, 会在远程主机上寻找src源文件,此选项已废弃 
src #源路径,可以是ansible主机上的路径,也可以是远程主机(被管理端或者第三方主机)上的路径,如果 是远程主机上的路径,则需要设置remote_src=yes 
dest #远程主机上的目标路径 
owner #默认递归 
group #默认递归 
mode  #设置解压缩后的文件权限,默认递归 
creates=/path/file #当绝对路径/path/file不存在时才会执行

范例：把互联网上的包直接下载解包（要求被控制端需要有账号，存放目录需提前存在）
ansible all -m unarchive -a 'src=https://nginx.org/download/nginx-1.20.2.tar.gz dest=/data remote_src=yes owner=wang group=wang'
[root@ubuntu2004 ~]#ls /data/
nginx-1.20.2  test.txt

10、打包压缩保存在被管理节点 Archive模块

Archive 模块
path    #需要压缩的文件或目录
dest    #压缩后的文件
format  #压缩格式，支持gz，bz2，xz，tar，zip

范例：
ansible webservers -m archive  -a 'path=/var/log/ dest=/data/log.tar.bz2 format=bz2 owner=wang mode=0600'

11、管理主机名 Hostname模块

Hostname 模块
name #修改后的主机名称

范例：
ansible 10.0.0.8 -m hostname -a 'name=web1'

12、计划任务 cron模块

cron 模块
支持时间：minute，hour，day，mouth，weekday
name      #描述脚本的作用 
minute    #分钟 
hour      #小时 
day       #日
mouth     #月
weekday   #周 
user      #任务由哪个用户运行；默认root 
job       #任务

范例：
备份数据库脚本（需要提前把脚本放在被管理机上）
[root@centos8 ~]#cat /root/mysql_backup.sh 
#!/bin/bash 
mysqldump -A -F --single-transaction --master-data=2 -q -uroot |gzip> /data/mysql_`date +%F_%T`. sql.gz 


创建任务
ansible 10.0.0.8 -m cron -a 'hour=2 minute=30 weekday=1-5 name="backup mysql" job=/root/mysql_backup.sh'
查看任务：
[root@RS1 ~]#crontab -l
#Ansible: backup mysql
30 2 * * 1-5 /root/mysql_backup.sh

禁用计划任务（disabled=yes，启用disabled=no，删除state=absent）
ansible 10.0.0.8 -m cron -a 'hour=2 minute=30 weekday=1-5 name="backup mysql"  job=/root/mysql_backup.sh disabled=yes'
[root@RS1 ~]#crontab -l
#Ansible: backup mysql
#30 2 * * 1-5 /root/mysql_backup.sh

13、软件管理包 yum和apt模块

yum和apt模块
name           #软件包名称 
state          #状态  
=present       #安装,此为默认值 
=absent        #删除  
=latest        #最新版 
list           #列出指定包 enablerepo #启用哪个仓库安装 
disablerepo    #不使用哪些仓库的包 
exclude        #排除指定的包 
validate       #是否检验,默认为yes

范例：
[root@ubunt ~]# ansible 10.0.0.102 -m apt -a 'name=apache2 state=present' #安装
[root@ubunt ~]# ansible 10.0.0.102 -m apt -a 'name=apache2 state=absent autoremove=yes purge=yes' #卸载

14、实现yum仓库配置管理 yum_repository模块

yum_repository 模块
name          #仓库id 
description   #仓库描述名称,对应配置文件中的name= 
baseurl       #仓库的地址 
gpgcheck      #验证开启 
gpgkey        #仓库公钥路径
state

范例：创建zabbix agent仓库
ansible 10.0.0.8 -m yum_repository -a 'name=zabbix description="zabbix repo" baseurl="https://mirrors.aliyun.com/zabbix/zabbix/6.0/rhel/$releasever/$basearch /" gpgcheck=no'

删除zabbix agent仓库
ansible 10.0.0.8 -m yum_repository -a 'name=zabbix state=absent'

15、管理服务service（与systemd功能相似）

name        #服务名称
state       #服务状态
=started    #启动
=stopped    #停止
=restarted  #重启
=reloaded   #重载
enabled     #开启自启动，yes开机启动，no开机不启动
daemon_reload   #加载新的配置文件，适用于systemd模块

范例：[root@ubunt ~]# ansible 10.0.0.8 -m service -a 'name=apache2 state=started' #启动
[root@ubunt ~]# ansible 10.0.0.102 -m apt -a 'name=apache2 enabled=yes' #开机启动

16、管理用户 user模块

user 模块
name              #创建的名称 
uid               #指定uid 
group             #指定基本组 
shell             #登录shell类型默认/bin/bash 
create_home       #是否创建家目录,默认会创建家目录,no不创建 
password          #设定对应的密码,必须是加密后的字符串才行,否则不生效 
system            #yes表示系统用户 
groups            #附加组 
append            #追加附加组使用,yes表示增加新的附加组 
state             #absen删除 
remove            #yes表示删除用户时将家目录一起删除 
generate_ssh_key  #创建私钥 
ssh_keyu_bits     #私钥位数 
ssh_key_file      #私钥文件路径

范例：
创建用户
[root@ubunt ~]# ansible all -m user -a 'name=nginx comment=nginx uid=88 group=nginx 
groups="root,daemon" shell=/sbin/nologin system=yes create_home=no home=/data/nginx non_unique=yes'
删除用户(#remove=yes表示删除用户及家目录等数据,默认remove=no)
[root@ubunt ~]# ansible all -m user -a 'name=nginx state=absent remove=yes'

17、管理组 group模块

group 模块
name      #指定组名称
gid       #指定gid
state
   =      #创建，默认
   =      #删除
system    #是否是系统组

范例：
创建组：
ansible all -m group -a 'name=nginx gid=88 system=yes'
删除组：
ansible all -m group -a 'name=nginx state=absent'

18、修改一行的文件内容 lineinfile模块（类似于sed）

path                      #被控端文件的路径 
regexp                    #正则匹配语法格式,表示被替换的内容 
line                      #替换为的内容 
state                     #absent表示删除 
insertafter insertbefore  #插入到替换内容后面,如和regexp同时存在,只在没找到与regexp匹配时才使用 
backrefs                  #支持后面引用,yes和no 
backup                    #修改前先备份 
create                    #如果文件不存在,则创建,默认不存在会出错
mode                      #指定权限 
owner                     #指定用户 
group                     #指定组

#注意 
regexp参数 ：使用正则表达式匹配对应的行,当替换文本时,如果有多行文本都能被匹配,则只有最后面被匹配到的那行文本才会被替换,当删除文本时,如果有多行文本都能被匹配,这么这些行都会被删除.

范例：
修改监听端口
ansible webservers -m lineinfile -a "path=/etc/httpd/conf/httpd.conf regexp='^Listen' line='Listen 8080'"

修改SELinux
ansible all -m lineinfile -a "path=/etc/selinux/config regexp='^SELINUX=' line='SELINUX=disabled'"

19、多行修改替换 replace模块

replace模块 基于正则进行匹配和替换

path            #被控端文件的路径 
regexp          #正则匹配语法格式,表示被替换的内容 
replace         #替换为的内容 
after           #插入到替换内容前面
before          #插入到替换内容后面 
backup          #修改前先备份 
mode            #指定权限 
owner           #指定用户 
group           #指定组

范例：
ansible all -m replace -a "path=/etc/fstab regexp='^(UUID.*)' replace='#\1'"   ansible all -m replace -a "path=/etc/fstab regexp='^#(UUID.*)' replace='\1'"

20、管理SELinux策略 cat /etc/selinux/config

三种状态 enforcing，开启安全加固策略。permissive，报警但不阻止。disabled，关闭

policy     #指定SELINUXTYPE=targeted
state      #指定SELINUX=disabled

范例：ansible 10.0.0.8 -m selinux -a 'state=disabled' 只支持修改成disabled策略

21、重启 reboot模块

reboot 模块
msg               #重启提示 
pre_reboot_delay  #重启前延迟时间的秒数 
post_reboot_delay #重启后延迟时间的秒数后,再验证系统正常启动
reboot_timeout    #重启后延迟时间再执行测试成功与否的命令
test_command      #执行测试成功与否的命令

范例：修改SELinux策略后重启
ansible 10.0.0.8 -m reboot

22、挂载和卸载系统 mount模块

mount 模块
src        #源设备路径,或网络地址 
path       #挂载至本地哪个路径下 
fstype     #设备类型； 
nfs opts   #挂载的选项 
state      #挂载还是卸载  
=present   #永久挂载,但没有立即生效  
=absent    #卸载临时挂载,并删除永久挂载  
=mounted   #永久和临时挂载  
=unmounted #临时卸载

范例

修改fstab文件永久挂载，但不会立即生效
mount webservers -m mount -a 'src="UUID=b3e48f45-f933-4c8e-a700-22a159ec9077" path=/home fstype=xfs opts=noatime state=present'

取消临时挂载
mount webservers -m mount -a 'path=/home fstype=xfs opts=noatime state=unmounted'

永久挂载，并立即生效
ansible webservers -m mount -a 'src=10.0.0.8:/data/wordpress path=/var/www/html/wp-content/uploads opts="_netdev" state=mounted'

永久挂载，并立即生效
ansible webservers -m mount -a 'src=10.0.0.8:/data/wordpress path=/var/www/html/wp-content/uploads fstype=nfs state=absent'

23、收集主机的系统信息，可用gather_facts:no来禁止Ansible收集facts信息

setup 模块

filter 指定过滤条件
范例
ansible all -m setup（默认收集所有信息）

ansible all -m setup -a 'filter=ansible_processor_vcpus' 只找出cpu
还可以取IP
ansible all -m setup -a 'filter=ansible_all_ipv4_addresses'

24、输出信息，并且通过msg定制输出信息内容，功能类似于echo命令

debug 模块

msg   #指定命令输出的信息
var   #指定变量名，和msg互斥
verbosity   #详细度

范例：没有指定命令输出的信息默认输出"Hello world"
ansible 10.0.0.8 -m debug

25、修改内核参数 sysctl 模块(内核优化)

sysctl 模块

name   #内核参数
value  #指定值
state  #是否保存在sysctl.conf文件中，默认present
sysctl_set  #使用sysctl -w验证值生效

范例：

26、管理资源限制 pam_limits模块

- name: Change Limit /etc/security/limit.conf
  pam_limits:
    domain: "*"
    limit_type: "{{ item.limit_type }}"
    limit_item: "{{ item.limit_item }}"
    value: "{{ item.value }}" 
  loop:
    - { limit_type: 'soft', limit_item: 'nofile',value: '100000' }
    - { limit_type: 'hard', limit_item: 'nofile',value: '10000' }