| 名称 | 是什么 | 从哪来 |
|---|---|---|
GITHUB_TOKEN | 平台每次运行自动发的临时令牌,用来读写这个仓库自己的东西 | 不用你配,平台注入;权限用 permissions 收敛 |
| secrets | 你存进仓库 / 组织 / 环境里的敏感值(接口密钥、口令) | 在仓库设置里加;流程里用 ${{ secrets.名字 }} 取 |
| permissions | 这个令牌到底能干什么(读代码、写评论、发版本……) | 写在工作流或作业里 |
permissions:
contents: read # 默认给整套令牌;这里明确只要「读代码」
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: gh issue list # 需要 issues: read 才能查;没给就会 403
原则简述:需要什么就给什么。
只读代码的检查任务,就把 contents 设为 read;
要往 PR 上写评论再加 pull-requests: write。
权限写宽了,最坏情况是「某个被引入的第三方 Action 拿着它替你做别的事」。
echo 密钥、把密钥写进文件再 cat,都属于自己给自己挖坑。分层也要想清楚:仓库级的密钥所有分支的流程都能用;环境级的只在指定环境下可用(配合审批), 更细。同名时环境级优先。
jobs:
deploy:
runs-on: ubuntu-latest
environment: production # 这个环境配了「必须人工批准」
steps:
- run: ./deploy.sh
在仓库设置里给 production 这个环境配上一到多个必需审阅人之后,
流程跑到这个作业会停下来等人点批准,不点就一直等着。
这正是持续交付与持续部署的分界:多了这道人工确认,就是交付;没有,就是自动部署。
permissions 决定能干什么;写宽了,它能改的东西比你想象的多。三题自测,每题只有一个正确选项;选完立刻看到解释。
1. 一个只跑测试、不需要写回仓库的作业,权限该怎么写?
对。测试要能读代码,但不需要写任何东西;contents: read 正好。权限给多了,第三方 Action 就有了不该有的能力。
2. 为什么来自 fork 的合并请求拿不到仓库的密钥?
对。这是刻意设计的防线:任何人都能 fork 你的公开仓库提 PR,如果那时能拿到密钥,等于把密钥交出去。
3. 给作业挂上一个配了必需审阅人的环境,会得到什么效果?
对。这正是「持续交付」与「持续部署」的分界线:验证通过之后要不要有人点一下。要,就是交付。