YAML如何管理运维脚本

YAML 本身不是用来“执行”运维脚本的语言，而是用来描述配置、流程、编排和参数的。在运维中，YAML 通常用于管理脚本的“输入、结构、调度和关系”，而不是替代 Shell/Python 等脚本语言。

下面从思路 + 常见场景 + 示例三个层面说明。

一、核心思路：YAML 管“什么”，脚本管“怎么干”

典型分工：

• YAML
  • 定义任务
  • 定义参数
  • 定义依赖关系
  • 定义执行环境
  • 定义调度策略
• 脚本（Shell / Python / Ansible 等）
  • 真正执行系统操作
  • 处理异常
  • 完成具体逻辑

✅ YAML 是“说明书”，脚本是“工人”

二、常见运维场景中的 YAML 用法

1️⃣ 用 YAML 管理“脚本参数”

避免把参数写死在脚本里。

deploy.yaml

app:
  name: user-service
  version: v1.2.0
  replicas: 3
  env: prod

deploy.sh

APP=$(yq '.app.name' deploy.yaml)
VERSION=$(yq '.app.version' deploy.yaml)

✅ 改 YAML 不改脚本

2️⃣ 用 YAML 管理“多脚本执行顺序”

pipeline.yaml

steps:
  - name: build
    script: scripts/build.sh
  - name: test
    script: scripts/test.sh
  - name: deploy
    script: scripts/deploy.sh
    depends_on:
      - build
      - test

runner.py

for step in yaml.load(steps):
    run(step["script"])

✅ 脚本只关心自己，YAML 管流程

3️⃣ 用 YAML 管理“主机 / 目标环境”

hosts.yaml

prod:
  hosts:
    - 10.0.0.1
    - 10.0.0.2
  user: deploy

脚本读取后批量执行：

ansible-playbook -i hosts.yaml deploy.yml

4️⃣ 用 YAML 做“任务编排（CI / CD）”

GitLab CI 示例

stages:
  - build
  - test
  - deploy

build:
  stage: build
  script:
    - ./scripts/build.sh

deploy:
  stage: deploy
  script:
    - ./scripts/deploy.sh

✅ YAML 定义“什么时候跑什么脚本”

5️⃣ 用 YAML 管理“定时任务”

cron.yaml

jobs:
  - name: backup
    schedule: "0 2 * * *"
    command: /opt/scripts/backup.sh

再由一个 daemon 读取并注册 cron。

三、推荐的 YAML 管理结构

ops/
├── scripts/
│   ├── deploy.sh
│   ├── backup.sh
├── config/
│   ├── app.yaml
│   ├── hosts.yaml
├── pipelines/
│   └── release.yaml
└── README.md

四、常用工具配合 YAML

五、最佳实践

✅ YAML 只描述稳定结构
✅ 脚本保持单一职责
✅ 用版本控制管理 YAML
✅ 不要写“太复杂的逻辑”进 YAML
✅ 用 schema 校验 YAML（如 kwalify）

如果你愿意，我可以：

• 给你一个完整 YAML + Shell 运维示例
• 或按你当前用的工具（Ansible / K8s / CI）具体讲
• 或帮你设计一套运维脚本管理体系

你现在的运维脚本是用在什么场景？