# EPEL-release（Extra Packages for Enterprise Linux Release）‌是一个为企业级Linux发行版（如CentOS、RHEL等）提供额外软件包的软件仓库。通过EPEL-release，用户可以访问到由社区维护的众多软件包，这些软件包经过严格的测试和验证，确保其质量和稳定性‌
yum install epel-release 
yum install ansible  # 默认安装使用centos7系统自带python2, 需要使用python3的，建议使用pyhton3安装ansible

配置文件
    /etc/ansible/ansible.cfg  主配置文件,配置ansible工作特性(一般无需修改)
    /etc/ansible/hosts        主机清单(将被管理的主机放到此文件)
    /etc/ansible/roles/       存放角色的目录
 
程序
    /usr/bin/ansible          主程序，临时命令执行工具
    /usr/bin/ansible-doc      查看配置文档，模块功能查看工具
    /usr/bin/ansible-galaxy   下载/上传优秀代码或Roles模块的官网平台
    /usr/bin/ansible-playbook 定制自动化任务，编排剧本工具
    /usr/bin/ansible-pull     远程执行命令的工具
    /usr/bin/ansible-vault    文件加密工具
    /usr/bin/ansible-console  基于Console界面与用户交互的执行工具

# 安装EPEL
yum install epel-release 

# 安装pyhton3,推荐使用编辑指定安装路径安装python3，防止覆盖系统自带python2，centos7部分版本的yum依赖系统自带python2
推荐参考python3编译安装：https://wdsheng0i.github.io/dev-ops/2021/03/31/python.html

yum install python3-pip #直接在线安装python3、pip，如系统有python2可能会被覆盖

# 安装ansible
python3 -m pip install ansible==6.0 -i https://pypi.tuna.tsinghua.edu.cn/simple #指定ansible版本，指定pip源安装
# 安装最新版本 python3 -m pip install --user ansible
# 安装指定版本: python3 -m pip install --user ansible-core==2.12.3
# 升级 Ansible: python3 -m pip install --upgrade --user ansible 

Ansible 版本	最低 Python 版本要求	兼容性说明
Ansible 2.9	Python 2.7 / 3.5+	最后一个同时支持 Python 2 和 3 的版本。
Ansible 2.10+	Python 3.6+	官方停止对 Python 2 的支持。
Ansible 5.0+	Python 3.8+	社区版（原 ansible-base 分支）。
Ansible 6.0+	Python 3.9+	推荐使用最新稳定版 Python。
Ansible 7.0+	Python 3.10+	依赖现代 Python 特性。

# 生成默认配置文件
/usr/local/python3/bin/ansible-config init --disabled > ansible.cfg

# 修改配置项
host_key_checking=False

# 查看版本：ansible --version, 若没有系统命令，先查找ansible安装路径，然后创建系统命令软连接
find / -name "ansible"   #找到安装路径/usr/local/python3/bin/ansible
/usr/local/python3/bin/ansible --version   #可以查看ansible版本
ln -s /usr/local/python3/bin/ansible /usr/bin/ansible    #创建命令软连接
ln -s /usr/local/python3/bin/ansible-playbook /usr/bin/ansible-playbook
ln -s /usr/local/python3/bin/ansible-inventory /usr/bin/ansible-inventory

即可使用系统命令 ansible --version查看版本

# 切换到app用户
## CentOS
sudo yum install -y python3-pip sshpass 

# cd /home/app 导入安装清单
cat >> requirements.txt << EOF
ansible==2.9.20
cryptography==2.8
jinja2==2.11.3
netaddr==0.7.19
pbr==5.4.4
jmespath==0.9.5
ruamel.yaml==0.16.10
MarkupSafe==1.1.1
EOF

pip3 install -r requirements.txt
 
## 如果安装时报权限问题执行
sudo pip3 install -r requirements.txt
sudo chmod -R 777 /usr/local/lib/python3.6
sudo chmod -R 777 /usr/lib/python3.6

## 查看版本：ansible --version
 
# 在.ansible.cfg中设置主机免key检查
cat >> /home/app/.ansible.cfg << EOF
[defaults]
host_key_checking = False
EOF

# 1.不属于任何组的单独主机, 必须放在所有主机组的前面, 也就是必须位于文件最前方, 属于 all 组
blue.example.com
192.168.100.1

# 2.主机组 sretest 包含5个主机, 调用时可以通过组名匹配主机，连续主机可以用[start:end]表示
[sretest]
10.10.10.[1:5]

[sredev]
10.10.10.[6:7]

# 3. 组可以通过children包含添加子组，继承关系
[all_server]
[all_servers:children]
sredev
sretest

[sretest:vars]
ansible_ssh_port=22
ansible_ssh_user=app
ansible_ssh_pass=123321
ansible_sudo_pass=123321

基本语法：ansible PATTERN -i inventory -m moudle -a argument
  PATTERN : 资源匹配，可以是IP列表, 也可以是组名, 用来在 -i 参数的资产中匹配一部分, all 代表匹配所有
  -i : 指定Ansible的资产 , 即被管理主机 (也可以是文件名)
  -m : 指定要运行的模板 , 比如这里的 ping模块 和 copy模块
  -a : 指定模块的参数 , 如下示例中ping模块没有指定参数 , copy模块指定了 src 和 dest 参数
示例：
ansible all --list-hosts                    #仅列出“默认主机清单”中 所有主机host
ansible-inventory -i hosts --list           #列出主机host及主机链接信息，-i指定清单文件
ansible sretest -i hosts --list-hosts       #仅列出“默认主机清单”中 sretest组所有主机host，-i指定清单文件
ansible all -m ping                         #测试默认主机清单hosts中，所有主机是否通
ansible all -m ping --limit 10.10.10.1      #测试默认主机清单hosts中，只在一台机器上执行ping
ansible sretest -i hosts -m ping            #测试指定清单hosts，sretest组下的主机是否ping的通
ansible all -i 10.10.10.2,10.10.10.3 -m ping  # 默认使用ssh-key链接
ansible all -m ping -u bruce                #测试默认主机清单hosts中，使用用户bruce执行ping
ansible all -m ping -u bruce --become-user app  #测试默认主机清单hosts中，使用用户bruce执行ping，切用户
ansible all -m shell -a 'ip a'              #所有默认主机清单，所有主机上执行shell命令
ansible all -i 10.10.10.2,10.10.10.3 -m copy -a "src=/tmp/a.conf dest=/tmp/a.conf" 

ansible all -i hosts -a "echo 'hello world'"   #缺省command模块
ansible all -i hosts -m command -a "echo 'hello world'" 
ansible all -i hosts -m shell -a "echo 'hello world'" 

# 1.准备shell脚本
echo "touch /tmp/testfile" > /root/a.sh

# 2.分发并执行脚本
ansible webservers -i hosts -m script -a "/root/a.sh" 

# 3.查看结果
ansible all -i hosts -m shell -a "ls -l /tmp" 

# 复制本机/etc/hosts文件到被管理机的opt文件下
ansible all -i hosts -m copy -a "src=/etc/hosts dest=/opt"

# 复制本机/etc/hosts文件到被管理机的opt文件下 并根据情况备份文件(文件名+日期)
ansible all -i hosts -m copy -a "src=/root/hosts dest=/opt/hosts backup=yes"

# 复制本机/etc/hosts文件到被管理机的opt文件下 同时修改文件的用户及用户组)
ansible all -i hosts -m copy -a "src=/etc/hosts dest=/opt owner=nobody group=nobody" 

# 复制本机/etc/hosts文件到被管理机的opt文件下 同时对文件的权限进行设置
ansible all -i hosts -m copy -a "src=/etc/hosts dest=/opt/hosts mode=0755" 

# 安装一个软件包
ansible all -i hosts -m yum -a "name=nginx state=present"
ansible all -i hosts -m yum -a "name=nginx state=installed"
ansible all -i hosts -m yum -a "name=nginx state=latest"

# 检查是否安装
ansible all -i /etc/ansible/hosts -m shell -a "nginx -version" 

# 移除一个软件包
ansible all -i /etc/ansible/hosts -m yum -a "name=nginx state=absent"
ansible all -i /etc/ansible/hosts -m yum -a "name=nginx state=removed" 

# 安装一个软件包组
ansible all -i /etc/ansible/hosts -m yum -a "name='@Developmenttools' state=present"

# 重新加载 systemd
ansible all -i /etc/ansible/hosts -m systemd -a "daemon_reload=yes" 
# 启动 nginx
ansible all -i  /etc/ansible/hosts -m systemd -a "name=nginx state=started"
# 关闭 nginx
ansible all -i  /etc/ansible/hosts -m systemd -a "name=nginx state=stopped"

ansible all -i /etc/ansible/hosts -m group -a "name=mysql" 

# 生成加密密码/
pass=$(echo “LML123456” | openssl passwd -l -stdin)
# 查看
echo $pass

# 创建账号,设置密码
ansible all -i /etc/ansible/hosts -m user -a "name=foo password=${pass}"

# 创建账号,设置密码,改密钥类型
ansible all -i /etc/ansible/hosts -m user -a "name=Dragon password=${pass} ssh_key_type=ecdsa"

# 创建账号,设置密码,有效期,加组
ansible all -i /etc/ansible/hosts -m user -a "name=Cai password=${pass} group=db_admin append=yes"

# 创建一个文件
ansible all -i /etc/ansible/hosts -m file -a "path=/tmp/foo.conf state=touch"

# 改变文件所有者及权限
ansible all -i /etc/ansible/hosts -m file -a "path=/tmp/foo.conf owner=nobody group=nobody mode=0644"

# 创建一个软连接
ansible all -i /etc/ansible/hosts -m file -a "src=/tmp/foo.conf dest=/tmp/link.conf state=link"

# 创建一个目录
ansible all -i /etc/ansible/hosts -m file -a "path=/tmp/test_dir state=directory"

# 取消一个链接
ansible all -i /etc/ansible/hosts -m file -a "path=/tmp/link.conf state=absent"

# 删除一个文件
ansible all -i /etc/ansible/hosts -m file -a "path=/tmp/foo.conf state=absent"

# 创建一个 cron job 任务
[root@manager ~]# ansible all -i /etc/ansible/hosts -m cron -a "name=newJob minute='0' job='ls -alh > /dev/null'"

# 验证
[root@host1 ~]# crontab -l
#Ansible: newJob
0 * * * * ls -alh > /dev/null

# 删除一个 cron job 任务
[root@manager ~]# ansible all -i /etc/ansible/hosts -m cron -a "name=newJob state=absent"

# 直接打印一个变量 (-e 是传入变量)
ansible all -i /etc/ansible/hosts -m debug -a "var=role" -e "role=web"
# 打印带字符串的 变量
ansible all -i /etc/ansible/hosts -m debug -a "msg='role is '" -e "role=web"

# 1. 创建一个 hello_world.j2 文件
[root@manager ~]# cat hello_world.j2
Hello  !

# 2. 执行命令 , 并且设置变量 var 的值为 world
[root@manager ~]# ansible all -i /etc/ansible/hosts -m template -a "src=hello_world.j2 dest=/tmp/hello_world.world" -e "var=world"

# 3. 在被控主机上验证
Hello world !

# 删除被控节点文件里的某一条内容
[root@manager ~]# ansible all -i /etc/ansible/hosts -m lineinfile -a "path=/etc/sudoers regexp='^%wheel' state=absent"

# 关闭远程主机的selinux
[root@manager ~]# ansible all -i /etc/ansible/hosts -m lineinfile -a "path=/etc/selinux/config regexp='^SELINUX=' line='SELINUX=disabled' state=present"

# YAML 中的字符串可以不使用引号 , 即使里面存在空格的时候 , 当然使用单引号即双引号也没有错
this is a string
'this is a string'
"this is a string"
# YAML 中若一行写不下表达的内容 , 可以使用下面两种方法进行折行
long_line: |
	Example 1
	Example 2
	Example 3
#或
long_line: >
	Example 1
	Example 2
	Example 3

# 相当于 C语言 中的数组 
# 如何定义 : 以短横线开头 + 空格 + 具体的值
- red
- green
- blue

# 以上的值转为 python 的 List 会是这样的
# ['red', 'green', 'blue']

# 若熟悉 python 的话, 可以认为他就是 Python 中的 Dict
# 如何定义 : key + 冒号 + 空格 + 值 , 即 key: value
name: Using Ansible
code: D1234

class:
  - name: stu1
    num: 001
  - name: stu2
    num: 002
  - name: stu3
    num: 003
    
# 转换成 Python格式
# {'class': [{'name': '001', 'num': 1}, {'name': 'stu2', 'num': 2}, {'name': 'stu3', 'num': 3}]}

# 创建测试任务：vi test.yaml 
---
- name: My first play
  hosts: all
  remote_user: root
  tasks:
  - name: ls file
    command: ls /tmp
  - name: Ping my hosts
    ansible.builtin.ping:
  - name: Print message
    ansible.builtin.debug:
    msg: Hello world
  - name：copy_file
    copy: src=/var/log/yum.log dest=/tmp || /bin/true  #让ansible-playbook的某个模块报错也继续执行需要在模块后面加上 || /bin/true
 
# 执行 ansible-playbook -i hosts test.yaml

## 通过task安装Nginx，后调用handlers重启nginx服务
- hosts: local
  connection: local
  become: yes
  become_user: root
  tasks:
   - name: Install Nginx
     apt:
       name: nginx
       state: installed
       update_cache: true
     notify:
      - Start Nginx

  handlers:
   - name: Start Nginx
     service:
       name: nginx
       state: started

# 单步跟从调试 PlayBook
ansible-playbook myplaybook.yml --step

# 测试运行 PlayBook, 会执行完整个 PlayBook , 但是所有 Task 中的行为都不会在远程服务器上执行 , 所有执行都是模拟行为
ansible-playbook myplaybook.yml -C

ansible-playbook ttt.yaml --syntax-check        #检查yaml文件的语法是否正确
ansible-playbook ttt.yaml --list-task           #检查tasks任务
ansible-playbook ttt.yaml --list-hosts          #检查生效的主机
ansible-playbook ttt.yaml --start-at-task='abc' #指定从某个task开始运行

roles
  rolename（例如nginx_install）
    - files
    - handlers
    - meta
    - templates
    - tasks
    - vars

# 1.目录名称roles是一种惯例，在运行一个playbook时可以用来查找角色。该目录应该始终被命名roles，但并不强制
mkdir roles 

# 2.在roles目录中运行 ansible-galaxy init nginx_install 命令将创建新角色所需的目录和文件。
cd roles
ansible-galaxy init nginx_install

# 3.运行角色（Running the Role），需要先定义一个playbook任务的nginx_install.yml, 然后引入roles中的任务
vi nginx-install.yml

- hosts: ''
  gather_facts: true
  become: yes
  become_user: root
  become_method: sudo

  roles:
  - 'nginx_install'
  
# 4.执行 ansible-playbook -i hosts nginx_install.yml

dependencies:
  - { role: ssl }

# nginx安装任务示例
- name: Add Nginx Repository  # 1.添加nginx / stable库
  apt_repository:
    repo: ppa:nginx/stable
    state: present

- name: Install Nginx  # 2.安装并启动Nginx
  apt:
    pkg: nginx
    state: installed
    update_cache: true
  notify:
    - Start Nginx

- name: Add H5BP Config  # 3.添加H5BP配置文件
  copy:
    src: h5bp
    dest: /etc/nginx
    owner: root
    group: root

- name: Disable Default Site Configuration  # 4.从sites-enabled目录中删除文件的符号链接来禁用默认的Nginx配置
  file:
    dest: /etc/nginx/sites-enabled/default
    state: absent

# `dest` in quotes as a variable is used!
- name: Add SFH Site Config  # 5.将serversforhackers.com.conf.j2虚拟主机模板复制到Nginx配置中，渲染模板
  register: sfhconfig
  template:
    src: serversforhackers.com.j2
    dest: '/etc/nginx/sites-available/.conf' 
    owner: root
    group: root

# `src`/`dest` in quotes as a variable is used!
- name: Enable SFH Site Config   # 6.通过将其符号链接到sites-enabled目录来启用Nginx服务器配置
  file:
    src: '/etc/nginx/sites-available/.conf'
    dest: '/etc/nginx/sites-enabled/.conf'
    state: link

# `dest` in quotes as a variable is used!
- name: Create Web root  # 7.创建Web根目录
  file:
    dest: '/var/www//public'
    mode: 775
    state: directory
    owner: www-data
    group: www-data
  notify:
    - Reload Nginx

# `dest` in quotes as a variable is used!
- name: Web Root Permissions   # 8.更改项目根目录的权限（递归），该目录位于之前创建的Web根目录之上
  file:
   dest: '/var/www/'
   mode: 775
   state: directory
   owner: www-data
   group: www-data
   recurse: yes
  notify:
    - Reload Nginx

ansible-vault create    # 创建一个新文件并进行加密
ansible-vault edit      # 编辑已经存在的加密文件
ansible-vault decrypt   # 从加密文件创建明文文件
ansible-vault encrypt   # 加密现有的纯文本文件
ansible-vault rekey     # 在加密文件中设置新密码

# 传普通的 key-value 模式, 输出变量
[root@manager ~]# ansible all -i /etc/ansible/hosts -m debug -a "var=name" -e "name='testname2'"
10.10.10.1 | SUCCESS => {
    "name": "testname2"
}
# 传普通的 key-value 模式, 拼字符串输出
[root@manager ~]# ansible all -i /etc/ansible/hosts -m debug -a "msg='name is '" -e "key='testname'"
10.10.10.1 | SUCCESS => {
"msg": "name is testname"
}

# 传文件，指定时必须加 @
[root@manager ~]# cat a.json
{"name": "zhansan", "age": "16"}

[root@manager ~]# ansible webservers -i /etc/ansible/hosts -m debug -a "msg='name is  , age is '" -e @a.json
[WARNING]: Found variable using reserved name: name
10.10.10.1 | SUCCESS => {
"msg": "name is zhansan , age is 16"
}


[root@manager ~]# cat b.yaml
---
name: lisi
age: 33
...
[root@manager ~]# ansible webservers -i /etc/ansible/hosts -m debug -a "msg='name is  , age is '" -e @b.yaml
[WARNING]: Found variable using reserved name: name
10.10.10.1 | SUCCESS => {
"msg": "name is lisi , age is 33"
}

# 通过 PLAY 属性 vars 定义key:value
- name: test play vars
  hosts: all
  vars: 
    user: lisi
    home: /home/lisi

# 通过 PLAY 属性 vars_file引用变量文件
- name: test play vars
  hosts: all
  vars_files: 
    - vars/users.yaml
    
# vi  vars/users/yaml
user: lilei
home: /home/lilei 

- name: Test Vars using in playbook
  hosts: all
  vars: 
    user: lisi
    home: /home/lisi
  tasks: 
    - name: create the users 
      user: 
        name: ""
        home: ""