- name: Install and start Nginx #描述 Playbook 或任务的简短名称
hosts: web_servers #指定要执行任务的目标主机或主机组
become: yes #可选参数，用于指定是否以管理员权限执行任务及执行任务的用户。
tasks:
- name: Install Nginx
apt:
name: nginx
state: present
- name: Start Nginx service
service:
name: nginx
state: started

playbook基本格式及用法：

一、Playbook 基础结构

Playbook 由一个或多个 Play（剧本） 组成，每个 Play 定义了一组 主机 和 任务。基本框架如下：

---  # YAML 文件起始标记（必须存在）
- name: <Play 的名称>  # 描述性名称（建议明确任务目的，如 "Install Nginx"）
  hosts: <主机或主机组>  # 目标主机（必填）
  gather_facts: <是否收集主机信息>  # 可选（默认值为 yes）
  become: <是否提权>  # 可选（默认值为 no）
  vars:  # 定义变量（可选）
    - var1: value1
    - var2: value2
  tasks:  # 任务列表（必填）
    - name: <任务名称>  # 描述性名称（建议明确操作，如 "Install nginx package"）
      <模块名>:  # 模块名称（如 yum、apt、copy 等）
        <参数1>: value1  # 模块参数
        <参数2>: value2
      when: <条件判断>  # 条件执行（可选）
      tags: <标签>  # 标记任务（可选，用于选择性执行）
      register: <变量名>  # 注册任务结果到变量（可选）
  handlers:  # 处理程序（可选，用于响应 notify 事件）
    - name: <处理程序名称>
      <模块名>:  # 通常用于重启服务等操作
        <参数>: value
  roles:  # 引入角色（可选，用于模块化管理）
    - <角色名称>

二、关键组成部分详解

1. Play 级别参数

2. tasks 任务列表

任务是 Playbook 的核心，每个任务调用一个 Ansible 模块完成具体操作。

• 模块类型：
  • 核心模块：如 ping（测试连通性）、yum/apt（包管理）、service（服务管理）、copy（文件复制）等。
  • 扩展模块：如 git（代码拉取）、mysql_user（数据库用户管理）等。
• 关键参数：

  参数	说明	示例
  name	任务的描述性名称（必填，建议明确操作内容，如 "Create directory"）	name: "Create data directory"
  module	模块名称（必填，如 file、shell、template 等）	file: path=/data state=directory mode=0755
  when	条件判断（可选，支持 Jinja2 表达式）	when: ansible_os_family == 'Debian'
  tags	标记任务（可选，用于通过 --tags 或 --skip-tags 选择性执行）	tags: [install, web]
  register	注册任务结果到变量（可选，用于后续任务引用）	register: result <br> debug: var=result.stdout

3. handlers 处理程序

处理程序是被动触发的任务，通常用于重启服务、重载配置等操作，需配合 notify 触发。

tasks:
  - name: Update config file
    copy: src=nginx.conf dest=/etc/nginx/nginx.conf
    notify: Restart Nginx  # 触发名为 "Restart Nginx" 的处理程序

handlers:
  - name: Restart Nginx  # 处理程序名称需与 notify 一致
    service: name=nginx state=restarted

4. roles 角色

角色用于将 Playbook 拆分为模块化组件，提升复用性。

roles:
  - role: common  # 引用 roles/common 目录下的角色
    var1: value1  # 传递参数给角色
  - role: webserver
    port: 8080

三、Playbook 示例

以下是一个完整的 Playbook 示例，用于在 Debian 系统上安装 Nginx 并启动服务：

---
- name: Install and configure Nginx
  hosts: webservers
  gather_facts: yes
  become: yes
  vars:
    nginx_pkg: nginx
    nginx_port: 80

  tasks:
    - name: Ensure Nginx is installed
      apt:
        name: "{{ nginx_pkg }}"
        state: present
      when: ansible_os_family == 'Debian'

    - name: Copy Nginx config
      copy:
        src: nginx.conf.j2
        dest: /etc/nginx/nginx.conf
      notify: Reload Nginx

    - name: Ensure Nginx is running
      service:
        name: nginx
        state: started
        enabled: yes

  handlers:
    - name: Reload Nginx
      service:
        name: nginx
        state: reloaded

四、最佳实践

1. 命名规范：
   • Play 和任务名称应清晰描述操作（如 Install Docker Engine 而非 Task 1）。
2. 变量管理：
   • 复杂变量可通过 vars_files 引入外部 YAML 文件，避免 Playbook 臃肿。
3. 条件判断：
   • 使用 when 区分不同系统或环境（如 ansible_distribution == 'CentOS'）。
4. 错误处理：
   • 添加 ignore_errors: yes 忽略非关键错误，或 failed_when: condition 自定义失败条件。
5. 测试与调试：
   • 使用 --syntax-check 验证语法，-C（--check）模式试运行，-vvv 查看详细日志。

五、执行 Playbook

ansible-playbook -i inventory/hosts site.yml  # 标准执行
ansible-playbook -i inventory/hosts site.yml --tags="install"  # 仅执行标记为 install 的任务
ansible-playbook -i inventory/hosts site.yml --limit=webservers  # 仅对 webservers 组执行

通过以上结构和规范，可高效编写可维护、易扩展的自动化任务脚本。

安装

安装方法

1.通过包管理器安装

[root@ansible-controller ~]# apt install ansible -y

[root@ansible-controller ~]# dnf install ansible -y

[root@ansible-controller ~]# dnf install ansible-core -y

[root@ansible-controller ~]# ansible --version

[root@ansible-controller ~]# apt install python3 python3-pip -y

[root@ansible-controller ~]# sudo yum install python3 python3-pip -y

[root@free ~]# python
Python 3.9.18 (main, Sep  7 2023, 00:00:00) 
[GCC 11.4.1 20230605 (Red Hat 11.4.1-2)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> 


>>> exit
Use exit() or Ctrl-D (i.e. EOF) to exit

quit()也行

[root@ansible-controller ~]# pip3 install ansible

1. 什么是 EPEL？
全称：Extra Packages for Enterprise Linux（企业 Linux 额外软件包）
作用：由 Fedora 社区维护的第三方开源软件仓库，为 RHEL、CentOS、Rocky Linux 等系统提供大量 非官方默认源 的软件包（如开发工具、系统工具、库文件等）。
优势：补充官方源中缺失的软件，版本更新相对及时，方便用户快速安装常用工具。
2. epel-release 软件包的作用
功能：这个软件包是 EPEL 源的 安装器和配置文件，用于自动配置系统的软件源信息（如 /etc/yum.repos.d/epel.repo 或 /etc/dnf.repos.d/epel.repo）。
安装后效果：
启用 EPEL 源，允许使用 yum 或 dnf 命令直接安装 EPEL 中的软件包。
包含 GPG 密钥，确保软件包的完整性和安全性。




验证 EPEL 源是否启用
# 列出所有已启用的源
dnf repolist enabled

# 输出应包含类似内容：
# epel                Extra Packages for Enterprise Linux 9 - x86_64
三、使用 EPEL 源安装软件包
安装方式与官方源完全相同，直接使用 dnf 或 yum 命令：
# 示例：安装 htop（系统监控工具，官方源可能没有）
dnf install htop -y

# 示例：安装 ansible（自动化运维工具）
dnf install ansible -y

# 搜索 EPEL 源中的软件包
dnf search <关键词>
四、EPEL 源的配置与管理
1. 临时禁用 / 启用 EPEL 源
# 禁用 EPEL 源（本次命令生效）
dnf --disablerepo=epel install <软件包>

# 仅从 EPEL 源安装（忽略其他源）
dnf --enablerepo=epel install <软件包>
2. 永久禁用 EPEL 源
编辑配置文件，将 enabled=1 改为 enabled=0：
vi /etc/yum.repos.d/epel.repo

# 修改为：
[epel]
name=Extra Packages for Enterprise Linux 9 - $basearch
#baseurl=https://download.fedoraproject.org/pub/epel/9/$basearch
metalink=https://mirrors.fedoraproject.org/metalink?repo=epel-9&arch=$basearch
enabled=0  # 禁用 EPEL 源
gpgcheck=1
...

生成密钥对

[root@ansible-controller ~]# ssh-keygen -t rsa （三次回车，不输入其他信息）

# 执行命令后，输入正确密码即可
ssh-copy-id root@192.168.72.64
ssh-copy-id root@192.168.72.65

# 如果免密做成功则无需密码即可登录
ssh root@192.168.72.64
ssh root@192.168.72.65

https://docs.ansible.com/ansible/latest/inventory_guide/intro_inventory.
html

[server]
192.168.72.64
192.168.72.65
[db]
db1.example.com
db2.example.com

如果ip是连续的，还可以简写
[server]
192.168.72.[64:65]
[db]
db1.example.com
db2.example.com


1. 分组定义
[server] 和 [db] 是两个主机组（Group），用于将功能相似的主机归类。
组名可以自定义，通常根据主机角色（如 web、db）或环境（如 dev、prod）命名。
2. 主机列表
[server] 组：包含两个 IP 地址的主机：
192.168.72.64
192.168.72.65


[db] 组：包含两个域名的主机：
db1.example.com
db2.example.com

二、Ansible 如何使用这个清单？
当执行 Ansible 命令时，可以通过组名选择目标主机：
# 对 [server] 组中的所有主机执行 ping 模块
ansible server -m ping

# 对 [db] 组中的所有主机执行 shell 命令
ansible db -a "df -h"

[root@ansiblecontroller ~]# ansible -i my_inventory.yml server  -m ping
192.168.153.137 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/bin/python3"
    },
    "changed": false,
    "ping": "pong"
}
192.168.153.136 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/bin/python3"
    },
    "changed": false,
    "ping": "pong"
}
这里使用的是135,136,137的主机



-i 指定路径

server  根据清单指定主机组   也可以是具体ip，域名
特殊标识符：
all 或 *：表示清单中的所有主机。
多组组合：如 server:db（同时选择 server 和 db 组）。

-m  指定模块




其他常用参数（可选）
1. -u username
指定 SSH 连接的用户名。
bash
-u root  # 以 root 用户连接

2. -k
提示输入 SSH 密码（适用于密码认证，非密钥认证）。
bash
-k  # 执行后会提示输入密码

3. -K
提示输入 sudo 密码（用于需要管理员权限的操作）。
bash
-K  # 执行后会提示输入 sudo 密码


4. -vvv
开启详细模式（-v 越多，输出越详细），用于调试。
bash
-vvv  # 显示 SSH 连接过程、模块执行细节等


5. -a "参数"
传递模块的参数（仅对部分模块需要）。
bash
-m command -a "ls -l"  # 执行 ls -l 命令
-m copy -a "src=file.txt dest=/tmp/"  # 复制文件

[server]
192.168.72.64 ansible_user=root ansible_port=22
192.168.72.65 ansible_user=root
[db]
db1.example.com ansible_host=192.168.72.100
db2.example.com ansible_host=192.168.72.101 ansible_user=postgres

如果同一参数在多个地方定义，优先级从高到低为：
命令行参数（如 -u root）。
清单文件中的主机变量（如 192.168.1.1 ansible_user=root）。
清单文件中的组变量（如 [web_servers:vars] ansible_user=deploy）。
ansible.cfg 中的全局配置。

[prod_servers]
192.168.1.1 ansible_user=root

[dev_servers]
192.168.1.10 ansible_user=devops

[secure_servers]
192.168.1.20 ansible_port=5000

[databases]
db-prod ansible_host=10.0.0.5

[server]
192.168.72.64
192.168.72.65
[db]
db1.example.com
db2.example.com
[server:vars]
ansible_user=root
ansible_port=22
[db:vars]
ansible_user=postgres

配置好后可尝试用ping模块测试同上

示例：

invertory
├─ hosts
├─ main.yml
├─ group_vars
│ └─ server.yml

main.yml：
---
- name: test variable
  hosts: server  # 目标主机组（需与清单文件中的组名匹配）
  gather_facts: no  # 不收集主机信息（加快执行速度）
  tasks:
    - name: test vars
      debug:
        msg: "ansible_port = {{ ansible_port }}, ansible_user = {{ ansible_user }}"


hosts：
[server]
192.168.72.[136:137]

server.yml：
ansible_port: 22
ansible_user: root
ansile_password: '123456'

测试：
1.测试playbook
[root@ansiblecontroller ~]# ansible-playbook -i invetory/hosts.yml invetory/main.yml 

PLAY [test variable] *******************************************************************************************************************************

TASK [test vars] ***********************************************************************************************************************************
ok: [192.168.153.136] => {
    "msg": "ansible_port = 22, ansible_user = root"
}
ok: [192.168.153.137] => {
    "msg": "ansible_port = 22, ansible_user = root"
}

PLAY RECAP *****************************************************************************************************************************************
192.168.153.136            : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   
192.168.153.137            : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0 
2.测试连通性
[root@ansiblecontroller ~]# ansible -i invetory/hosts.yml all -m ping
192.168.153.136 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/bin/python3"
    },
    "changed": false,
    "ping": "pong"
}
192.168.153.137 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/bin/python3"
    },
    "changed": false,
    "ping": "pong"
}



main.yml
Playbook 分析
yaml
---
- name: test variable
  hosts: server  # 目标主机组（需与清单文件中的组名匹配）
  gather_facts: no  # 不收集主机信息（加快执行速度）
  tasks:
    - name: test vars
      debug:
        msg: "ansible_port = {{ ansible_port }}, ansible_user = {{ ansible_user }}"

这个 Playbook 的作用是：
针对 server 组的所有主机。
打印每个主机的 ansible_port 和 ansible_user 变量值。