GitLabgitlab-org

cli

main
ply8 git calls204 ms98 KiB6 cachedprotocol v2
76 lines2.6 KiBRaw

Delete container registry tags.

Synopsis

Delete one container registry tag by name, or delete matching tags in bulk by filter.

Deleting a single tag is synchronous. Bulk deletion is scheduled asynchronously by GitLab; matching tags may remain visible until the background deletion job has completed.

To bulk delete tags, omit <tag-name> and provide at least one bulk deletion flag: --name-regex-delete, --name-regex-keep, --keep-n, or --older-than.

The repository ID must belong to the selected project. Use -R/--repo to specify the owning project when running this command outside that project's Git checkout.

plaintext
glab container-registry tag delete <repository-id> [<tag-name>] [flags]

Aliases

plaintext
del

Examples

console
# Delete a container registry tag with a confirmation prompt
glab container-registry tag delete 123 latest

# Skip the confirmation prompt
glab container-registry tag delete 123 latest --yes

# Schedule tags matching a regular expression for deletion
glab container-registry tag delete 123 --name-regex-delete '^release-.*' --yes

# Schedule old tags for deletion, but keep the 10 most recent matching tags
glab container-registry tag delete 123 --name-regex-delete '.*' --keep-n 10 --older-than 30d --yes

# Delete a container registry tag in another project
glab container-registry tag delete 123 latest -R gitlab-org/cli

Options

plaintext
      --keep-n int                 Keep the latest N matching tags. Bulk deletion only; scheduled asynchronously.
      --name-regex-delete string   Regular expression for tag names to delete. Bulk deletion only; scheduled asynchronously.
      --name-regex-keep string     Regular expression for tag names to keep. Bulk deletion only; scheduled asynchronously.
      --older-than string          Delete tags older than the given duration, such as 7d or 1month. Bulk deletion only; scheduled asynchronously.
  -y, --yes                        Skip the confirmation prompt.

Options inherited from parent commands

plaintext
  -h, --help          Show help for this command.
  -R, --repo string   Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.
1---
2title: '`glab container-registry tag delete`'
3stage: AI Clients
4group: Developer Clients
5info: To determine the technical writer assigned to the Stage/Group associated with this page, see <https://handbook.gitlab.com/handbook/marketing/product-and-technical-marketing/technical-writing/#assignments>
6---
8<!--
9This documentation is auto generated by a script.
10Please do not edit this file directly. Run `make gen-docs` instead.
11-->
13Delete container registry tags.
15## Synopsis
17Delete one container registry tag by name, or delete matching tags in
18bulk by filter.
20Deleting a single tag is synchronous. Bulk deletion is scheduled
21asynchronously by GitLab; matching tags may remain visible until the
22background deletion job has completed.
24To bulk delete tags, omit <tag-name> and provide at least one bulk
25deletion flag: --name-regex-delete, --name-regex-keep, --keep-n, or
26--older-than.
28The repository ID must belong to the selected project. Use -R/--repo
29to specify the owning project when running this command outside that
30project's Git checkout.
32```plaintext
33glab container-registry tag delete <repository-id> [<tag-name>] [flags]
34```
36## Aliases
38```plaintext
39del
40```
42## Examples
44```console
45# Delete a container registry tag with a confirmation prompt
46glab container-registry tag delete 123 latest
48# Skip the confirmation prompt
49glab container-registry tag delete 123 latest --yes
51# Schedule tags matching a regular expression for deletion
52glab container-registry tag delete 123 --name-regex-delete '^release-.*' --yes
54# Schedule old tags for deletion, but keep the 10 most recent matching tags
55glab container-registry tag delete 123 --name-regex-delete '.*' --keep-n 10 --older-than 30d --yes
57# Delete a container registry tag in another project
58glab container-registry tag delete 123 latest -R gitlab-org/cli
59```
61## Options
63```plaintext
64 --keep-n int Keep the latest N matching tags. Bulk deletion only; scheduled asynchronously.
65 --name-regex-delete string Regular expression for tag names to delete. Bulk deletion only; scheduled asynchronously.
66 --name-regex-keep string Regular expression for tag names to keep. Bulk deletion only; scheduled asynchronously.
67 --older-than string Delete tags older than the given duration, such as 7d or 1month. Bulk deletion only; scheduled asynchronously.
68 -y, --yes Skip the confirmation prompt.
69```
71## Options inherited from parent commands
73```plaintext
74 -h, --help Show help for this command.
75 -R, --repo string Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.
76```
Diagnostics8 git calls · 204 ms
CallStatusSizeTime0204 ms
discover200185 B4 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=185
git.server.agent=git/2.56.g1891de4-Linux
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch server-option object-format
git.server.fetch=shallow wait-for-done filter
git.protocol.version=2
git.pkt.frames=9
git.pkt.data=7
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=185
git.pkt.payload.max=35
ls-refs20058 KiB · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=59849
git.response.cache=HIT
git.response.duration_ms=3
git.protocol.version=2
git.pkt.frames=731
git.pkt.data=730
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=59849
git.pkt.payload.max=143
git.ls_refs.count=730
git.ls_refs.head=refs/heads/main
fetchtree:0 · deepen 1020032 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=4
git.response.bytes=32926
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=22
git.pkt.data=20
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=32926
git.pkt.payload.max=32046
git.sideband.band1.bytes=32046
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=80
git.pack.bytes=32046
git.pack.ofs_delta=36
git.pack.ref_delta=0
git.pack.chain.max=2
git.pack.trailer=cb0bad5d7ffc514895d8b21c4dd470327f90bc91
git.pack.full=44
Open pack map
fetchcombine:blob:none+tree:2 · deepen 12004.2 KiB · hit4 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=4273
git.response.cache=HIT
git.response.duration_ms=4
git.fetch.filter=combine:blob:none+tree:2
git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9
git.fetch.haves.count=0
git.fetch.deepen=1
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=7
git.pkt.data=5
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=4273
git.pkt.payload.max=4173
git.sideband.band1.bytes=4173
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=11
git.pack.bytes=4173
git.fetch.wide.objects=11
git.fetch.wide.extra_bytes=3930
git.fetch.wide.blobs=0
fetchtree:02001.7 KiB · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=1744
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=tree:0
git.fetch.wants=5e4007a5673eb3bf5d0d7f1a1463c3b2ca3fb3bd
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1744
git.pkt.payload.max=1717
git.sideband.band1.bytes=1717
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=1717
git.pack.trailer=3f1b9ccc7756e8941d6705e8187c87fd922113e6
Open pack map
fetchtree:0200171 B · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=171
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=tree:0
git.fetch.wants=79f6694dff620bfe0b98edceec0299cad3c4cc70
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=171
git.pkt.payload.max=144
git.sideband.band1.bytes=144
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=144
git.pack.trailer=e83e8c6ad6525fbef223f49e88dfbdf4aa792eba
Open pack map
fetchtree:0200197 B · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=187
git.response.bytes=197
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=tree:0
git.fetch.wants=dd205a3ed0bbebf5d21d04b87f9510769e1a00cc
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=197
git.pkt.payload.max=170
git.sideband.band1.bytes=170
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=170
git.pack.trailer=3302e87e012588caf7fe0a1edb7cf009d886ab1e
Open pack map
fetch2001.1 KiB187 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1124
git.response.cache=MISS
git.response.duration_ms=187
git.fetch.wants=797f9b84df151fbcd28a2192b36ad17afd0bdecf
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1124
git.pkt.payload.max=1097
git.sideband.band1.bytes=1097
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://gitlab.com/gitlab-org/cli
Ref
refs/heads/main
Commit
0dd7574dce9e385c5c30540e6c15657adc6bdce9
cf-ray
a5e1eb093fae452a
Request
e8349a93…
Protocol
v2 · sha1
Agent
git/2.56.g1891de4-Linux
Filter
advertised
Fetch
shallow wait-for-done filter
Capabilities
agent ls-refs fetch server-option object-format