CI/CD / 系统课时
区分 Secrets 与 Variables
区分 Secrets 与 Variables
GitHub Actions 中并不是所有配置值都应该放进 Secrets。正确做法是先判断数据是否敏感,再决定使用 Secrets 还是 Variables,并进一步选择仓库、环境或组织作用域,避免把普通配置当密码管理,也避免敏感凭据以明文配置暴露。
学习目标
- 根据数据敏感性选择 Secrets 或 Variables
- 在工作流中正确读取
secrets与vars上下文 - 理解作用域选择与敏感信息使用时的安全边界
先按敏感性做选择
Secrets 用于 API Token、部署密钥、密码等不应直接暴露的值。Variables 用于环境名称、区域、普通域名、功能开关等非敏感配置。两者都能减少硬编码,但安全语义不同。
例如 DEPLOY_TOKEN 应放入 Secret,而 DEPLOY_REGION=ap-southeast-1 通常适合 Variable。不要因为一个值经常变化就把它放进 Secret;决定因素首先是泄露后是否产生安全风险。
在工作流中分别读取
Secrets 通过 secrets 上下文读取,Variables 通过 vars 上下文读取。下面的工作流把敏感 Token 注入步骤环境变量,同时把非敏感部署区域作为普通配置使用。
name: Config Demo
on:
workflow_dispatch:
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- name: Check configuration
env:
DEPLOY_TOKEN: ${{ secrets.DEPLOY_TOKEN }}
DEPLOY_REGION: ${{ vars.DEPLOY_REGION }}
run: |
test -n "$DEPLOY_TOKEN"
echo "region=$DEPLOY_REGION"预期输出
region=ap-southeast-1这里假设 Variable DEPLOY_REGION 的值为 ap-southeast-1,实际输出取决于仓库中配置的值。DEPLOY_TOKEN 只参与非空检查,示例不会主动打印它。
作用域决定谁能使用
Secrets 和 Variables 都不仅仅是键值对,还要考虑作用域。仓库级配置适合单个仓库共享;Environment 级配置适合把生产、测试等部署环境隔离;组织级配置适合多个仓库共享,并可结合仓库访问策略控制使用范围。
Environment 特别适合部署凭据。例如生产环境可以维护独立的 DEPLOY_TOKEN,作业通过 environment 指定目标环境,从而让生产凭据与普通 CI 作业分离。
jobs:
deploy-production:
runs-on: ubuntu-latest
environment: production
steps:
- name: Verify production credential
env:
DEPLOY_TOKEN: ${{ secrets.DEPLOY_TOKEN }}
run: test -n "$DEPLOY_TOKEN"预期结果
text
test 成功时不会产生标准输出,步骤以退出码 0 完成;Secret 缺失或为空时则返回非零退出码并使步骤失败。Environment 还可以配合部署保护规则,把生产部署与普通工作流执行进一步隔离。
不要把 Variables 当作秘密存储
Variables 的设计目标是保存非敏感配置,因此不应把数据库密码、私钥或访问令牌迁入 Variables。反过来,把大量普通配置全部存为 Secrets 也会降低可读性,使维护者难以判断哪些值真正需要重点保护。
实际设计时可以使用一个简单判断:值泄露后若需要立即轮换凭据、可能导致未授权访问或产生直接安全影响,就按 Secret 管理;如果值本来可以安全地出现在配置文件或日志中,则通常更适合 Variable。