如何选对Ansible模块？copy、template、service等70+内置模块实战清单-酒店常州论坛

如何选对Ansible模块？copy、template、service等70+内置模块实战清单

【免费下载链接】ansibleAnsible is a radically simple IT automation platform that makes your applications and systems easier to deploy and maintain. Automate everything from code deployment to network configuration to cloud management, in a language that approaches plain English, using SSH, with no agents to install on remote systems. https://docs.ansible.com.项目地址: https://gitcode.com/GitHub_Trending/ans/ansible

Ansible 是一个 radically simple（极度简单）的 IT 自动化平台，通过 SSH 连接远程系统，无需安装任何 Agent，就能用接近英语的语言完成部署、配置和云管理。而它的核心战斗力，就藏在70+ 个内置模块里——学会选对 Ansible 模块（copy、template、service、command……），你的 Playbook 会事半功倍。本文给你一份完整的选型清单。

1 分钟了解：模块在哪里

所有内置模块源码都在 lib/ansible/modules/ 目录下，共 70 余个.py文件，每个文件即一个模块。想知道某个模块的参数和示例？无需翻文档，用命令直接查：

ansible-doc -l # 列出全部模块（按字母排序） ansible-doc copy # 查看 copy 模块的完整文档

💡 技巧：任务写法里的copy、template等"动作名"，其实就是模块名，一一对应。

📄 文件与配置类：copy 还是 template？

新手最纠结的一组。直接看结论：

模块	干什么	一句话选法
copy	把本地文件原样拷贝到远程	文件不需要变量替换→ copy
template	用 Jinja2 渲染模板后写到远程	文件含`{{ 变量 }}`→ template
lineinfile	保证某一行存在/被替换	只改一行配置
blockinfile	在标记块内插入/更新一段文本	改一段配置
replace	正则替换文件内容	批量替换字符串
assemble	把多个碎片文件拼成一个	分片组装配置
stat	获取文件属性（是否存在、大小、属主）	先探测再决策
file	管理文件属性：软链、目录、权限、删除	只动属性不动内容

实战口诀：整文件传输用copy，带变量渲染用template，改局部用lineinfile/blockinfile，查状态用stat。

⚡ 命令执行类：command、shell、raw 怎么选

模块	特点	适用场景
command	不经过 Shell，安全防注入	执行单条命令（首选）
shell	走`/bin/sh`，支持管道、`&&`	需要Shell 语法时
raw	直连执行，不依赖 Python	目标机器没装 Python时兜底
script	先传后执行本地脚本	在远程跑一段完整脚本
expect	交互式应答命令	处理交互式提示

⚠️ 注意：command/shell不识别changed，常配合creates/removes条件或changed_when使用，避免误报。

🛠 系统与包管理：service 及"三兄弟"

服务管理要看目标系统：

service：通用服务管理，跨平台默认选择
systemd / systemd_service：Systemd 专属，支持 unit、daemon-reload
sysvinit：老式 SysV init 系统

包管理同理，按发行版选：

模块	平台
apt / apt_repository / apt_key	Debian / Ubuntu
dnf / dnf5 / yum_repository	RHEL / CentOS 系
package	不想区分发行版时的通用兜底
pip	Python 依赖
unarchive	下载后解压 tar/zip 包

👤 账户、网络与状态类模块

user / group：管理用户与用户组
hostname：改主机名
iptables：防火墙规则
known_hosts：维护 SSH known_hosts
get_url：HTTP/HTTPS/FTP 下载文件
uri：请求 Web 服务 API
git / subversion：从代码仓库部署
wait_for / wait_for_connection：等待端口/服务就绪
cron：计划任务
reboot：重启机器并等待回来
tempfile：创建临时文件/目录

🎯 调试与流程控制模块

ping：连通性自检，新接机器必跑
debug：打印变量，排查问题第一站
assert：断言条件，不满足立即失败
fail：主动抛错并附带自定义消息
set_fact / include_vars：运行时设变量、加载变量文件
gather_facts / setup：收集主机事实
meta：执行refresh_inventory等控制动作
pause：暂停执行（人工确认、倒计时）
group_by / add_host：动态分组与加主机

编排类"静态导入 vs 动态包含"是常见考点：import_playbook/import_role/import_tasks解析期展开，include_role/include_tasks运行期加载，详见 lib/ansible/keyword_desc.yml 中的关键词说明。

📋 选模块速查表（建议收藏）

你的需求	首选模块
传一个固定文件	`copy`
传一个含变量的配置文件	`template`
改配置文件里的一行/一段	`lineinfile`/`blockinfile`
装软件包	`apt`/`dnf`/`package`
启动/重启服务	`service`（Systemd 用`systemd`）
跑一条命令	`command`（需要管道才用`shell`）
下载并解压	`get_url`+`unarchive`
建用户/组	`user`/`group`
等端口/服务可用	`wait_for`
排查问题	`ping`→`debug`→`assert`

🧩 模块之外的"插件宇宙"

Ansible 的能力不止于模块，同仓库还有配套插件可搭配使用：

过滤器lib/ansible/plugins/filter/：如to_json、regex_replace，用于变量加工
测试lib/ansible/plugins/test/：如defined、match，用于条件判断
查找器lib/ansible/plugins/lookup/：如env、file、password，用于取值
动作插件lib/ansible/plugins/action/：模块的执行引擎，一般无需直接关注

✅ 总结：4 步选出正确模块

先搜后写：ansible-doc -l | grep 关键词，避免重复造轮子
优先幂等模块：能用template/user/service就别用command，保证可重入
按平台选专用模块：apt之于 Debian、dnf之于 RHEL，跨平台时用package/service兜底
看源码文档：每个模块头部的 DOCUMENTATION 字符串（如 copy.py）就是最权威的参数说明

掌握这份清单后，面对新需求先问自己："这件事是不是已有内置模块？"——99% 的答案是"有"，这就是 Ansible 模块体系的优雅之处。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析