SuperAPI AI 工具集

glab-release

通用与其它

查看项目

更新于 10-16 01:09

技能介绍

用途:glab release 是 GitLab CLI(glab)中用于管理 GitLab 发行版本(Release)的命令组,适用于发布软件版本、维护发行记录,以及在自动化流程中创建、查询和删除发行版本。

主要能力:提供以下子命令——create(新建发行版本,或更新已有版本)、delete(删除发行版本)、download(下载发行版本中的资产文件)、list(列出仓库中的发行版本)、upload(向发行版本上传资产文件或链接)、view(查看发行版本信息)。

使用方式:基本用法为 glab release [command] [--flags]。常用标志包括 -h/--help 查看帮助,-R/--repo 选择其他仓库,支持 OWNER/REPO、GROUP/NAMESPACE/REPO 格式,也接受完整 URL 或 Git URL。

结构化输出:list 和 view 支持 --output json 或 -F json,便于自动化处理。

可选参数:create 和 update 的 --notes 与 --notes-file 为可选;view 和 download 的 tag 为可选,省略时指向最新版本,若需可复现性应显式指定 tag。

CI/CD 使用:在流水线作业中建议使用预定义的 CI_JOB_TOKEN 配合 glab CI 自动登录。示例:GLAB_ENABLE_CI_AUTOLOGIN=true glab release create "$CI_COMMIT_TAG" --notes-file CHANGELOG.md --ref "$CI_COMMIT_SHA"。注意不要把 CI_JOB_TOKEN 赋给 GITLAB_TOKEN,因为 glab 会将 GITLAB_TOKEN 作为 PRIVATE-TOKEN 发送,Releases API 会拒绝 job token,可能表现为 404 Not Found。当 job token 权限不足时,改用具有 api 权限范围的已批准项目或群组访问令牌通过 GITLAB_TOKEN 提供,且切勿打印该令牌。

限制:资料未提供更多关于权限、平台或收费的说明。