devops-exercises 仓库 Ansible 实战:使用 apt 模块一键完成 update 与 upgrade 任务
devops-exercises 仓库 Ansible 实战:使用 apt 模块一键完成 update 与 upgrade 任务
导读
本文围绕开源仓库 devops-exercises 中 Update and Upgrade APT packages 练习 及其 参考答案 展开,逐行解析一个最小但完整的 Ansible apt 任务:如何以 root 权限刷新软件包索引并升级全部软件包。读完本文,你将掌握 apt 模块核心参数(update_cache、upgrade 等)的语义与搭配、become 特权提升的作用、该任务如何嵌入完整 Playbook 并配合 inventory 在远程主机上运行,以及如何借助仓库内其他 Ansible 练习(Task、Playbook、变量)举一反三,写出真正可复用、可验证的包管理自动化。
练习背景:仓库里的 Ansible 任务训练序列
在 devops-exercises 仓库中,Ansible 主题被组织为"练习题目 + 参考答案"双文件结构,全部索引位于 topics/ansible/README.md。其中任务(Task)类练习共三个,形成由浅入深的训练序列:
| 练习 | 文件(题目 / 答案) | 训练点 |
|---|---|---|
| My First Task | my_first_task.md / solutions/my_first_task.md | 用 file 模块创建目录 |
| Update and Upgrade Task | update_upgrade_task.md / solutions/update_upgrade_task.md | 用 apt 模块更新并升级软件包 |
| My First Playbook | my_first_playbook.md / solutions/my_first_playbook.md | 把多个任务组装成 Playbook 并在远程主机运行 |
本次练习的题目非常简洁:"Write a task to update and upgrade apt packages"——写一个任务来更新并升级 APT 软件包。虽然题干只有一句话,但它精准地指向了 Linux 运维中最常见的日常操作:apt update + apt upgrade,而参考答案则展示了如何用一条 Ansible 任务同时完成这两件事。
参考答案逐行解析
仓库给出的标准答案位于 topics/ansible/solutions/update_upgrade_task.md:
- name: "update and upgrade apt packages."
become: yes
apt:
upgrade: yes
update_cache: yes
这段 YAML 虽然只有五行,却包含了 Ansible 任务(Task)的全部关键要素,逐行拆解如下。
第 1 行:name —— 可读性即可维护性
- name: 声明了任务的名称,Ansible 在执行时会把该名称打印在输出中(TASK <a href="https://link.gitcode.com/i/26f9770bd1fa82a70616eb3072faee8f" target="_blank">update and upgrade apt packages.])。命名规范直接影响排障体验:当 Playbook 有几十个任务时,只有清晰的名称才能快速定位失败点。仓库中的其他练习同样遵循这一惯例,例如 [My First Task 的答案 使用 - name: Create a new directory,My First Playbook 的答案 使用 - name: Install zlib、- name: Create the file /tmp/some_file,命名风格完全一致。
第 2 行:become: yes —— 特权提升
become: yes 让该任务以特权用户(默认 root)身份执行。这是本任务必不可少的一行:更新软件包索引和升级软件包都会写入 /var/lib/apt/lists/、/var/lib/dpkg/ 等系统目录,普通用户没有写权限。若去掉这一行,任务会在连接远程主机后因权限不足而失败。become 是 Ansible 面向"过程式、可变基础设施"的体现之一(参见 topics/ansible/README.md 中对 Ansible 范式的自评题目),它等价于传统 shell 中的 sudo,但以声明式关键字内嵌于任务中,无需手工交互密码。
第 3 行:apt: —— 模块调用
apt 是 Ansible 内置的 APT 包管理模块,专门用于 Debian/Ubuntu 系发行版(对应 .deb 包)。在仓库的 Ansible 自评部分 中明确给出定义:Task 是对某个具体 Ansible 模块的调用("Task – a call to a specific Ansible module"),而模块才是 Ansible 真正在主机上执行的代码单元。因此本练习本质上就是在训练"如何正确调用一个模块"这一 Ansible 最核心的抽象。
第 4-5 行:upgrade: yes 与 update_cache: yes —— 两个标志的语义
参考答案的精髓在于 upgrade 与 update_cache 两个参数的组合:
update_cache: yes:等价于命令行apt-get update,在执行升级前刷新软件包索引(即/var/lib/apt/lists/中的源列表缓存)。没有这一步,apt 可能拿到过期的软件包版本信息,甚至因索引缺失而报错。upgrade: yes:等价于apt-get upgrade,将已安装的软件包升级到软件源中的最新可用版本。
两者配合的效果,正是把日常手动执行的两条命令 apt-get update && apt-get upgrade -y 收敛进一条声明式任务,且不需要 -y——Ansible 的 apt 模块会以非交互方式处理确认,这是与 shell 命令的关键差异之一。
深入 apt 模块:让"升级任务"更贴近生产实践
参考答案是追求"正确且最小"的标准解法。但在真实生产环境中,围绕同样的主题,apt 模块还提供了若干值得掌握的参数。以下均以本任务为骨架扩展说明(注意:参数行为以 Ansible apt 模块的通用语义为准,实际效果取决于目标主机的 Ansible 版本与发行版)。
缓存刷新相关的实用组合
- name: "update and upgrade apt packages."
become: yes
apt:
upgrade: yes
update_cache: yes
cache_valid_time: 3600
cache_valid_time(单位:秒)用于控制"何时才真正刷新缓存":若上次刷新发生在该时间窗口内,则跳过 update。它解决了"每次运行都刷新索引导致 Playbook 变慢"的痛点,适合在频繁运行的 Playbook 中避免无谓的网络请求。
区分升级范围:upgrade 的取值
upgrade 参数除 yes 外还可取其他值,从而控制升级粒度:
yes/safe:安全升级(apt-get upgrade),不涉及移除或安装新包;full:完整升级(apt-get dist-upgrade),允许安装新依赖或移除冲突包,升级更彻底;dist:发行版整体升级(apt-get dist-upgrade的另一种表述),常用于跨版本升级场景。
若 upgrade 缺省且未搭配其他参数,模块只执行包安装/移除类操作,不会触碰升级逻辑——因此在做"系统级补丁"类自动化时,显式写出 upgrade: yes 是必须的。
保持系统清洁:autoremove
apt:
upgrade: yes
update_cache: yes
autoremove: yes
autoremove: yes 在升级后自动清除不再被任何软件包依赖的孤立包(对应 apt-get autoremove),可防止升级过程中残留无用依赖,是长期运维中防止磁盘与依赖库膨胀的有效手段。
指定安装与状态控制(与本练习对照)
apt 模块最常见的基础用法其实是安装/卸载指定包并声明期望状态:
- name: Install zlib
apt:
name: zlib
state: present # present / latest / absent
这与仓库 My First Playbook 的答案 中 package: 模块的用法一一对应(package 是跨发行版的抽象层,apt 是 Debian 系的具体实现)。state 的取值语义如下:
| state | 含义 | 等价命令 |
|---|---|---|
present |
确保已安装(不升级) | apt-get install |
latest |
确保安装且为最新版 | apt-get install --only-upgrade |
absent |
确保已移除 | apt-get remove |
理解这一组参数后,就能把本练习的"整体升级"与"单包管理"统一到同一个模块的心智模型里。
从 Task 到 Playbook:在远程主机上真正跑起来
仅写一条任务还不足以在机器上执行——Ansible 的任务必须承载在 Play 与 Playbook 中,并配以 inventory(主机清单)才能运行。结合仓库 My First Playbook 的答案,可以把本练习的答案完整封装成一个可运行的 Playbook:
---
- name: "Update and upgrade apt packages on all hosts"
hosts: all
tasks:
- name: "update and upgrade apt packages."
become: yes
apt:
upgrade: yes
update_cache: yes
运行方式与仓库 My First Playbook 答案 中演示的流程一致:
- 编写 Playbook 文件(例如
vi update_apt.yml); - 编辑 inventory 文件(例如
/etc/ansible/hosts),声明目标主机:
[all]
192.168.1.10
some.remoted.host.com
- 执行:
ansible-playbook update_apt.yml
执行过程中,Ansible 会先输出任务名 TASK [update and upgrade apt packages.],随后显示每个主机的执行状态(ok / changed / failed),这正是第 1 行 name 的价值所在。另外注意:在 My First Playbook 答案 中,become: yes 被写在了任务级(Install zlib 内部),而在本文示例中写法等价——become 既可以写在任务内,也可以写在 Play 级统一作用于所有任务,后者更适合"整批主机都要提权"的场景。
幂等性:为什么这个任务可以反复执行
本练习的答案之所以值得作为"标准答案"收录,还因为它是幂等的:同一 Playbook 对同一主机重复执行,第二次运行时各任务会返回 ok(无变更)而不是 changed。apt 模块会比对软件包状态与声明状态("当前已是最新则不做任何事"),这与仓库 topics/ansible/README.md 中讨论的 Ansible 特点直接呼应——Ansible 遵循"可变基础设施"范式(mutable infrastructure),靠模块自身的状态检测来避免重复劳动与配置漂移(configuration drift)。与 shell/command 模块(盲目执行命令、不做状态判断)相比,使用 apt 这类专属模块正是 Ansible 最佳实践的第一课。
在仓库中的延伸:把包管理与系统操作组合成完整 Playbook
掌握了本练习后,可以沿着仓库的训练路径继续进阶:
- 用 My First Task 掌握
file模块创建目录/文件(state: directory/state: touch); - 用 My First Playbook 学会把多个任务组装进一个 Play 并在远程主机运行;
- 回到 topics/ansible/README.md 的自评题目,深化对 Task、Module、Play、Playbook、Inventory、Role 等概念之间关系的理解(例如"Task 是模块调用,Playbook 是一个或多个 Play,每个 Play 由若干任务组成并作用于指定 hosts")。
一个常见的综合场景是把"更新并升级软件包"作为系统初始化 Playbook 的第一项任务,其后紧跟 file 创建应用目录、template 渲染配置文件等步骤——本练习正是这条自动化链路的起点。参照仓库 My First Playbook 答案 的完整示例,可自行扩展出"升级 + 创建目录 + 写入文件"的复合 Playbook,从而完成从单任务到完整自动化的实战闭环。