CI 作业可以运行命令,也可能接收到凭据。权限规定这些凭据可以读取或更改什么。只检查网页的作业通常只需读取源文件。
持续集成 · 第 7 课
工作流权限
学习只为常规 CI 检查授予它所需的仓库访问权限。
让检查作业能够读取仓库
这段 GitHub Actions 配置把工作流内置令牌的权限限制为只读仓库内容。
permissions:
contents: read
检出步骤和本地测试都可以读取仓库。发布软件包的作业需要在另一种资源上执行其他操作。因此,只给实际需要发布的作业授予相应权限。
一个作业读取网页并运行 grep。它需要什么仓库内容权限?
处理敏感值
机密是需要保护的值,例如私有令牌。获得授权的作业确实需要机密时,可以使用平台的机密存储。把普通网页配置和机密分开。针对本地示例运行的常规检查无需公开任何凭据。
哪个值应放入受控的机密存储?
让日志易于排查
工作流日志可能会共享给其他人。可以报告做了什么、结果如何,但别打印机密值。发生失败时,可以说明缺少必要凭据或访问被拒绝。向维护者提供作业名和修订版本,方便排查。凭据的值不要写在消息中。
发布作业无法通过身份验证。哪种日志消息既有助于审查,又不会泄露凭据?
审查新增的作业
有人提议让工作流在拉取请求中运行网页检查,并增加一个发布软件包的作业。两种作业的权限需求不同。检查作业只需要读取权限。经批准的发布权限,应只给真正执行发布的作业。
哪种修改最符合两个作业的需要?
课程已完成
你已完成 工作流权限
现在,你可以判断一个小型 CI 流水线需要什么样的访问权限。
根据作业职责选择仓库权限。
通过受控的输入提供私有凭据。
记录有助于排查的错误,同时保护凭据的值。