Delete image tag from Github Container Registry

pluma · February 1, 2021, 2:29pm

I’m using the new GHCR and generating docker images for pull requests so I can deploy to a staging environment per-PR. This works great using GitHub actions but I can’t find a way to delete the generated image tags when a PR is merged.

Based on the Docker Registry API spec it looks like I would need to fetch the manifest digest for the given tag and then delete the manifest. But trying to do this via the GHCR API gives me UNSUPPORTED.

The GHCR doc*mentation only describes the process of manually deleting an image and indicates that it may be added to the GraphQL API in the future.

Is there currently a way to delete image tags via code? If not, is this going to be part of the GA release?

EDIT: I had to censor the word “doc*mentation” because the word filter complained that my post has the word “c*m” in it. I guess someone wasn’t aware of the Sc*nthorpe problem (yeah, that triggers it too).

pluma · February 22, 2021, 11:24am

I think the correct solution for the moment is to use the GitHub REST API and delete the container type package with the container name. I haven’t tried this yet, but it works for the older docker type containers (although unintuitively the API doesn’t use the repo name as apparently that’s not actually part of the package name).

airtower-luna · March 3, 2021, 1:19pm

The API for that was added very recently:

I’ve tried the API with a script to clean up old untagged versions, maybe you can get some inspiration from there:

github.com

airtower-luna/hello-ghcr/blob/e17ebc574711f4bcf85f8bd6b2380e226901778d/ghcr-prune.py

#!/usr/bin/python3
# PYTHON_ARGCOMPLETE_OK
import argparse
import dateutil.parser
import getpass
import os
import requests
from datetime import datetime, timedelta

__author__ = "Fiona Klute"
__version__ = "0.1"
__copyright__ = "Copyright (C) 2021 Fiona Klute"
__license__ = "MIT"

# GitHub API documentation: https://docs.github.com/en/rest/reference/packages
github_api_accept = 'application/vnd.github.v3+json'


if __name__ == "__main__":
    parser = argparse.ArgumentParser(

This file has been truncated. show original

pluma · February 22, 2021, 1:49pm

That explains why I didn’t find it when I first checked. Looks like it’s still not possible to do this via the Docker (ghcr.io) API though. At least with the rest API I can do this alongside the other post-PR cleanup stuff.

mr-linch · May 20, 2021, 11:57am

If you need delete images by tag you can checkout our action

saheerb · June 11, 2021, 11:22am

I can delete the image using the APIs, is there anyway to just delete the tag?