Expose Image Tags in Pulp Container Distribution / CLI

[VrindaMarwah]

When storing container images in Pulp, a distribution URL is created that exposes the image name and base path, but it does not indicate which tag(s) are associated with that image.

Currently:

• pulp container distribution commands only show the image base path.
  The only way to view tags is via the API endpoint to list all tags, but this does not clearly indicate which tag corresponds to which image digest (See below image for reference):

• There is no CLI command to directly list synced image:tag combinations in Pulp.

This makes it difficult to:

• Identify which tags have been synced

• Correlate images with their tags

One of the following (or similar) enhancements would greatly improve usability:

Expectation: Extend the container distribution output to include the associated image tag(s) or introduce a new Pulp container CLI command to list synced images in the form of :

This feature would improve traceability of container content.

[gerrod3]

I agree we should add more filters to the CLI to make it more useful. Since images are separated by repository in pulp-container you can actually find what tags are available for an image by doing the following lookups:

1. Find the backing repository version for a distribution
2. Search the tag content endpoint with the repository version filter

e.g.

pulp container distribution show --name image/name | jq .repository
pulp container repository show --href $repo_href | jq .latest_version_href
pulp show --href /pulp/api/v3/content/container/tags/?repository_version=$repo_ver_href

The final command should really be something like pulp container content -t tag list --repository-version $repo_ver_href but we don't have the filter support in the CLI yet. Maybe we could even add a --distribution filter to do the repository version lookup for you.

Note you could also use a tool like skopeo to do the tag listing, it calls the V2 apis for you to find the available tags:

skopeo list-tags docker://pulphost.io/image/base/path

[VrindaMarwah]

Thank you @gerrod3 for the inputs. The pulp commands given above work well for my use case.