GitLab CI/CD环境变量分全局和分支级两层管理：全局变量在Admin Area统一配置，全项目继承；分支级变量通过Scope通配符（如main、dev*）按分支动态注入，优先级高于YAML中定义的同名变量。

在 GitLab CI/CD 中，环境变量分层管理是运维可控性的关键。全局变量适用于所有项目共用的配置（如镜像仓库地址、通用密钥前缀），分支级变量则用于差异化控制（如 main 分支走生产部署，dev 分支走测试环境）。两者不冲突，而是按作用域优先级叠加生效。

全局环境变量：一次配置，全实例生效

适合跨项目复用、需统一管控的值，例如私有镜像仓库域名、默认超时时间、基础工具路径等。

• 进入 GitLab 管理后台（Admin Area）→ Settings → CI/CD → Variables
• 点击 Add variable，填写：
  • Key：如 CI_REGISTRY_BASE（仅字母、数字、下划线）
  • Value：如 registry.example.com:5000
  • Type：保持默认 Variable
  • Protected：勾选（防止非受保护分支意外读取）
  • Mask variable：对敏感值（如 token）建议勾选（值在日志中显示为 ***）
• 保存后，所有项目（包括新建项目）的流水线自动继承该变量，无需在 .gitlab-ci.yml 中重复定义

分支级环境变量：按分支动态注入

用于区分部署目标、开关功能、适配不同构建参数。GitLab 不直接支持“分支级变量”字段，而是通过 Scope（作用域）匹配 实现。

openclaw-github-config-impact

OpenClaw 技能 — 给定一个 GitHub 仓库 URL，自动解析出 owner/repo 名称，发现其中的 YAML/properties 配置文件及其配对的中文字段说明；在 `workspace/{repo}/` 目录下按同步日期（格式为 `YYYY-MM-DD`）创建时间戳子目录；写入 `.openclaw-config-state.json` 状态文件。每次用户提问前，先比对远程仓库当前 ref（如 `main` 或 `master`）的最新提交 SHA 与本地状态文件中记录的 SHA：

下载

• 在对应项目的 Settings → CI/CD → Variables 页面添加变量
• 设置 Scope 字段为通配符模式，例如：
  • main → 仅 main 分支触发的流水线可见
  • dev* → 匹配 dev、dev-feature-a 等分支
  • feature/** → 匹配所有 feature/xxx 分支（需 GitLab ≥ 15.0）
• 常见组合示例：
  • 变量名：DEPLOY_TARGET，值：prod，Scope：main
  • 变量名：DEPLOY_TARGET，值：staging，Scope：dev*
  • 变量名：SKIP_TESTS，值："true"，Scope：dependabot/**（跳过依赖更新的测试）

在 .gitlab-ci.yml 中安全使用变量

变量在脚本中直接引用即可，但要注意语法和时机：

• 普通引用：echo "Deploying to $DEPLOY_TARGET"（双引号内展开）
• 避免空格截断：ssh -o "StrictHostKeyChecking=no" "$DEPLOY_USER@$DEPLOY_SERVER"
• 变量未定义时提供默认值：echo "${CI_COMMIT_TAG:-no-tag}"
• 敏感操作前校验变量存在：if [[ -z "$API_TOKEN" ]]; then echo "Missing API_TOKEN"; exit 1; fi
• 不要在 variables: 块中硬编码敏感值——这是反模式，应全部移至 UI 变量管理

调试与验证技巧

变量是否生效，不能只靠猜测：

• 在任意作业中临时加一句：printenv | grep -E '^(DEPLOY|CI_)'，查看实际注入的变量列表
• 触发不同分支的流水线，对比日志中 DEPLOY_TARGET 输出是否符合预期
• 使用 GitLab 内置的 CI Lint 工具（项目 → CI/CD → Pipelines → CI Lint）检查 YAML 语法，确认无缩进或拼写错误导致变量未加载
• 注意：UI 中定义的变量优先级高于 .gitlab-ci.yml 中 variables: 定义的同名变量