怎样用YAML写运维配置

在运维（DevOps / SRE）场景中，YAML 常被用来描述配置、编排、流水线、监控规则等。下面从「基本语法 → 常见运维场景示例 → 最佳实践」三个层面讲清楚。

一、YAML 基本语法（运维必知）

1. 核心规则

• 使用 缩进（空格，不能 Tab） 表示层级
• key: value 形式
• 列表用 -
• 注释用 #
• 对大小写敏感

2. 常见数据结构

# 字符串
name: nginx

# 数字
port: 80

# 布尔
enabled: true

# 列表
ports:
  - 80
  - 443

# 字典
database:
  host: 127.0.0.1
  port: 3306

二、典型运维配置示例

1️⃣ 服务器 / 应用配置

app:
  name: user-service
  env: production
  replicas: 3
  resources:
    cpu: "500m"
    memory: "512Mi"
  ports:
    - 8080

2️⃣ Docker Compose（非常常见）

version: "3.8"

services:
  web:
    image: nginx:1.25
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf

  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: secret
    ports:
      - "3306:3306"

3️⃣ Kubernetes 配置（运维核心）

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
        - name: nginx
          image: nginx:1.25
          ports:
            - containerPort: 80

4️⃣ CI/CD 流水线（GitLab CI 示例）

stages:
  - build
  - test
  - deploy

build:
  stage: build
  script:
    - make build

deploy_prod:
  stage: deploy
  script:
    - kubectl apply -f deploy.yaml
  only:
    - main

5️⃣ 监控告警（Prometheus 示例）

groups:
  - name: example
    rules:
      - alert: HighCpuUsage
        expr: cpu_usage > 80
        for: 5m
        labels:
          severity: warning
        annotations:
          summary: "CPU 使用率过高"

三、运维写 YAML 的最佳实践

✅ 统一缩进（2 空格最常用）
✅ 敏感信息不要写死（用变量 / Secret）

password: ${DB_PASSWORD}

✅ 拆分文件，避免巨大 YAML

config.yaml
deploy.yaml
alert.yaml

✅ 写注释，方便交接

# 生产环境副本数，节假日可调高
replicas: 5

✅ 用工具校验

• yamllint
• kubectl apply --dry-run
• IDE（VS Code + YAML 插件）

四、常见坑（运维血泪史）

❌ Tab 缩进 → 直接报错
❌ 数字当字符串 → 端口写成 ports: 080
❌ 多环境混写 → 用 values-prod.yaml 分离

如果你愿意，我可以：

• 按 K8s / Ansible / CI / 监控 某一种深入讲
• 帮你 把一个 shell 脚本改成 YAML 配置
• 给你一套 生产级 YAML 模板

你主要用在哪块运维场景？