Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Support showing more information of tags in formatted output #1547

Open
1 task
FeynmanZhou opened this issue Nov 26, 2024 · 1 comment
Open
1 task

Support showing more information of tags in formatted output #1547

FeynmanZhou opened this issue Nov 26, 2024 · 1 comment
Labels
enhancement New feature or request experimental Issues or pull requests depending on WIP specs question Further information is requested spec required Issues that require specifications
Milestone

Comments

@FeynmanZhou
Copy link
Member

What is the version of your ORAS CLI

v1.2.0

What would you like to be added?

When listing the tags in an OCI image layout or an repo within OCI registry. The digest and platform information can be listed alongside the tags in the output.

$ oras repo tags --oci-layout layout-dir --format json
{
  "reference": "localhost:5000/oras@sha256:7414904f07f515f48fe4afeaf876e3151039a81e7177b9c66e9e7ed6dd186111",
  "tags": [
    {
      "tag": "v1"
      "digest": "sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "mediaType": "application/vnd.oci.image.index.v1+json",
      "size": 820
    },
     {
      "tag": "v1-linux-amd64"
      "digest": "sha256:yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "size": 200
    },
    {
      "tag": "v1-linux-arm64"
      "digest": "sha256:zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz",
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "size": 200
    },
  ]
}

Why is this needed for ORAS?

  • With the media type of each tag showing in the formatted output, users should be able to differentiate from an image index and image manifest in a repo
  • Easier to users to list all available tags with their descriptor in a repo, so that users can compose an image index by selecting from a few arch-specific tags
  • For scripting and automation scenario

Are you willing to submit PRs to contribute to this feature?

  • Yes, I am willing to implement it.
@FeynmanZhou FeynmanZhou added enhancement New feature or request triage New issues or PRs to be acknowledged by maintainers labels Nov 26, 2024
@FeynmanZhou FeynmanZhou added this to the v1.3.0-beta.2 milestone Nov 27, 2024
@FeynmanZhou FeynmanZhou added spec required Issues that require specifications and removed triage New issues or PRs to be acknowledged by maintainers labels Nov 27, 2024
@shizhMSFT shizhMSFT added question Further information is requested experimental Issues or pull requests depending on WIP specs labels Jan 21, 2025
@shizhMSFT shizhMSFT modified the milestones: v1.3.0-beta.2, v1.3.0 Jan 21, 2025
@shizhMSFT
Copy link
Contributor

Besides the output formatting minor issues, there is a perf concern: if a repo has hundreds of tags, this command will appear to hang without any response.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request experimental Issues or pull requests depending on WIP specs question Further information is requested spec required Issues that require specifications
Projects
None yet
Development

No branches or pull requests

2 participants