mcpField
G
glab-release

glab-release

github.com/vince-winkintel开发49111 次安装1 天前更新
代码仓库

关于 glab-release

glab-release 介绍使用 glab 命令行管理 GitLab 发布的工作流，适用于开发者和自动化流程。内容涵盖创建、更新、删除、查看和下载发布，以及 JSON 输出与 CI/CD 用法。

主要功能

  1. 01创建和更新发布
  2. 02删除发布
  3. 03查看发布并下载资源
  4. 04以 JSON 返回列表和详情
  5. 05在 GitLab CI/CD 中使用作业令牌

适用场景

  1. 01在 GitLab CI/CD 中自动创建发布
  2. 02为 Agent 获取 JSON 格式的发布详情
  3. 03下载 GitLab 发布中的资源

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/vince-winkintel/gitlab-cli-skills --skill glab-release

安装后在 Claude Code 中输入/glab-release确认已加载。

附带文件references/commands.md

详细介绍

glab release

资源传输

发布下载会识别同一实例上的 Markdown 上传资源 URL，并通过已认证的 API 获取资源，包括项目 ID 和命名空间/项目上传路径。请使用预期的主机和身份；不要通过在 URL 中暴露令牌来绕过身份验证失败。资源上传可能并行进行，因此请核实最终发布资源，而不要依赖上传完成顺序。

概览


  Manage GitLab releases.
  USAGE
    glab release <command> [command] [--flags]
  COMMANDS
    create <tag> [<files>...] [--flags]  Create a new GitLab release, or update an existing one.
    delete <tag> [--flags]               Delete a GitLab release.
    download [<tag>] [--flags]           Download asset files from a GitLab release.
    list [--flags]                       List releases in a repository.
    upload <tag> [<files>...] [--flags]  Upload release asset files or links to a GitLab release.
    view [<tag>] [--flags]               View information about a GitLab release.
  FLAGS
    -h --help                            Show help for this command.
    -R --repo                            Select another repository. Can use either `OWNER/REPO` or `GROUP/NAMESPACE/REPO` format. Also accepts full URL or Git URL.

快速开始

glab release --help

结构化输出

glab release list 和 glab release view 支持 --output json / -F json，用于生成结构化输出，便于 Agent 自动化。

glab release create 和 glab release update 中的 --notes 和 --notes-file 均为可选参数。

glab release view 和 glab release download 中的标签为可选参数；省略标签即可指定最新发布。对于注重可复现性的发布自动化，请传入明确的标签。

# List releases with JSON output
glab release list --output json
glab release list -F json

# View a release with JSON output
glab release view v1.2.0 --output json
glab release view v1.2.0 -F json

# Create a release without notes
glab release create v1.2.0

# Update a release without notes
glab release update v1.2.0 --name "My Release"

在 GitLab CI/CD 中创建发布

对于流水线作业，建议使用预定义的 CI_JOB_TOKEN 配合 glab CI 自动登录；有关通用机制和环境变量优先级，请参阅 glab-auth。Releases API 会在 JOB-TOKEN 请求头中接受此凭据：

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 会拒绝将作业令牌用于此请求，并可能返回 404 Not Found。当作业令牌的访问权限不足时，请通过 GITLAB_TOKEN 使用获批的项目或群组访问令牌，并授予 api 范围；切勿打印该令牌。

子命令

完整的 --help 输出请参阅 references/commands.md。

评论

支持 Markdown