用途:通过 glab 命令行管理 GitLab 容器镜像仓库的仓库与标签,用于列表、查看、删除镜像仓库或标签,以及清理旧标签。需注意:仓库 ID 来自 registry repository list/view 的输出,而非 Git 仓库的项目 ID。
主要能力:列出当前项目、其他项目(-R/--repo)或群组(--group)的镜像仓库,可加 --include-tags-count 与 --include-tags;用 --output json 与 --jq 输出便于自动化。查看仓库(repository view,可加 --include-tags);删除仓库及其全部镜像与标签(repository delete,破坏性)。标签列表(tag list)支持 -R 与 --details 显示 digest、大小和创建时间;查看单个标签 tag view;删除单个标签 tag delete。别名包括 repository ls/show/del 与 tag ls/show/del。
必要用法示例: glab container-registry repository list --group gitlab-org glab container-registry repository view <repository-id> --include-tags glab container-registry tag list <repository-id> --details glab container-registry tag delete <repository-id> <tag-name> --yes glab container-registry tag delete <repository-id> --name-regex-delete '^release-.' --yes glab container-registry tag delete <repository-id> --name-regex-delete '.' --keep-n 10 --older-than 30d --yes glab container-registry tag delete <repository-id> --name-regex-delete '.*' --name-regex-keep '^stable$|^latest$' --yes
批量标签清理标志:--name-regex-delete、--name-regex-keep、--keep-n、--older-than(如 7d、1month)。批量删除由 GitLab 异步调度,匹配标签可能在后台任务完成前仍可见。
安全提示:仓库与标签删除为破坏性操作,未确认目标 ID 与正则时不要加 --yes;脚本中建议用 --output json 与 --jq 而非解析表格;在目标项目检出目录外运行时使用 -R/--repo。命令概要见 references/commands.md。