基础设施即代码 / 知识点

Ansible 常用模块速查

用户与权限

CODE
ansible <host-pattern> -m ansible.posix.authorized_key -a 'user=<user> key=<key>'

维护用户的 authorized_keys 内容;适合批量下发运维或部署公钥,实施前应确认 collection 已安装且用户家目录可写。

配置 SSH 公钥

需要批量为远程用户加入或维护 SSH 公钥时使用 ansible.posix.authorized_key。模块会按声明管理 authorized_keys 中的密钥,适合替代逐台登录后手工追加。

使用前确认

该模块属于 ansible.posix collection,不是 ansible-core 自带模块。先在控制端确认 collection 可用,并确认目标用户已经存在、Ansible 连接账号有权修改其授权密钥文件。

bash
ansible-galaxy collection list ansible.posix

预期结果:列表中能找到 ansible.posix 及其已安装版本;具体版本号和安装路径因环境而异。若没有结果,可按项目锁定的版本要求安装对应 collection。

基本语法

bash
ansible <host-pattern> -m ansible.posix.authorized_key -a 'user=<user> key=<key>'
  • user:接收公钥的远程用户,必须是目标主机上的有效账号。
  • key:要写入的完整 SSH 公钥文本,例如以 ssh-ed25519 开头的公钥。
  • state=present:确保指定公钥存在;这是常见的下发方式。
  • state=absent:删除匹配的公钥,撤销访问时使用。

下发并验证公钥

下面使用示例公钥演示幂等写入。实际使用时应替换为真实公钥;示例中的密钥内容仅用于展示参数格式。

bash
ansible all -m ansible.posix.authorized_key -a 'user=deploy state=present key="ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIDemoKeyForDocumentationOnly deploy@example"'

预期输出:成功主机会返回 SUCCESS;首次加入通常显示 changed: true,相同密钥再次执行通常显示 changed: false。返回 JSON 的具体字段顺序和附加字段可能随 Ansible 版本变化。

可进一步检查远程文件是否包含对应公钥:

bash
ansible all -m ansible.builtin.shell -a 'grep -F "AAAAC3NzaC1lZDI1NTE5AAAAIDemoKeyForDocumentationOnly" ~/.ssh/authorized_keys'

预期输出:目标用户上下文正确时会显示匹配的公钥行;若 Ansible 当前连接用户与 deploy 不同,应改为检查 deploy 实际的 authorized_keys 路径,并确保具备读取权限。

风险与恢复

批量替换或删除公钥可能导致 SSH 访问中断。修改前应保留至少一种已验证的管理通道,不要在尚未验证新密钥可登录时移除旧密钥。

需要撤销本次加入的密钥时,用完全匹配的公钥配合 state=absent 删除,再验证仍保留预期的管理密钥。若目标用户家目录、.ssh 或 authorized_keys 不可写,应先修复用户、权限或提权配置,而不是反复执行模块。

网络与远程资源

部署与交付

检查与排障

系统资源

目录与阅读设置

记录一个想法

Ansible 常用模块速查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通