📖 第26课：Ansible Playbook

阶段五：自动化第2/6课

一、Playbook基础

# site.yml
---
- name: 部署Web服务器
  hosts: webservers
  become: yes
  vars:
    nginx_port: 80
    doc_root: /var/www/html

  tasks:
    - name: 安装Nginx
      apt:
        name: nginx
        state: present
        update_cache: yes

    - name: 创建文档根目录
      file:
        path: "{{ doc_root }}"
        state: directory
        mode: '0755'

    - name: 复制配置文件
      template:
        src: nginx.conf.j2
        dest: /etc/nginx/sites-available/default
      notify: reload nginx

    - name: 启动Nginx
      service:
        name: nginx
        state: started
        enabled: yes

  handlers:
    - name: reload nginx
      service:
        name: nginx
        state: reloaded

二、变量与模板

# group_vars/webservers.yml
nginx_port: 8080
upstream_servers:
  - 192.168.1.10:3000
  - 192.168.1.11:3000

# templates/nginx.conf.j2
upstream backend {
{% for server in upstream_servers %}
    server {{ server }};
{% endfor %}
}

server {
    listen {{ nginx_port }};
    location / {
        proxy_pass http://backend;
    }
}

三、条件与循环

# 条件
- name: 仅在Ubuntu执行
  apt: name=nginx state=present
  when: ansible_os_family == "Debian"

# 循环
- name: 安装多个包
  apt: name="{{ item }}" state=present
  loop:
    - nginx
    - mysql-server
    - redis-server

# 注册变量
- name: 检查磁盘
  command: df -h /
  register: disk_info

- name: 磁盘警告
  debug: msg="磁盘空间不足!"
  when: disk_info.stdout.find('90%') != -1

四、Role角色

# 角色目录结构
roles/nginx/
├── tasks/main.yml
├── handlers/main.yml
├── templates/
├── files/
├── vars/main.yml
├── defaults/main.yml
└── meta/main.yml

# 使用角色
- name: 部署Web
  hosts: webservers
  roles:
    - nginx
    - mysql

五、练习

📝 编写Playbook

# deploy.yml - 部署应用
---
- name: 部署应用
  hosts: all
  become: yes
  tasks:
    - name: 创建应用目录
      file: path=/opt/myapp state=directory

    - name: 复制应用文件
      copy: src=app/ dest=/opt/myapp/

    - name: 安装依赖
      pip: requirements=/opt/myapp/requirements.txt

    - name: 启动应用
      service: name=myapp state=started

🏆

成就解锁：Playbook编写者

✅ 掌握Playbook结构

✅ 学会变量与模板

✅ 掌握条件与循环

✅ 了解Role组织

附录：Ansible Playbook学习资源

书名	作者	重点
Linux命令行与Shell脚本编程大全	Blum	Shell脚本全面覆盖
UNIX/Linux系统管理技术手册	Nemeth	系统管理圣经
Ansible: Up and Running	Lintner	Ansible实战
鸟哥的Linux私房菜	鸟哥	中文经典入门

在线资源

Linux man pages: man7.org
The Linux Documentation Project: tldp.org
ArchWiki: wiki.archlinux.org
Stack Overflow: stackoverflow.com/questions/tagged/linux
GitHub Awesome Lists: awesome-linux, awesome-shell

认证路径

认证	机构	级别
LFCS	Linux Foundation	基础系统管理
LFCE	Linux Foundation	高级系统工程师
RHCSA	Red Hat	Red Hat管理员
RHCE	Red Hat	Red Hat工程师
CKA/CKAD	CNCF	Kubernetes管理员/开发者

实践环境

Vagrant：快速创建多节点虚拟环境
Docker：容器化测试环境
Cloud Shell：AWS/Azure/GCP免费终端
Killercoda：在线Linux实验环境
OverTheWire：安全向Linux练习
Linux Journey：交互式学习平台

常用速查表

# 文本处理速查
grep -E 'pattern' file     # 扩展正则搜索
sed -i 's/old/new/g' file  # 替换
awk '{print $1}' file     # 提取列
sort | uniq -c | sort -rn   # 频次统计
cut -d: -f1 file            # 切列
tr 'A-Z' 'a-z'             # 转小写

# 系统管理速查
systemctl status/start/stop/restart service
journalctl -u service -f    # 跟踪日志
df -h / du -sh *            # 磁盘使用
ps aux --sort=-%mem         # 内存排序
ss -tlnp                    # 监听端口
iptables -L -n              # 防火墙规则
crontab -e                  # 编辑定时任务
useradd -m -s /bin/bash user # 创建用户

# 网络诊断速查
ip addr / ip route          # 网络配置
ping / traceroute           # 连通测试
dig / nslookup              # DNS查询
curl -I url                 # HTTP头检查
nc -zv host port            # 端口测试
tcpdump -i eth0 port 80     # 抓包

六、实机验证记录

$ ansible --version | head -1 2>/dev/null || echo '未安装'

ansible not installed

八、Playbook高级模式

# 异步执行长任务
- name: 长时间构建
  command: make build
  async: 3600
  poll: 30
  register: build_result

# block/rescue/always
- block:
    - command: deploy.sh
  rescue:
    - command: rollback.sh
  always:
    - command: cleanup.sh

# 标签选择执行
ansible-playbook site.yml --tags config
ansible-playbook site.yml --skip-tags install

专题：Playbook设计模式

在实际生产环境中，Playbook设计模式是系统管理员必须深入掌握的核心能力。本节将探讨常见场景、最佳实践和避坑指南。

常见问题与解决方案

问题1：脚本在生产环境运行异常

开发环境和生产环境的差异是脚本出错的常见原因。建议：

使用set -euo pipefail确保脚本安全执行
所有外部命令检查返回值
关键操作前确认（confirm机制）
完善日志记录，便于事后分析

问题2：性能不达预期

优化策略：

避免不必要的子Shell和管道
使用Bash内置操作替代外部命令
批量操作替代逐个操作
利用缓存和增量处理

问题3：可维护性差

改善方法：

函数化：将逻辑封装为函数
参数化：硬编码改为配置
文档化：每个函数添加注释
模块化：拆分为可复用模块

最佳实践总结

#!/bin/bash
# Playbook设计模式最佳实践模板
set -euo pipefail

# 1. 参数校验
[[ $# -lt 1 ]] && echo "Usage: $0 <arg>" >&2 && exit 1

# 2. 环境检查
require_cmd() {
    command -v "$1" >/dev/null || { echo "需要: $1" >&2; exit 1; }
}

# 3. 清理机制
TMPDIR=$(mktemp -d)
trap 'rm -rf "$TMPDIR"' EXIT

# 4. 日志记录
log() { echo "[$(date +%T)] $*"; }
err() { log "ERROR: $*" >&2; exit 1; }

# 5. 主逻辑
main() {
    log "开始处理: $1"
    # 业务逻辑
    log "处理完成"
}

main "$@"

进阶方向

深入学习Playbook设计模式的底层原理
阅读优秀开源项目的实现
编写自动化测试验证功能
在真实环境中积累经验
参与技术社区分享经验

延伸阅读：实用命令速查

# 文件操作
ls -la                    # 详细列表
find / -name "*.conf" 2>/dev/null  # 查找文件
ln -s target link         # 符号链接
du -sh * | sort -rh       # 目录大小排序

# 文本处理
grep -rn "pattern" dir/   # 递归搜索
sed -i.bak 's/old/new/g' f  # 备份替换
awk -F: '{print $1}' file  # 提取列
sort file | uniq -c        # 去重计数

# 系统管理
systemctl status/start/stop/restart service
journalctl -u service -f  # 实时日志
ps aux --sort=-%mem        # 内存排序
ss -tlnp                   # 监听端口
crontab -e                 # 定时任务

# 网络诊断
ip addr/route/show         # 网络配置
ping/traceroute            # 连通测试
dig/nslookup               # DNS查询
curl -I url                # HTTP检查
nc -zv host port           # 端口测试

# 磁盘管理
df -h                      # 磁盘使用
fdisk -l                   # 分区信息
mkfs.ext4 /dev/sdb1        # 格式化
mount /dev/sdb1 /mnt       # 挂载
blkid                      # UUID查看

总结

本章内容是Linux系统管理课程的重要组成部分。掌握这些知识需要大量的实践操作，建议在虚拟机或云服务器上反复练习。记住：纸上得来终觉浅，绝知此事要躬行。

在实际工作中，遇到问题时：

先看日志（journalctl/dmesg/var/log）
再查文档（man/info/--help）
然后搜索（Google/Stack Overflow）
最后实验（在测试环境验证）

常见问题FAQ

Q: 如何快速上手？

A: 从简单的Ad-hoc命令开始，逐步编写Playbook，最后组织为Role。在实践中学习最有效。

Q: 生产环境部署要注意什么？

A: 1)先在staging验证 2)使用--check预演 3)确保有回滚方案 4)监控部署后状态

Q: 如何处理部署失败？

A: 1)查看ansible日志定位失败任务 2)手动修复或回滚 3)修复Playbook 4)重新执行

Q: 如何保证幂等性？

A: 使用声明式模块(apt/yum/service/file)而非命令式(command/shell)。

Q: 如何管理敏感信息？

A: 使用Ansible Vault加密变量文件，密钥与代码分离存储。

关键概念速记

# 核心概念对照表
声明式 vs 命令式:
  声明式: 描述"要什么" → apt: name=nginx state=present
  命令式: 描述"做什么" → command: apt install nginx

幂等性: 同一操作执行多次，结果一致
  apt: name=nginx state=present  # 已安装则不操作
  command: apt install nginx     # 可能重复安装

收敛: 使系统达到期望状态的过程
  检测当前状态 → 计算差异 → 执行变更 → 验证结果

不可变基础设施:
  不修改运行中的系统，而是重建
  容器/AMI/镜像方式部署

本课程内容持续更新，欢迎反馈改进建议。掌握Linux系统管理需要持续学习和实践，祝你在运维之路上不断进步！🚀

← 上一课 📖 目录下一课 →