服务器运维 YAML 怎么用

在服务器运维里，YAML 最常出现在这几类场景：

• 配置管理（Ansible、Docker Compose、K8s）
• CI/CD 流水线（GitLab CI、GitHub Actions）
• 服务编排与部署

下面用「能直接上手」的方式讲。

一、YAML 基本规则（先记住这 5 条）

1. 缩进必须用空格（不能用 Tab）
2. 同一层级缩进必须一致
3. key: value 格式，冒号后要有空格
4. 列表用 -
5. 注释用 #

name: nginx
replicas: 3
ports:
  - 80
  - 443
enabled: true

二、运维常见用法示例

1️⃣ Docker Compose（最常用）

version: "3"
services:
  web:
    image: nginx:1.25
    ports:
      - "80:80"
    volumes:
      - ./html:/usr/share/nginx/html
  db:
    image: mysql:8
    environment:
      MYSQL_ROOT_PASSWORD: "123456"

启动：

docker compose up -d

2️⃣ Ansible（服务器批量运维）

- hosts: webservers
  become: yes
  tasks:
    - name: install nginx
      apt:
        name: nginx
        state: present

    - name: start nginx
      service:
        name: nginx
        state: started

执行：

ansible-playbook site.yml

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
  - deploy

build:
  stage: build
  script:
    - make build

deploy:
  stage: deploy
  script:
    - scp app user@server:/opt/app

三、运维中常踩的坑

❌ Tab 缩进
✅ 用 2 个空格

❌ 引号漏了导致被解析成数字/布尔
✅ 密码、端口建议加引号

password: "123456"
port: "8080"

❌ 多层嵌套写错层级
✅ 用编辑器（VS Code + YAML 插件）

四、推荐工具

• VS Code + YAML 插件（语法检查）
• yamllint（命令行校验）

yamllint config.yml

• 在线校验：https://www.yamllint.com

如果你愿意，可以告诉我：

• 你用的是 Docker / K8s / Ansible / 云服务器
• 还是想写 某个具体运维脚本

我可以直接帮你写一份可用的 YAML。