Skip to content

CI 流水线失败:密钥不可用

快速摘要

你的 CI 流水线失败 —— 流水线中引用的密钥或环境变量未设置。

为什么发生

  • 密钥未添加到 CI 系统的密钥存储中

  • 流水线中的密钥名称与 CI 配置中的名称不匹配

  • 密钥的作用域是不同的环境或分支,在当前运行中不可用

最小示例

✗ 错误代码
# .github/workflows/deploy.yml
steps:
  - name: Deploy
    run: npm run deploy
    env:
      API_KEY: ${{ secrets.API_KEY }} # secret not configured in GitHub
✓ 修复代码
# Add the secret in GitHub: Settings > Secrets and variables > Actions > New secret
# Name: API_KEY, Value: your-api-key
steps:
  - name: Deploy
    run: npm run deploy
    env:
      API_KEY: ${{ secrets.API_KEY }} # now available

将 API_KEY 密钥添加到 GitHub 仓库的密钥存储使其对流水线步骤可用。

如何诊断

  • 检查 CI 流水线错误消息中缺失的密钥或环境变量名

  • 验证密钥以正确的名称存在于 CI 系统的密钥存储中

  • 检查密钥在当前分支或环境作用域中的可用性

如何修复

  • 将缺失的密钥添加到 CI 系统的密钥存储

  • 更正流水线中的密钥名称以匹配 CI 配置

  • 使密钥在当前环境或分支作用域中可用

如何预防

  • 记录所有必需的密钥并在流水线开始时验证它们

  • 使用密钥管理工具和跨环境一致的命名约定

相关资源

相关术语

相关课程

← 返回语言