glab-release について
glab-releaseは、glabのコマンドラインでGitLabリリースを管理する手順を扱います。作成、更新、削除、表示、アセットのダウンロードに加え、JSON出力やCI/CDでの自動化方法も説明します。
主な機能
- 01リリースの作成と更新
- 02リリースの削除
- 03リリース表示とアセット取得
- 04一覧・詳細のJSON出力
- 05GitLab CI/CDでのジョブトークン利用
活用シーン
- 01GitLab CI/CDでリリースを自動作成
- 02エージェント用にリリース情報をJSON取得
- 03GitLabリリースからアセットをダウンロード
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ vince-winkintel/ gitlab-cli-skills --skill glab-releaseインストール後、Claude Code で/glab-releaseを入力して読み込まれたか確認します。
同梱ファイルreferences/commands.md
詳細
翻訳後に原文が更新されています。最新の内容は原文をご確認ください。
glab release
概要
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 をサポートしています。
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 でリリースを作成する
パイプラインジョブでは、glab の CI 自動ログインを利用して、事前定義された CI_JOB_TOKEN を使用してください。一般的な仕組みと環境変数の優先順位については、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」が表示されることがあります。ジョブトークンでアクセスが不十分な場合は、api スコープを持つ、承認済みのプロジェクトまたはグループのアクセストークンを GITLAB_TOKEN で使用してください。そのトークンを表示してはいけません。
サブコマンド
--help の出力全体については、references/commands.md を参照してください。