YAML怎样定义运维变量

在 YAML 里，“运维变量”通常指在运维配置（如 Ansible、Kubernetes、CI/CD、Docker Compose 等）中用于描述环境参数、配置项的变量。YAML 本身没有变量语法，但可以通过约定结构或工具特性来定义和使用变量。

下面按常见场景说明。

一、YAML 中“定义变量”的通用方式

1️⃣ 用普通字段表示变量（最常见）

env:
  app_port: 8080
  log_level: info
  db_host: 10.0.0.1

使用时由程序或工具读取。

2️⃣ 使用 vars / variables 命名约定

variables:
  env_name: production
  replicas: 3

二、Ansible 中的运维变量（最典型）

inventory 变量

[web]
192.168.1.10 ansible_user=root

group_vars / host_vars（YAML）

# group_vars/web.yaml
nginx_port: 80
max_connections: 1024

playbook 中定义

vars:
  app_name: myapp
  version: v1.2.0

三、Kubernetes 中的“运维变量”

ConfigMap

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  LOG_LEVEL: info
  MAX_RETRIES: "3"

Pod 中使用

env:
  - name: LOG_LEVEL
    valueFrom:
      configMapKeyRef:
        name: app-config
        key: LOG_LEVEL

四、Docker Compose 中的变量

定义变量

services:
  web:
    image: nginx
    environment:
      - TZ=Asia/Shanghai
      - PORT=8080

使用 .env 文件

APP_PORT=8080

ports:
  - "${APP_PORT}:80"

五、CI/CD（GitLab / GitHub Actions）

GitLab CI

variables:
  ENV: production
  DEPLOY_USER: deploy

GitHub Actions

env:
  REGION: cn-east
  NAMESPACE: default

六、YAML 模板变量（进阶）

YAML 本身无模板能力，但工具支持：

• Ansible：{{ var }}
• Helm：{{ .Values.xxx }}
• Jinja2 / ytt / Jsonnet

示例（Helm）：

replicas: {{ .Values.replicas }}

七、运维变量定义的最佳实践

✅ 按环境分层
✅ 敏感信息用 Secret
✅ 变量命名清晰（db_host 而非 h）
✅ 避免硬编码 IP / 密码

如果你能说明具体用在哪个系统（Ansible / K8s / 运维平台 / 自研系统），我可以给你更贴合的 YAML 示例。