v0.14.0

🚀 ORAS CLI v0.14.0 is available! You can install it by following this guide.

New Features

• New command sets
  • oras attach: [Preview] Attach files to an existing artifact
  • oras discover: [Preview] Discover referrers of a manifest in the remote registry
  • oras copy: [Preview] Copy artifacts from one target to another
  • oras manifest fetch: [Preview] Fetch manifest of the target artifact
• New options for oras push
  • Add ability to export manifest after pushing artifacts by --export-manifest <path>
  • Add --artifact-type to set the media type of the manifest config for OCI manifests
  • Add --annotation <key>=<value> option for easier specifying manifest annotations
• New options for oras pull
  • Support pulling arbitrary manifest config

Bug Fixes

• fix: oras doesn't push a file with 2 tags #447
• fix: push error for ECR: PUT request body is not rewindable #456
• fix: can't pull behind proxy on version 0.13.0 #513

Breaking Changes

• Renamed option --manifest-annotations to --annotation-file for all applicable commands
• Renamed option --manifest-config to --config while --config is renamed to --registry-config for all commands

Other Changes

• Improved documentation
• Updated oras-go to v2.0.0-rc.2
  • oras push uploads empty config blob of size 0 bytes instead of {} (empty JSON object of size 2 bytes)
• Migrated to codecov.io for code coverage reports
• Improved performance for oras pull when ORAS_CACHE is set
• Bumped golang version to 1.19
• Improved UX output

Detailed Commits

• Merging artifacts Branch: Add exporting manifest option for push by @qweeah in #425
• Update ghcr package action yaml by @qweeah in #422
• Merging artifacts Branch: Add discover comand by @qweeah in #419
• fix: update help msg description about pullCmd() by @junczhuMSFT in #438
• If no tag or digest specified when pulling, return error by @qweeah in #440
• feat: add copyCmd() by @junczhuMSFT in #432
• Add empty reference checking for discover cmd by @qweeah in #442
• Add attach command by @qweeah in #433
• Fix retagging failure with updated oras-go by @qweeah in #452
• Bump github.com/sirupsen/logrus from 1.8.1 to 1.9.0 by @dependabot in #451
• Migrate to codecov.io by @junczhuMSFT in #450
• Fix push error for ECR by @qweeah in #462
• feat: use --artifact-type to change the media type of the config blob by @yuehaoliang-microsoft in #482
• Adding support for windows-arm64 by @koushdey in #457
• perf: add FetchReference support in the caching proxy by @qweeah in #464
• fix(lang): update misspelling in copy.go by @junczhuMSFT in #487
• Bump to golang 1.19 by @sajayantony in #488
• fix: refill missing status for push copy and attach by @qweeah in #481
• feat!: pass annotations as a string by @junczhuMSFT in #468
• feat: Support pulling arbitrary manifest config by @lizMSFT in #480
• refactor: move error to cmd internal packages by @qweeah in #496
• feat: add fetch command to get manifest of an artifact by @qweeah in #449
• fix: add new line to prettify manifest fetch result by @qweeah in #499
• refactor: improve error message on platform mismatch by @lizMSFT in #500
• fix: add empty check on blobs and manifest annotation by @jasminetMSFT in #490
• refactor!: rename the --manifest-config to --config by @lizMSFT in #504
• fix: fix the lookup check for registry-config option by @lizMSFT in #505
• refactor: add pre-defined annotation keys into option.Packer by @junczhuMSFT in #502
• refactor: reuse print status func by @qweeah in #507
• docs: add doc comments for the loop of successors by @wangxiaoxuan273 in #508
• fix: check if configPath is empty before writing to Annotations by @wangxiaoxuan273 in #509
• feat: print digest and media type when content is skipped using sync.Map by @wangxiaoxuan273 in #510
• fix: print post-copy logs for unnamed content in verbose mode by @wangxiaoxuan273 in #511
• fix: enable proxy in auth by @qweeah in #514
• doc: fix typo in long description by @qweeah in #516
• bump: update version to release 0.14.0 by @qweeah in #515
• fix!: rename the --manifest-config to --config for push command by @lizMSFT in #517
• doc: update example doc by @qweeah in #518

New Contributors

• @junczhuMSFT made their first contribution in #438
• @yuehaoliang-microsoft made their first contribution in #482
• @koushdey made their first contribution in #457
• @lizMSFT made their first contribution in #480
• @jasminetMSFT made their first contribution in #490
• @wangxiaoxuan273 made their first contribution in #508

Full Changelog: v0.13.0...v0.14.0

Notes

This release was signed with 95BB 6CD4 6CA3 0D2B 9CAE E56C 9F2C D437 A97D CB8F (@shizhMSFT's GPG key) which can be found here.