GeekIt

Ansible命令速查

环境配置、Inventory、ad-hoc、playbook 执行与语法、变量、常用模块、roles 集合、Vault、调试与性能优化等 162 条命令

共 162 条命令 · 12 类场景 · 点击右侧图标可复制

命令 / 片段说明复制
ansible --version查看版本、配置文件路径与 Python 解释器
python3 -m pip install ansible-corepip 安装核心包(集合需另行安装)
dnf install ansible-coreRHEL/CentOS 系安装
apt install ansibleDebian/Ubuntu 安装完整版
ansible-config init --disabled -t all > ansible.cfg生成全量配置模板便于裁剪
ansible-config list列出所有可配置项与默认值
ansible-config view查看当前生效的配置文件内容
ansible-config dump --only-changed只看被修改过的配置项,排障首选
export ANSIBLE_CONFIG=/etc/ansible/ansible.cfg用环境变量指定配置文件
配置文件查找顺序:ANSIBLE_CONFIG > 当前目录 > ~/.ansible.cfg > /etc/ansible/ansible.cfg改了配置没生效先确认加载了哪个文件
ansible localhost -m ping最小连通性验证
ansible --help查看全部子命令与参数
命令 / 片段说明复制
ansible-inventory -i hosts.ini --list以 JSON 展示清单解析结果
ansible-inventory -i hosts.ini --graph树形展示主机分组结构
ansible-inventory -i hosts.ini --graph --vars连变量一起展示,确认变量是否生效
ansible-inventory -i hosts.ini --host web01查看单台主机的最终变量
ansible-inventory -i hosts.ini --list --yamlYAML 输出,便于复制成静态清单
ansible -i hosts.ini all --list-hosts列出将执行的目标主机
ansible all -i a.ini -i b.ini -m ping多个清单叠加使用
ansible-inventory -i inventory/aws_ec2.yml --graph动态清单插件(云环境自动发现)
[web] web01 ansible_host=10.0.0.11 [web:vars] ansible_user=opsINI 清单写法:主机与组变量
all: children: web: hosts: web01:YAML 清单写法,层级更清晰
inventory/ 目录按文件拆分 prod/、staging/多环境隔离,避免误操作生产
ansible_ssh_private_key_file 按主机覆盖密钥不同环境密钥不同时使用
命令 / 片段说明复制
ansible all -i hosts.ini -m ping批量连通性检查
ansible web -i hosts.ini -m command -a "uptime"执行命令(不经过 shell,不支持管道)
ansible web -i hosts.ini -m shell -a "df -h | grep /data"需要管道或重定向时用 shell
ansible web -m setup -a "filter=ansible_memory_mb"采集指定 facts,快速获取主机信息
ansible web -m copy -a "src=./app.conf dest=/etc/app.conf mode=0644" -b批量分发文件并提权
ansible web -m file -a "path=/data/logs state=directory owner=app mode=0755" -b批量创建目录并设权限
ansible web -m service -a "name=nginx state=restarted" -b批量重启服务
ansible web -m package -a "name=htop state=present" -b跨发行版安装软件包
ansible all -m ping -f 20提高并发 fork 数,加快批量执行
ansible all -m ping --limit "web01,web02"临时限定目标主机
ansible web -m command -a "whoami" -u ops --private-key ~/.ssh/id_rsa指定登录用户与密钥
ansible all -m shell -a "hostname" -b -K需要 sudo 密码时加 -K 交互输入
ansible web -m command -a "echo hi" -e "env=prod"传入额外变量供任务使用
命令 / 片段说明复制
ansible-playbook -i hosts.ini site.yml最基础的执行方式
ansible-playbook -i hosts.ini site.yml --check演练模式,不真正改动目标
ansible-playbook -i hosts.ini site.yml --check --diff演练并显示文件差异,发布前必做
ansible-playbook site.yml --syntax-check只检查语法,CI 中常用
ansible-playbook site.yml --list-tasks列出将执行的任务顺序
ansible-playbook site.yml --list-hosts确认影响的主机范围
ansible-playbook site.yml --limit web只对指定组或主机执行
ansible-playbook site.yml --tags deploy只执行指定标签任务
ansible-playbook site.yml --skip-tags test跳过指定标签
ansible-playbook site.yml --start-at-task "Deploy app"从指定任务开始,调试省时间
ansible-playbook site.yml -e @prod.yml -e "version=1.2.3"合并变量文件与临时变量(优先级最高)
ansible-playbook site.yml -f 20提高并发数
ansible-playbook site.yml -vvv输出详细调试信息,连接问题常用
ansible-playbook site.yml --step逐任务确认,危险操作前使用
ansible-playbook site.yml --vault-password-file ~/.vault_pass自动提供 vault 密码,适合定时任务
命令 / 片段说明复制
- hosts: web become: true vars: app_port: 8080play 头部:目标、提权与变量
tasks: - name: Install nginx package: name: nginx state: present任务写法:模块参数用缩进而非 key=value
when: ansible_os_family == "RedHat"条件执行,支持变量与 facts
loop: "{{ packages }}"循环执行(替代 with_items)
register: result - debug: var: result.stdout保存结果并在后续任务中使用
notify: restart nginx任务变更时触发 handler
handlers: - name: restart nginx service: name: nginx state: restartedhandler 定义,只在 changed 时执行
block: ... rescue: ... always: ...错误处理:失败回滚与收尾
include_tasks: install.yml动态引入任务文件(条件为真才加载)
import_tasks: install.yml静态引入,语法检查阶段就解析
serial: 2分批滚动执行,发布与重启场景必须
strategy: free主机各自推进,不等同步,提速明显
changed_when: false / failed_when: false修正幂等判定与误判失败
delegate_to: localhost在控制端执行,如调用 API 或写本地文件
ignore_errors: true忽略失败继续执行(谨慎)
until: result.rc == 0 retries: 5 delay: 10轮询等待条件满足
命令 / 片段说明复制
group_vars/web.yml组变量,同名组自动加载
host_vars/web01.yml主机变量,优先级高于组变量
vars_files: - vars/common.ymlplay 中引入变量文件
set_fact: app_version="{{ version }}"运行时定义变量,后续任务可用
hostvars["web01"]["ansible_host"]访问其他主机的变量
groups["web"]获取组成员列表
inventory_hostname 与 ansible_facts当前主机名与采集到的事实变量
vars_prompt: - name: confirm prompt: "确认发布? (yes/no)"执行前交互确认,生产发布常用
优先级:role defaults < inventory group_vars < host_vars < play vars < set_fact < extra vars变量不生效时按此顺序排查
-e 传入的 extra vars 永远最高临时覆盖调试最方便
ansible-inventory --host web01查看主机最终变量值
变量名不要与 facts 冲突如 name、environment 容易覆盖内置值
命令 / 片段说明复制
copy: src: app.conf dest: /etc/app.conf mode: "0644" backup: true分发文件并保留备份
template: src: nginx.conf.j2 dest: /etc/nginx/nginx.conf notify: restart nginx渲染 Jinja2 模板并触发重启
file: path: /data/app state: directory owner: app mode: "0755"管理目录、权限、软链接
lineinfile: path: /etc/hosts regexp: "^10.0.0.11" line: "10.0.0.11 app.local"按行修改配置,幂等安全
blockinfile: path: /etc/security/limits.conf block: | app soft nofile 65535插入带标记的配置块
stat: path: /etc/app.conf获取文件状态,配合 when 判断
get_url: url: https://example.com/app.tgz dest: /tmp/app.tgz checksum: "sha256:..."下载并校验
unarchive: src: /tmp/app.tgz dest: /opt remote_src: true解压归档
user: name: app shell: /bin/bash groups: wheel管理用户与附加组
cron: name: "backup" minute: "0" hour: "3" job: "/opt/backup.sh"管理定时任务
systemd: name: app state: restarted daemon_reload: truesystemd 场景优先于 service 模块
uri: url: http://localhost:8080/health status_code: 200调用 HTTP 接口做健康检查
assert: that: - result.rc == 0断言校验,失败立即停止
debug: msg: "{{ inventory_hostname }} ok"输出调试信息
ansible-doc -l列出全部模块
ansible-doc copy查看模块参数与示例,比翻文档快
命令 / 片段说明复制
ansible-galaxy init roles/nginx生成标准 role 目录结构
ansible-galaxy install geerlingguy.nginx安装社区 role
ansible-galaxy install -r requirements.yml -p roles/按依赖文件批量安装到指定目录
ansible-galaxy role list列出已安装 role
ansible-galaxy role remove geerlingguy.nginx卸载 role
ansible-galaxy collection install community.general安装集合(新版本模块都在集合里)
ansible-galaxy collection install -r requirements.yml -p ./collections指定安装目录,便于随项目分发
ansible-galaxy collection list列出已安装集合与版本
roles: - role: nginx vars: port: 8080playbook 中引用 role 并覆盖变量
meta/main.yml 中 dependencies 声明依赖role 之间自动编排顺序
collections/requirements.yml 纳入版本管理锁定版本避免环境漂移
role 内 tasks/main.yml 为入口文件defaults/vars/handlers/templates 各有固定位置
命令 / 片段说明复制
ansible-vault create secrets.yml创建加密文件
ansible-vault encrypt secrets.yml加密已有文件
ansible-vault decrypt secrets.yml解密(注意不要提交明文)
ansible-vault edit secrets.yml在编辑器中直接改密文内容
ansible-vault view secrets.yml只查看不落盘
ansible-vault rekey secrets.yml更换加密密码
ansible-vault encrypt_string "mypassword" --name "db_password"生成单个加密变量,嵌入 YAML
ansible-playbook site.yml --ask-vault-pass执行时交互输入密码
ansible-playbook site.yml --vault-password-file ~/.vault_pass从文件读密码(权限 600)
--vault-id prod@~/.vault_pass_prod多环境多密码标签
no_log: true敏感任务不输出参数,避免密码进日志
become_user: app以指定用户提权执行
ansible_ssh_private_key_file: ~/.ssh/id_prod按主机指定密钥
Ansible Vault 只做静态加密传输与执行期仍应配合密钥权限与日志脱敏
命令 / 片段说明复制
ansible-playbook site.yml -vvv输出连接与模块调用细节
ansible-playbook site.yml --check --diff先看会改什么,再决定是否执行
ansible-lint site.yml静态检查 playbook 规范与风险
ansible-playbook site.yml --syntax-check快速定位 YAML 与语法错误
register: r - debug: var: r打印任务返回结果,定位字段名
debug: msg: "{{ ansible_facts.default_ipv4.address }}"打印变量值
ANSIBLE_DEBUG=1 ansible-playbook site.yml输出 Ansible 内部调试日志(量很大)
ANSIBLE_STDOUT_CALLBACK=yaml ansible-playbook site.ymlYAML 格式输出,可读性更好
callback_whitelist = profile_tasks显示每个任务耗时,找慢任务
ansible all -m gather_facts --tree /tmp/facts导出 facts 便于比对差异
ansible-doc -l | grep -i docker按关键字找模块
ansible-playbook site.yml --list-tasks --list-hosts执行前确认任务与主机范围
strategy: debug交互式调试,可逐步执行任务
命令 / 片段说明复制
ansible-playbook site.yml -f 50提高并发,受控制端与网络限制
serial: 10滚动批次,兼顾速度与可用性
strategy: free主机独立推进,减少等待
gather_facts: false不需要 facts 时关闭,节省启动时间
fact_caching = jsonfile fact_caching_connection = /tmp/ansible_facts fact_caching_timeout = 86400开启 facts 缓存,批量执行提速明显
pipelining = True减少 SSH 往返(目标端需关闭 requiretty)
ssh_args = -o ControlMaster=auto -o ControlPersist=60s连接复用,显著降低握手开销
async: 300 poll: 0长任务异步执行,避免占住 fork
async: 600 poll: 10异步并轮询结果
ANSIBLE_PIPELINING=1 ansible-playbook ...环境变量方式开启 pipelining
mitogen 策略插件第三方加速方案,可提升数倍速度(评估兼容性)
减少 include_tasks 层数每层引入都有解析开销
命令 / 片段说明复制
UNREACHABLE! Failed to connect to host via ssh网络不通、端口非 22、用户或密钥不对,先用 ssh 手工验证
Permission denied (publickey)密钥未分发或 ssh-agent 未加载
sudo: a password is required / Missing sudo password需要 -K 输入密码,或配置 NOPASSWD
to use the ssh connection type with passwords, you must install sshpass密码登录需安装 sshpass(不推荐生产)
Timeout (12s) waiting for privilege escalation prompt提权超时:sudo 配置、密码错或提示符不匹配
No inventory was parsed, only implicit localhost is available清单路径错误或格式不合法
ERROR! Syntax Error while loading YAML缩进、冒号后空格或 tab 导致,按行号修正
couldn't resolve module/action模块名拼错或集合未安装(FQCN 写法)
The conditional check failed / undefined variable变量未定义或条件表达式写错,用 debug 打印
MODULE FAILURE目标端执行模块异常,加 -vvv 看 stderr 与 Python 版本
Decryption failed / Vault format errorvault 密码错误或文件被破坏
Failed to lock apt for exclusive operation目标机 apt 被占用,等待或先执行 apt 修复
conflicting action statements同一任务混用多个模块,拆成多个任务
任务显示 changed 但实际没变command/shell 不做幂等,用 changed_when 修正
执行很慢开 pipelining、facts 缓存、ControlPersist,并减少 fork 争抢

运维常用组合

首次接入ansible --version → ansible-inventory --graph → ansible all -m ping → ansible all -m setup -a "filter=ansible_distribution*"
日常变更git pull → ansible-playbook --syntax-check → --check --diff → --limit 小范围 → 全量执行
发布回滚备份旧版本 → serial 分批 → --tags deploy → uri 健康检查 → 失败则重跑上一版本 playbook
新环境初始化ansible-galaxy install -r requirements.yml → 建 inventory → playbook 装基础包与用户 → 验收 ping/uri
密钥管理ansible-vault create secrets.yml → --vault-password-file 执行 → rekey 轮换 → 确认密文已入库
排障路径-vvv 看连接 → debug 打印变量 → ansible-lint 查规范 → ansible-doc 查模块参数

常见问题排查

1. 先 --check --diff

任何生产变更先演练并看差异,能挡掉大部分误操作

2. 幂等是核心

用模块而非 shell 实现变更,command/shell 要配合 changed_when

3. 变量优先级要记牢

role defaults 最低、extra vars 最高,排查时按链路逐层确认

4. 分批发布用 serial

配合负载均衡摘除,避免整组同时重启导致中断

5. 敏感信息进 Vault

密文入库、密码文件 600、任务加 no_log

6. 性能三板斧

pipelining + facts 缓存 + ControlPersist,大规模场景提速最明显

共 162 条 Ansible 命令 · 示例中的主机名、路径与变量请替换为实际环境

关于Ansible命令速查

在线 Ansible 命令速查手册,按安装与环境、清单 Inventory、临时命令 Ad-hoc、Playbook 执行、Playbook 语法要点、变量与优先级、常用模块、Roles 与 Collections、Vault 与安全、调试与排查、性能优化、常见报错与排查等 12 类场景整理 160+ 条常用命令与配置片段,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 ansible --version 与 ansible-config init/list/view/dump --only-changed 与 ANSIBLE_CONFIG 与配置查找顺序、ansible-inventory 的 --list/--graph/--vars/--host/--yaml 与 INI 与 YAML 清单写法与多清单一 -i 与动态清单插件、ansible 的 -m ping/command/shell/copy/file/service/package/setup 的 filter 与 -f/--limit/-b/-K/-u/--private-key/-e、ansible-playbook 的 --check/--diff/--syntax-check/--list-tasks/--list-hosts/--limit/--tags/--skip-tags/--start-at-task/-e @vars.yml/-f/--step/--vault-password-file、playbook 的 hosts/become/vars/tasks/name/handlers/notify/when/loop/register/block-rescue-always/include_tasks/import_tasks/serial/strategy/changed_when/failed_when/delegate_to/ignore_errors/until-retries-delay、变量 group_vars/host_vars/vars_files/set_fact/hostvars/groups/inventory_hostname/ansible_facts/vars_prompt 与优先级顺序、copy/template/file/lineinfile/blockinfile/stat/get_url/unarchive/user/cron/systemd/uri/assert/debug 与 ansible-doc -l 与 ansible-doc <module>、ansible-galaxy init/install -r/role list/remove 与 collection install/list 与 requirements.yml 与 meta 依赖、ansible-vault create/encrypt/decrypt/edit/view/rekey/encrypt_string 与 --vault-id 与 no_log、-vvv 与 ansible-lint 与 ANSIBLE_DEBUG 与 ANSIBLE_STDOUT_CALLBACK=yaml 与 profile_tasks 与 strategy: debug、-f/serial/strategy: free/gather_facts: false/fact_caching/pipelining/ssh_args ControlPersist/async-poll/mitogen,以及 UNREACHABLE Failed to connect、Permission denied publickey、Missing sudo password、sshpass、Timeout waiting for privilege escalation、No inventory was parsed、Syntax Error while loading YAML、couldn't resolve module/action、undefined variable、MODULE FAILURE、Decryption failed、Failed to lock apt、conflicting action statements 等报错排查。适用于 Ansible 自动化运维、批量配置与发布、playbook 编写与幂等设计、动态清单与多环境管理、role 与集合复用、敏感信息加密、性能调优与故障定位,以及运维与 DevOps 面试复习。

核心能力

  • 涵盖 ansible --version 与 ansible-config init/list/view/dump --only-changed 与 ANSIBLE_CONFIG 与配置查找顺序、ansible-inventory 的 --list/--graph/--vars/--host/--yaml 与 INI 与 YAML 清单写法与多清单一 -i 与动态清单插件、ansible 的 -m ping/command/shell/copy/file/service/package/setup 的 filter 与 -f/--limit/-b/-K/-u/--private-key/-e、ansible-playbook 的 --check/--diff/--syntax-check/--list-tasks/--list-hosts/--limit/--tags/--skip-tags/--start-at-task/-e @vars.yml/-f/--step/--vault-password-file、playbook 的 hosts/become/vars/tasks/name/handlers/notify/when/loop/register/block-rescue-always/include_tasks/import_tasks/serial/strategy/changed_when/failed_when/delegate_to/ignore_errors/until-retries-delay、变量 group_vars/host_vars/vars_files/set_fact/hostvars/groups/inventory_hostname/ansible_facts/vars_prompt 与优先级顺序、copy/template/file/lineinfile/blockinfile/stat/get_url/unarchive/user/cron/systemd/uri/assert/debug 与 ansible-doc -l 与 ansible-doc <module>、ansible-galaxy init/install -r/role list/remove 与 collection install/list 与 requirements.yml 与 meta 依赖、ansible-vault create/encrypt/decrypt/edit/view/rekey/encrypt_string 与 --vault-id 与 no_log、-vvv 与 ansible-lint 与 ANSIBLE_DEBUG 与 ANSIBLE_STDOUT_CALLBACK=yaml 与 profile_tasks 与 strategy: debug、-f/serial/strategy: free/gather_facts: false/fact_caching/pipelining/ssh_args ControlPersist/async-poll/mitogen,以及 UNREACHABLE Failed to connect、Permission denied publickey、Missing sudo password、sshpass、Timeout waiting for privilege escalation、No inventory was parsed、Syntax Error while loading YAML、couldn't resolve module/action、undefined variable、MODULE FAILURE、Decryption failed、Failed to lock apt、conflicting action statements 等报错排查

适用场景

适用于 Ansible 自动化运维、批量配置与发布、playbook 编写与幂等设计、动态清单与多环境管理、role 与集合复用、敏感信息加密、性能调优与故障定位,以及运维与 DevOps 面试复习。Ansible命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

Ansible命令速查是免费的吗?需要注册或安装吗?
Ansible命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
Ansible命令速查支持哪些功能?
涵盖 ansible --version 与 ansible-config init/list/view/dump --only-changed 与 ANSIBLE_CONFIG 与配置查找顺序、ansible-inventory 的 --list/--graph/--vars/--host/--yaml 与 INI 与 YAML 清单写法与多清单一 -i 与动态清单插件、ansible 的 -m ping/command/shell/copy/file/service/package/setup 的 filter 与 -f/--limit/-b/-K/-u/--private-key/-e、ansible-playbook 的 --check/--diff/--syntax-check/--list-tasks/--list-hosts/--limit/--tags/--skip-tags/--start-at-task/-e @vars.yml/-f/--step/--vault-password-file、playbook 的 hosts/become/vars/tasks/name/handlers/notify/when/loop/register/block-rescue-always/include_tasks/import_tasks/serial/strategy/changed_when/failed_when/delegate_to/ignore_errors/until-retries-delay、变量 group_vars/host_vars/vars_files/set_fact/hostvars/groups/inventory_hostname/ansible_facts/vars_prompt 与优先级顺序、copy/template/file/lineinfile/blockinfile/stat/get_url/unarchive/user/cron/systemd/uri/assert/debug 与 ansible-doc -l 与 ansible-doc <module>、ansible-galaxy init/install -r/role list/remove 与 collection install/list 与 requirements.yml 与 meta 依赖、ansible-vault create/encrypt/decrypt/edit/view/rekey/encrypt_string 与 --vault-id 与 no_log、-vvv 与 ansible-lint 与 ANSIBLE_DEBUG 与 ANSIBLE_STDOUT_CALLBACK=yaml 与 profile_tasks 与 strategy: debug、-f/serial/strategy: free/gather_facts: false/fact_caching/pipelining/ssh_args ControlPersist/async-poll/mitogen,以及 UNREACHABLE Failed to connect、Permission denied publickey、Missing sudo password、sshpass、Timeout waiting for privilege escalation、No inventory was parsed、Syntax Error while loading YAML、couldn't resolve module/action、undefined variable、MODULE FAILURE、Decryption failed、Failed to lock apt、conflicting action statements 等报错排查。
Ansible命令速查适合哪些场景使用?
适用于 Ansible 自动化运维、批量配置与发布、playbook 编写与幂等设计、动态清单与多环境管理、role 与集合复用、敏感信息加密、性能调优与故障定位,以及运维与 DevOps 面试复习。