gitlab-release

Release 技能

使用 glab CLI 执行 GitLab 发布操作。

快速参考

操作	命令	风险
列出发布版本	glab release list	-
查看发布版本	glab release view <tag>	-
创建发布版本	glab release create <tag>	⚠️
上传资源	glab release upload <tag> <files>	⚠️
下载资源	glab release download <tag>	-
删除发布版本	glab release delete <tag>	⚠️⚠️

风险说明：- 安全 | ⚠️ 谨慎 | ⚠️⚠️ 警告 | ⚠️⚠️⚠️ 危险

何时使用此技能

始终在以下情况下使用：

• 用户想要处理发布版本
• 用户提到“发布版本”“版本”“变更日志”“标签”（用于发布）
• 用户想要发布或分发软件版本

以下情况切勿使用：

• 用户想要直接管理 git 标签（使用 git 命令）
• 用户想要执行 CI/CD 操作（改用 gitlab-ci）

可用命令

列出发布版本

glab release list [options]

选项：

标志	说明
-P, --per-page=<n>	每页结果数
--all	获取所有发布版本

示例：

# List all releases
glab release list

# List with more results
glab release list --per-page=50

查看发布详情

glab release view <tag> [options]

选项：

标志	说明
-w, --web	在浏览器中打开发布页面

示例：

# View release details
glab release view v1.0.0

# Open release in browser
glab release view v1.0.0 --web

创建发布版本

glab release create <tag> [options]

选项：

标志	说明
-n, --notes=<notes>	发布说明
-F, --notes-file=<file>	从文件读取发布说明
-N, --name=<name>	发布名称（默认为标签）
-r, --ref=<ref>	创建标签所依据的 Git 引用（标签不存在时）
-a, --assets-links=<json>	资源链接的 JSON 数组
--milestone=<titles>	要关联的里程碑标题

示例：

# Create simple release
glab release create v1.0.0

# Create with release notes
glab release create v1.0.0 -n "## What's New
- Feature A
- Bug fix B"

# Create with notes from file
glab release create v1.0.0 -F CHANGELOG.md

# Create with name and milestone
glab release create v1.0.0 -N "Version 1.0.0" --milestone="Sprint 5"

# Create from specific commit
glab release create v1.0.0 -r abc123def

上传资源

glab release upload <tag> <file>... [options]

将文件作为发布资源上传。

示例：

# Upload single file
glab release upload v1.0.0 ./dist/app.zip

# Upload multiple files
glab release upload v1.0.0 ./dist/*.tar.gz

# Upload with custom name
glab release upload v1.0.0 ./build/app.exe#windows-binary

下载资源

glab release download <tag> [options]

选项：

标志	说明
-D, --dir=<dir>	下载目录
-n, --asset-name=<name>	按名称下载指定资源

示例：

# Download all assets
glab release download v1.0.0

# Download to specific directory
glab release download v1.0.0 -D ./downloads/

# Download specific asset
glab release download v1.0.0 -n "app.zip"

删除发布版本

glab release delete <tag> [options]

选项：

标志	说明
-y, --yes	跳过确认
--with-tag	同时删除关联的标签

**警告：**此操作会永久删除该发布版本。

示例：

# Delete release (prompts for confirmation)
glab release delete v1.0.0

# Delete release and tag
glab release delete v1.0.0 --with-tag

# Delete without confirmation
glab release delete v1.0.0 --yes

常见工作流

工作流 1：标准发布

# 1. Ensure all changes are merged
glab mr list --state=opened

# 2. Verify CI passes
glab ci status --branch=main

# 3. Create release with changelog
glab release create v1.2.0 -F CHANGELOG.md -N "Version 1.2.0"

# 4. Upload binaries
glab release upload v1.2.0 ./dist/*

工作流 2：预发布

# Create pre-release version
glab release create v2.0.0-beta.1 \
  -n "Beta release for testing. Not for production use."

工作流 3：热修复发布

# 1. Create release from hotfix branch
glab release create v1.0.1 -r hotfix/critical-fix \
  -n "Hotfix release:
- Fixed critical security issue"

# 2. Upload patched binaries
glab release upload v1.0.1 ./dist/*

发布说明最佳实践

按以下结构编写发布说明：

## What's New
- Feature descriptions

## Bug Fixes
- Fix descriptions

## Breaking Changes
- Migration notes

## Contributors
- @username

故障排除

问题	原因	解决方案
身份验证失败	令牌无效或已过期	运行 glab auth login
标签已存在	发布版本重复	使用不同的标签或删除现有标签
找不到发布版本	标签无效	使用 glab release list 验证标签
上传失败	找不到文件	检查文件路径是否存在

相关文档

• 安全防护措施
• 快速参考