From 94b87624ad9f148bdc22909fbeb9b4cc97c4fce3 Mon Sep 17 00:00:00 2001 From: ColorfulRhino <131405023+ColorfulRhino@users.noreply.github.com> Date: Mon, 8 Jul 2024 22:54:11 +0000 Subject: [PATCH] Update `ORAS_VERSION` to 1.2.0 --- changelog.txt | 91 +++++++++++++++++++++++++++++++ lib/functions/general/oci-oras.sh | 2 +- 2 files changed, 92 insertions(+), 1 deletion(-) create mode 100644 changelog.txt diff --git a/changelog.txt b/changelog.txt new file mode 100644 index 000000000000..4878ecee1a2e --- /dev/null +++ b/changelog.txt @@ -0,0 +1,91 @@ +changelog=## New Features + +- `oras` is compliant with OCI [image-spec v1.1.0](https://github.com/opencontainers/image-spec/blob/v1.1.0) and [distribution-spec v1.1.0](https://github.com/opencontainers/distribution-spec/tree/v1.1.0) +- Introduce brand-new default terminal experience + - Show live progress for the following commands: + - `oras copy` + - `oras pull` + - `oras push` + - `oras attach` + - `oras blob fetch` + - `oras blob push` + - The new terminal experience can be turned off via the preview flag `--no-tty` +- Support deletion of manifests and blobs in OCI image layout +- Support X.509 mTLS authentication with OCI registries + +## Preview Features + +- **BREAKING CHANGE** Registries supporting `Referrers API` prior to [distribution-spec v1.1.0-rc4](https://github.com/opencontainers/distribution-spec/tree/v1.1.0-rc4) will fall back to `Referrers tag schema`, causing unexpected results of `oras attach` and `oras discover` commands +- Introduce `--platform` to `oras attach` for better multi-arch attaching experience, which allows adding referrer artifact to a specific sub-platform +- Re-purpose the flag `--recursive` of `oras cp` from [extended copy](https://oras.land/docs/client_libraries/overview#extended-copy) to copy an artifact or a multi-arch image and its referrers +- Promote `--image-spec` to a preview flag from experimental + +## Experimental Features + +- **BREAKING CHANGE** `oras discover` shows `tree` view output by default +- Introduce formatted output via `--format` by implementing the [specification](https://github.com/oras-project/oras/blob/v1.2.0/docs/proposals/formatted-output.md) + - Formatted output is available to the following commands: + - `oras pull` + - `oras push` + - `oras attach` + - `oras discover` + - `oras manifest fetch` + - Examples: + - `--format json` to print operation result as a JSON object + - `--format "go-template={{ .digest }}"` to print the digest of the manifest using [Go template](https://pkg.go.dev/text/template) + - Template can also be specified by `--template` +- Introduce `oras resolve` to get the digest of an artifact + +## Deprecation + +- `oras discover`: `--output` is marked as deprecated and succeeded by `--format` + +## Bug Fixes + +- Fix #1079: Snaps build cannot read default credentials file +- Fix #1096: Mixed request number in the debug mode +- Fix #1106: Flag `--plain-http=false` does not work for local registries +- Fix #1129: `oras cp -r` fails if index has a child manifest as subject +- Minor fixes + +## Other Changes + +- Improve UX + - `oras discover`: show placeholder when `artifactType` is not presented in an index referrer + - `oras push`: show artifact type when pushing files + - Improve error message based on [ORAS CLI error handling guildline](https://github.com/oras-project/oras/blob/v1.2.0/docs/proposals/error-handling-guideline.md) + - Improve identity token input by a new flag `--identity-token` to replace `--password` without `--username` +- Improve performance + - Reduce authentication request count for`oras copy`, `oras manifest delete`, and `oras blob delete` + - Support blob mounting across repositories in the same registry for `oras copy` +- Update dependencies +- Update to Golang `1.22.3` +- Minor security enhancements + +------ + +# What's Changed Since RC.1 + +## Other Changes + +- Improve documentation +- Update dependencies + +## Detailed Commits +* bump: tag and release ORAS CLI v1.2.0-rc.1 by @qweeah in https://github.com/oras-project/oras/pull/1381 +* fix: remove non-classic snap plugins by @qweeah in https://github.com/oras-project/oras/pull/1383 +* fix: oras cp documentation by @TerryHowe in https://github.com/oras-project/oras/pull/1384 +* build(deps): bump actions/checkout from 3 to 4 by @dependabot in https://github.com/oras-project/oras/pull/1385 +* refactor: Get rid of deprecated PrintStatus method by @TerryHowe in https://github.com/oras-project/oras/pull/1378 +* build(deps): bump github.com/onsi/ginkgo/v2 from 2.17.3 to 2.18.0 in /test/e2e by @dependabot in https://github.com/oras-project/oras/pull/1388 +* build(deps): bump github.com/onsi/ginkgo/v2 from 2.18.0 to 2.19.0 in /test/e2e by @dependabot in https://github.com/oras-project/oras/pull/1390 +* chore: Remove deprecated PrintStatus method by @TerryHowe in https://github.com/oras-project/oras/pull/1389 +* doc: verify local files by @qweeah in https://github.com/oras-project/oras/pull/1386 +* fix: remove call to deprecated print by @TerryHowe in https://github.com/oras-project/oras/pull/1392 + + +**Full Changelog**: https://github.com/oras-project/oras/compare/v1.2.0-rc.1...v1.2.0 + +## Notes + +This release was signed with `46D3 369B 393F 6F82 71FD 1CE8 F86E C70D 2B0C 404F` (@qweeah's GPG key) which can be found [here](https://github.com/qweeah.gpg). diff --git a/lib/functions/general/oci-oras.sh b/lib/functions/general/oci-oras.sh index 19eb88c4c136..b84e358f36de 100644 --- a/lib/functions/general/oci-oras.sh +++ b/lib/functions/general/oci-oras.sh @@ -9,7 +9,7 @@ function run_tool_oras() { # Default version - ORAS_VERSION=${ORAS_VERSION:-0.16.0} # https://github.com/oras-project/oras/releases + ORAS_VERSION=${ORAS_VERSION:-} # https://github.com/oras-project/oras/releases #ORAS_VERSION=${ORAS_VERSION:-"1.0.0-rc.1"} # https://github.com/oras-project/oras/releases declare non_cache_dir="/armbian-tools/oras" # To deploy/reuse cached ORAS in a Docker image.