glab-packages

glab packages

GitLab プロジェクトのパッケージレジストリ内のパッケージを一覧表示し、汎用パッケージファイルをアップロード／ダウンロードし、ID を指定してパッケージレジストリのエントリーを削除します。

glab packages list / ls は、プロジェクトのパッケージレジストリを一覧表示します。現在のコマンドには、汎用パッケージのアップロードに使う upload / ul、ダウンロードに使う download / dl、および数値 ID を指定したパッケージの削除に使う delete / rm も含まれます。

クイックスタート

# List all packages in the current project
glab packages list

# Alias
glab packages ls

# List packages from another project
glab packages list -R owner/repo

# Upload a file as a generic package version
glab packages upload ./build/app.zip --name my-package --version 1.0.0

# Download a generic package file
glab packages download --name my-package --version 1.0.0 --filename app.zip

# Delete a package by numeric ID after listing packages
glab packages delete 12345 --yes

フィルタリング

# Filter by package name substring
glab packages list --name my-package

# Filter by package type
glab packages list --package-type npm
glab packages list --package-type maven
glab packages list --package-type generic

glab のヘルプでサポートされているパッケージタイプ：

composer, conan, debian, generic, golang, helm, maven, npm, nuget, pypi, terraform_module

ページネーションと自動化

# Select a page and page size
glab packages list --page 2 --per-page 10

# JSON output filtering is available through the global --jq support on this command
glab packages list --jq '.[].name'

対象プロジェクトの Git チェックアウト外で実行する場合は、-R/--repo を使用してください。スクリプトでは、テキストの表を解析するのではなく、構造化出力／--jq の使用を推奨します。

汎用パッケージファイルをアップロードする

# Upload a local file under its original filename
glab packages upload ./build/app.zip --name my-package --version 1.0.0

# Store the uploaded file under a different package filename
glab packages upload ./build/app.zip --name my-package --version 1.0.0 --filename release.zip

# Alias and explicit target project
glab packages ul ./build/app.zip -n my-package --version 1.0.0 -R owner/repo

アップロードしたファイルは、対象プロジェクトのパッケージレジストリに汎用パッケージとして保存されます。--name と --version は必須です。--filename の既定値は、ローカルファイルのベース名です。対象プロジェクトのチェックアウト外からアップロードする場合は、-R/--repo を使用してください。

汎用パッケージファイルをダウンロードする

# Download a package file to the current directory
glab packages download --name my-package --version 1.0.0 --filename app.zip

# Download into a directory, keeping the original file name
glab packages download -n my-package --version 1.0.0 --filename app.zip --path ./downloads/

# Download to an exact path, renaming the file
glab packages download -n my-package --version 1.0.0 --filename app.zip --path ./downloads/renamed.zip

# Download to an absolute path (missing parent directories are created)
glab packages download -n my-package --version 1.0.0 --filename app.zip --path /tmp/downloads/app.zip

# Skip checksum verification only when you intentionally accept the integrity risk
glab packages download -n my-package --version 1.0.0 --filename app.zip --no-verify

# Alias, overwrite an existing target, and explicit project targeting
glab packages dl -n my-package --version 1.0.0 --filename app.zip --force -R owner/repo

ダウンロードできるのは汎用パッケージファイルに限られ、--name、--version、--filename が必要です。既定では、glab はダウンロードしたファイルをレジストリのチェックサムメタデータと照合して検証し、保存先がすでに存在する場合は失敗します。相対パスまたは絶対パスのディレクトリ／出力ファイル名を指定するには --path を使用してください。glab は存在しない親ディレクトリを作成します。上書きするには --force を使用してください。チェックサム検証を意図的に省略する場合に限り、--no-verify を使用してください。

パッケージを削除する

# Find the package ID first
glab packages list --name my-package

# Delete by numeric package ID; prompts for confirmation
glab packages delete 12345

# Skip confirmation for automation after independently confirming the ID
glab packages delete 12345 --yes

# Alias
glab packages rm 12345

削除では、パッケージ名／バージョンではなく、パッケージの数値 ID を指定します。glab packages list（スクリプトでは JSON／--jq の使用を推奨）で ID を特定してから、対象のパッケージを確認した場合に限り --yes を指定してください。

リファレンス

コマンドの概要とフラグについては、references/commands.md を参照してください。