在持续集成流程中,手动发布版本往往效率低下且容易出错。利用 GitHub Actions 的 create-release 动作,我们可以将发布流程完全自动化,从打标签到生成 Release 记录一气呵成。
核心动作配置
在工作流文件中引入官方动作:
uses: actions/create-release@v1
这个动作负责在仓库中创建一个新的 Release 条目。为了正确使用它,我们需要理解其输入参数和输出结果。
关键参数说明
配置时主要关注以下几个字段,它们决定了发布的形态和内容:
- tag_name:本次发布对应的 Git 标签名,通常与代码版本号一致。
- release_name:Release 页面上显示的名称,可以比 tag_name 更友好一些。
- body:直接填写发布内容的文本描述。如果使用了 body_path,此字段可省略。
- body_path:指向一个本地文件路径,该文件内容将作为发布描述。适合存放较长的变更日志。
- draft:布尔值。设为 true 则创建为草稿状态,false 或直接不填则为正式发布(默认 false)。
- prerelease:布尔值。标记是否为预发布版本,默认为 false。
获取上传地址
创建成功后,动作会返回几个关键信息供后续步骤使用:
- id:此次发布的唯一标识 ID。
- html_url:生成的 Release 页面链接,方便人工查看。
- upload_url:这是最重要的部分,包含了附件上传的地址模板。你可以将其传递给后续的 upload-artifact 或 curl 命令,用于将构建产物绑定到这个 Release 上。
注意事项
在实际使用中,确保工作流拥有足够的权限。默认情况下,GITHUB_TOKEN 具备创建 Release 的权限,但如果需要上传二进制文件,可能需要额外配置 token 的 scope。此外,建议在生产环境触发前先在测试分支验证 workflow 逻辑,避免误发正式版本。

