gitlab-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>	⚠️⚠️

リスクの凡例：- 安全 | ⚠️ 注意 | ⚠️⚠️ 警告 | ⚠️⚠️⚠️ 危険

このスキルを使用する場合

必ず使用する場合：

• ユーザーがリリース関連の操作を希望している
• ユーザーが「release」、「version」、「changelog」、「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 ref
-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 でタグを確認
アップロードに失敗する	ファイルが見つからない	ファイルパスが存在することを確認

関連ドキュメント

• 安全対策
• クイックリファレンス