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 注入步骤环境变量,同时把非敏感部署区域作为普通配置使用。

yaml
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"

预期输出

text
region=ap-southeast-1

这里假设 Variable DEPLOY_REGION 的值为 ap-southeast-1,实际输出取决于仓库中配置的值。DEPLOY_TOKEN 只参与非空检查,示例不会主动打印它。

作用域决定谁能使用

Secrets 和 Variables 都不仅仅是键值对,还要考虑作用域。仓库级配置适合单个仓库共享;Environment 级配置适合把生产、测试等部署环境隔离;组织级配置适合多个仓库共享,并可结合仓库访问策略控制使用范围。

Environment 特别适合部署凭据。例如生产环境可以维护独立的 DEPLOY_TOKEN,作业通过 environment 指定目标环境,从而让生产凭据与普通 CI 作业分离。

yaml
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。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分 Secrets 与 Variables

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通