Ansible 自动化命令 100 条

DBA100

100 条命令系列文章专栏

Ansible 自动化命令 100 条

本文整理 ansible-core 常用的 100 条清单、Ad-hoc、Playbook、变量、Vault、Role、Galaxy、性能和排障命令。示例清单为 inventory.ini，生产环境应固定 Collection 版本，敏感变量使用 Vault 或外部密钥系统。

2026年8月19日阅读—点赞—收藏—

dba100ansible墨力计划

前言

本文整理 ansible-core 常用的 100 条清单、Ad-hoc、Playbook、变量、Vault、Role、Galaxy、性能和排障命令。示例清单为 inventory.ini，生产环境应固定 Collection 版本，敏感变量使用 Vault 或外部密钥系统。

一、版本、配置与帮助

1. 查看 Ansible 版本

Bash

1ansible --version

2. 查看当前配置

Bash

1ansible-config dump --only-changed

3. 查看全部配置项

Bash

1ansible-config list

4. 查看配置文件

Bash

1ansible-config view

5. 初始化配置模板

Bash

1ansible-config init --disabled > ansible.cfg

6. 查看模块文档

Bash

1ansible-doc ansible.builtin.copy

7. 列出模块

Bash

1ansible-doc -l

8. 查看模块示例

Bash

1ansible-doc -s ansible.builtin.user

9. 列出插件

Bash

1ansible-doc -t lookup -l

10. 查看清单工具帮助

Bash

1ansible-inventory --help

二、Inventory 管理

11. 列出所有主机

Bash

1ansible-inventory -i inventory.ini --list

12. 输出主机图

Bash

1ansible-inventory -i inventory.ini --graph

13. 查看主机变量

Bash

1ansible-inventory -i inventory.ini --host web1

14. 校验清单解析

Bash

1ansible-inventory -i inventory.ini --list >/dev/null

15. 使用 YAML 清单

Bash

1ansible-inventory -i inventory.yml --graph

16. 指定多个清单

Bash

1ansible-inventory -i inventory/base -i inventory/prod --graph

17. 使用临时主机清单

Bash

1ansible all -i '192.0.2.10,' -m ping

18. 只匹配 Web 组

Bash

1ansible 'web' -i inventory.ini --list-hosts

19. 排除主机

Bash

1ansible 'all:!db' -i inventory.ini --list-hosts

20. 取两个组交集

Bash

1ansible 'web:&prod' -i inventory.ini --list-hosts

三、连接与事实

21. 测试连通性

Bash

1ansible all -i inventory.ini -m ansible.builtin.ping

22. 指定远程用户

Bash

1ansible all -i inventory.ini -u ops -m ping

23. 指定 SSH 私钥

Bash

1ansible all -i inventory.ini --private-key ~/.ssh/id_ed25519 -m ping

24. 使用 become

Bash

1ansible all -i inventory.ini -b -m command -a 'id'

25. 指定 become 用户

Bash

1ansible all -i inventory.ini -b --become-user=root -m command -a 'id'

26. 收集全部事实

Bash

1ansible web -i inventory.ini -m ansible.builtin.setup

27. 筛选事实

Bash

1ansible web -i inventory.ini -m setup -a 'filter=ansible_distribution*'

28. 查看默认 IPv4

Bash

1ansible web -i inventory.ini -m setup -a 'filter=ansible_default_ipv4'

29. 设置连接超时

Bash

1ansible all -i inventory.ini -T 10 -m ping

30. 详细调试连接

Bash

1ansible web1 -i inventory.ini -m ping -vvvv

四、常用 Ad-hoc

31. 执行安全命令

Bash

1ansible web -i inventory.ini -m ansible.builtin.command -a 'uptime'

32. 执行 Shell 管道

Bash

1ansible web -i inventory.ini -m ansible.builtin.shell -a 'ps -ef | wc -l'

33. 复制文件

Bash

1ansible web -i inventory.ini -m ansible.builtin.copy -a 'src=app.conf dest=/etc/app/app.conf mode=0640' -b

34. 获取远程文件

Bash

1ansible web -i inventory.ini -m ansible.builtin.fetch -a 'src=/var/log/app.log dest=artifacts/ flat=no'

35. 创建目录

Bash

1ansible web -i inventory.ini -m ansible.builtin.file -a 'path=/opt/app state=directory owner=app mode=0750' -b

36. 安装软件包

Bash

1ansible web -i inventory.ini -m ansible.builtin.package -a 'name=nginx state=present' -b

37. 启动服务

Bash

1ansible web -i inventory.ini -m ansible.builtin.service -a 'name=nginx state=started enabled=true' -b

38. 创建用户

Bash

1ansible all -i inventory.ini -m ansible.builtin.user -a 'name=app shell=/bin/bash state=present' -b

39. 等待端口

Bash

1ansible web -i inventory.ini -m ansible.builtin.wait_for -a 'host=0.0.0.0 port=80 timeout=30'

40. 查看磁盘

Bash

1ansible all -i inventory.ini -m command -a 'df -hT'

五、Playbook 执行

41. 运行 Playbook

Bash

1ansible-playbook -i inventory.ini site.yml

42. 语法检查

Bash

1ansible-playbook -i inventory.ini site.yml --syntax-check

43. 预演变更

Bash

1ansible-playbook -i inventory.ini site.yml --check

44. 显示文件差异

Bash

1ansible-playbook -i inventory.ini site.yml --check --diff

45. 列出任务

Bash

1ansible-playbook -i inventory.ini site.yml --list-tasks

46. 列出标签

Bash

1ansible-playbook -i inventory.ini site.yml --list-tags

47. 列出目标主机

Bash

1ansible-playbook -i inventory.ini site.yml --list-hosts

48. 限制主机

Bash

1ansible-playbook -i inventory.ini site.yml --limit web1

49. 从指定任务开始

Bash

1ansible-playbook -i inventory.ini site.yml --start-at-task 'Deploy config'

50. 单步确认执行

Bash

1ansible-playbook -i inventory.ini site.yml --step

六、标签、变量与并发

51. 只运行指定标签

Bash

1ansible-playbook -i inventory.ini site.yml --tags deploy

52. 跳过指定标签

Bash

1ansible-playbook -i inventory.ini site.yml --skip-tags restart

53. 传入单个变量

Bash

1ansible-playbook -i inventory.ini deploy.yml -e app_version=1.2.3

54. 传入 JSON 变量

Bash

1ansible-playbook -i inventory.ini deploy.yml -e '{"app_env":"prod","replicas":3}'

55. 从文件加载变量

Bash

1ansible-playbook -i inventory.ini deploy.yml -e @vars/prod.yml

56. 设置并发数

Bash

1ansible-playbook -i inventory.ini site.yml --forks 20

57. 提示输入 become 密码

Bash

1ansible-playbook -i inventory.ini site.yml --ask-become-pass

58. 提示输入 SSH 密码

Bash

1ansible-playbook -i inventory.ini site.yml --ask-pass

59. 输出详细执行信息

Bash

1ansible-playbook -i inventory.ini site.yml -vvv

60. 指定临时目录

Bash

1ANSIBLE_LOCAL_TEMP=/tmp/ansible-local ansible-playbook -i inventory.ini site.yml

七、Vault

61. 创建加密变量文件

Bash

1ansible-vault create group_vars/prod/vault.yml

62. 查看加密文件

Bash

1ansible-vault view group_vars/prod/vault.yml

63. 编辑加密文件

Bash

1ansible-vault edit group_vars/prod/vault.yml

64. 加密现有文件

Bash

1ansible-vault encrypt secrets.yml

65. 解密文件

Bash

1ansible-vault decrypt secrets.yml

66. 修改 Vault 密码

Bash

1ansible-vault rekey secrets.yml

67. 加密单个字符串

Bash

1ansible-vault encrypt_string --name db_password

68. 使用密码文件运行

Bash

1ansible-playbook -i inventory.ini site.yml --vault-password-file .vault-pass

69. 使用 Vault ID

Bash

1ansible-playbook -i inventory.ini site.yml --vault-id prod@prompt

70. 多 Vault ID 运行

Bash

1ansible-playbook -i inventory.ini site.yml --vault-id dev@dev-pass --vault-id prod@prompt

八、Role、Collection 与 Galaxy

71. 初始化 Role

Bash

1ansible-galaxy role init roles/web

72. 查看已安装 Role

Bash

1ansible-galaxy role list

73. 安装 Role

Bash

1ansible-galaxy role install geerlingguy.nginx

74. 按文件安装 Role

Bash

1ansible-galaxy role install -r requirements.yml

75. 删除 Role

Bash

1ansible-galaxy role remove geerlingguy.nginx

76. 初始化 Collection

Bash

1ansible-galaxy collection init acme.ops

77. 列出 Collection

Bash

1ansible-galaxy collection list

78. 安装 Collection

Bash

1ansible-galaxy collection install community.general

79. 按文件安装 Collection

Bash

1ansible-galaxy collection install -r requirements.yml

80. 构建 Collection

Bash

1ansible-galaxy collection build collections/ansible_collections/acme/ops

九、调试、过滤与输出

81. 输出变量

Bash

1ansible all -i inventory.ini -m debug -a 'var=hostvars[inventory_hostname]'

82. 输出格式化消息

Bash

1ansible all -i inventory.ini -m debug -a 'msg={{ inventory_hostname }}={{ ansible_host }}'

83. 使用 JSON 输出回调

Bash

1ANSIBLE_STDOUT_CALLBACK=json ansible-playbook -i inventory.ini site.yml

84. 启用执行计时

Bash

1ANSIBLE_CALLBACKS_ENABLED=ansible.posix.profile_tasks ansible-playbook -i inventory.ini site.yml

85. 查看缓存事实

Bash

1ansible all -i inventory.ini -m setup -a 'gather_subset=min'

86. 清除事实缓存

Bash

1ansible all -i inventory.ini -m meta -a 'clear_facts'

87. 检查变量优先级结果

Bash

1ansible web1 -i inventory.ini -m debug -a 'var=app_version'

88. 过滤返回字段

Bash

1ansible all -i inventory.ini -m setup -a 'filter=ansible_memtotal_mb'

89. 检查模板渲染

Bash

1ansible localhost -c local -m template -a 'src=app.conf.j2 dest=/tmp/app.conf' --check --diff

90. Lint Playbook

Bash

1ansible-lint site.yml

十、生产执行与综合检查

91. 串行发布一台主机

Bash

1ansible-playbook -i inventory.ini deploy.yml -e serial_count=1

92. 后台异步执行

Bash

1ansible all -i inventory.ini -B 3600 -P 0 -m command -a '/opt/app/batch.sh'

93. 查询异步任务

Bash

1ansible all -i inventory.ini -m async_status -a 'jid=JOB_ID'

94. 重启目标主机

Bash

1ansible all -i inventory.ini -b -m reboot -a 'reboot_timeout=600'

95. 等待主机恢复

Bash

1ansible all -i inventory.ini -m wait_for_connection -a 'timeout=300'

96. 检查模式限制目标

Bash

1ansible-playbook -i inventory.ini site.yml --check --diff --limit 'web:&prod'

97. 使用安全日志路径

Bash

1ANSIBLE_LOG_PATH=artifacts/ansible.log ansible-playbook -i inventory.ini site.yml

98. 查看失败主机重试文件

Bash

1ansible-playbook -i inventory.ini site.retry

99. 完整静态检查

Bash

1ansible-inventory -i inventory.ini --list >/dev/null && ansible-playbook -i inventory.ini site.yml --syntax-check && ansible-lint site.yml

100. 生产预演

Bash

1ansible-playbook -i inventory/prod site.yml --limit canary --check --diff --ask-vault-pass

总结

Ansible 的关键不是把远程命令批量执行，而是让变更具备幂等、可审计、可预演和可回滚能力。生产发布应先做语法与 lint 检查，再对金丝雀主机执行 --check --diff，最后分批推进。