基础设施即代码 / 系统课时

使用 Tags 控制执行范围

使用 Tags 控制执行范围

一个 Playbook 往往同时包含配置、部署、重启等任务。Tags 让你不改任务顺序就能选择执行其中一部分,适合维护窗口、分阶段发布和故障处理,但前提是先理解“匹配标签”与“跳过标签”的组合规则。

学习目标

  • 为任务分配有业务含义的 Tags,并查看 Playbook 中已有标签
  • 使用 --tags 与 --skip-tags 精确控制执行范围
  • 理解 always、多标签任务以及标签选择的边界

Tags 实际控制的是任务选择

Tag 不是执行顺序,也不会让任务自动形成依赖。Ansible 在真正执行任务前,根据命令行选择条件判断当前任务是否进入本次运行。一个任务可以有多个标签;只要它命中了 --tags 中任意标签,就有资格执行,但若同时命中 --skip-tags,仍会被排除。

特殊标签 always 通常用于无论选择哪个业务标签都要执行的准备任务;never 则默认不执行,只有显式选中 never 或任务上的其他标签时才会运行。不要把 Tags 当成“半个工作流引擎”,关键前置条件仍应通过任务设计保证。

用一个 Playbook 组织配置与部署标签

下面在本机创建实验目录,并把不同任务标成 config、deploy 和 restart。准备目录使用 always,保证按业务标签运行时路径已经存在。

yaml
# tags-demo.yml
- name: 演示 Tags 选择
  hosts: demo
  gather_facts: false
  tasks:
    - name: 创建实验目录
      ansible.builtin.file:
        path: /tmp/anystack-tags
        state: directory
        mode: "0755"
      tags:
        - always

    - name: 写入应用配置
      ansible.builtin.copy:
        dest: /tmp/anystack-tags/app.conf
        content: "mode=production\n"
        mode: "0644"
      tags:
        - config

    - name: 写入部署标记
      ansible.builtin.copy:
        dest: /tmp/anystack-tags/release.txt
        content: "release=v1\n"
        mode: "0644"
      tags:
        - deploy

    - name: 模拟重启
      ansible.builtin.debug:
        msg: "restart would run"
      tags:
        - deploy
        - restart

对应的 Inventory 可以保持最小化:

ini
[demo]
localhost ansible_connection=local

配置文件是静态示例;验证方式是先列出标签,再只执行 config 范围。

bash
ansible-playbook -i inventory.ini tags-demo.yml --list-tags
ansible-playbook -i inventory.ini tags-demo.yml --tags config
cat /tmp/anystack-tags/app.conf
test ! -e /tmp/anystack-tags/release.txt && echo "deploy skipped"

预期输出中会列出 always、config、deploy、restart,随后只执行准备目录和配置任务;部署文件不会出现。不同 Ansible 版本的任务摘要格式可能略有差异。

text
TASK TAGS: [always, config, deploy, restart]
...
mode=production
deploy skipped

组合选择与跳过规则

--tags 适合“只跑这些”,--skip-tags 适合“正常跑,但排除这些”。两者可以同时出现。例如部署阶段希望执行 deploy,但本次维护窗口不允许重启,可以运行:

bash
ansible-playbook -i inventory.ini tags-demo.yml --tags deploy --skip-tags restart
cat /tmp/anystack-tags/release.txt

预期结果是部署标记被写入,而同时带有 deploy 和 restart 的“模拟重启”任务被排除。

text
...
release=v1

这说明跳过条件优先于已匹配的执行标签。若多个任务共享同一标签,Ansible 会选择它们全部,而不会分析这些任务是否在业务上适合单独运行。

让标签表达运维意图

标签名称应描述可被独立选择的运维范围,例如 config、packages、deploy、restart、diagnostics,而不是 task1、phase2 这类依赖位置的名字。任务移动后,业务标签仍然成立,顺序标签却会迅速失真。

在实际 Playbook 中,Tags 最适合做可选执行入口,而不是改变自动化逻辑。先保证完整 Playbook 可以重复、安全地执行,再用标签缩小本次运行范围,才不会把局部执行变成隐藏的人工流程。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Tags 控制执行范围

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

登录哪都通