Support customizing file name in oras pull

[FeynmanZhou]

What is the version of your ORAS CLI

v1.1.0

What would you like to be added?

Currently, oras pull saves the artifact with the name of the file that is stored in the annotations of the manifest. However, this makes it hard to find the file after pulling the file to local since users will need to go figure out what the annotation is and search for the file name, eventually find the file with the annotation as a reference. This is really cumbersome for users or for machines to find a pulled file.

In some cases, if the artifact that has multiple layers, we need to provide an option that allows to give file names to multiple pulled files. We will need to define the flags and experience to cover sing-layer and multi-layer scenarios.

Why is this needed for ORAS?

It would be much convenient if there is an option that points to a file (instead of a folder) and save the file with a given name, so users can easily find and use the pulled file for other operations later. This will be efficient and helpful in the automation or CI/CD scenario.

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

• [ ] Yes, I am willing to implement it.

[qweeah]

Putting it to future to avoid being marked as stale.

[qweeah]

This looks similar to https://github.com/oras-project/oras/issues/346. +@ndeloof who helped raise the issue.

[FeynmanZhou]

Maintainers suggested moving this issue to v1.3.0 milestone per discussion on Nov 7, 2023