Changes since v1.3.6
Highlights
- ORAS now uses oras-go v3 (
github.com/oras-project/oras-go/v3v3.0.0) instead oforas.land/oras-go/v2(#2002)oras copycan use different credentials for the source and destination when both are on the same registry. Authentication is now cached per repository, not per registry host (fixes #1892)- Login works again for registries whose token realm is on another private-network host, such as self-hosted GitLab. Only loopback, link-local, unspecified and cloud-metadata realm addresses are blocked by default (fixes #2260)
Experimental
- Containers configuration support (#2002). Set
ORAS_EXPERIMENTAL_CONTAINERS_CONFIG=1and ORAS reads the container ecosystem configuration files from their default locations, as podman and buildah do. It is off by default, and nothing changes unless the variable is set.registries.conf: aliases, blocked registries, location rewrites, mirrors,insecure,token-flow,referrers-api,blocked-realm-prefixescerts.d: per-registry CA and client certificates (refs #2118)auth.json: credentials, checked after the ORAS credential store (skipped when--registry-configis given)policy.jsonandregistries.d: pull policy withsignedByverification- Command line flags such as
--plain-http,--insecure,--ca-file,--cert-file/--key-file,--distribution-specand-u/-poverride the files
Behavior changes
oras blob fetchandoras blob deletenow require a digest reference and reject tags (#2304, fixes #2303)- Custom header flags are now rejected for targets given with
--oci-layout-path,--from-oci-layout-pathor--to-oci-layout-path, as they already were for--oci-layout(#2299, fixes #2298) - For an untagged push,
oras push --format jsonno longer reports"referenceAsTags": ["<registry>/<repo>:"], and the go-template output no longer counts it as a tag (#2328)
Bug fixes
oras manifest fetch-config --outputworks again with/dev/stdout,/dev/fd/N, FIFOs and devices. It also keeps symlinks and respects umask and the existing file's permissions (#2227, fixes #2224, #2226)- The
ORAS_CACHEstore no longer keeps anindex.json, so several ORAS processes can safely share one cache directory (#2329, fixes #2312) --from-password,--to-password,--from-identity-tokenand--to-identity-tokennow show the warning about secrets on the command line. Secrets read with--password-stdinand--identity-token-stdinnow come from the command's input (#2331)- Fix panics in the TTY progress output when a status method is called before tracking starts.
oras copyTTY output now uses the right fetcher for successors (#2332) - The
oras discover --outputdeprecation message now names the format to use, for example--format json(#2297, fixes #2296) - The authentication cache now lasts only for one command and is no longer shared across the whole process (#2306, fixes #2305)
Release and packaging
- The
ghcr.io/oras-project/orasimage now has OCI image labels (org.opencontainers.image.source,version,revision, ...), so tools such as Renovate can find the changelog (#2300) - Snaps are released to the
stablechannel only. Pre-releases are no longer published to the snap store but are still on GitHub Releases (#2295, fixes #2294)
Dependencies
oras.land/oras-go/v2v2.7.0 →github.com/oras-project/oras-go/v3v3.0.0 (#2002)github.com/spf13/pflagv1.0.10 → v1.1.0 (#2322)go.yaml.in/yaml/v4v4.0.0-rc.6 → v4.0.0 (#2307, #2318, #2323)golang.org/x/syncv0.24.0 → v0.25.0 (#2326)golang.org/x/termv0.47.0 → v0.48.0 (#2334)- Container base images:
golang1.27.3-alpine (#2309) andalpine3.24.4 (#2301, #2336) - GitHub Actions and e2e test dependency updates (#2302, #2308, #2319, #2320, #2324, #2327)
Other
- Registry
Warningheaders are now logged with oras-go v3'sremote.NewWarningLogger(#2317, fixes #2314) - More unit tests for the push display handlers (#2293)
Full changelog: v1.3.6...v1.4.0
Changelog
- fdeb304 bump: tag and release ORAS CLI v1.4.0 (#2335)
- 53d0ce9 build(deps): bump library/alpine from 3.24.3 to 3.24.4 (#2336)
- 821dd38 fix: guard unstarted TTY tracking and pass fetcher to TTYCopyHandler (#2332)
- 7e2dcaf fix: warn on prefixed secret flags and read from cmd stdin (#2331)
- 2b62263 build(deps): bump golang.org/x/term from 0.47.0 to 0.48.0 (#2334)
- 02ffd9d fix: use oci.NewStorage for the ORAS_CACHE backing store (#2329)
- 917cfd9 fix: report no referenceAsTags for an untagged push (#2328)
- ab1ccb2 build(deps): bump the github-actions group across 1 directory with 4 updates (#2327)
- 5d9f7f8 build(deps): bump golang.org/x/sync from 0.24.0 to 0.25.0 (#2326)
- 0f52f9a build(deps): bump github.com/spf13/pflag from 1.0.10 to 1.1.0 (#2322)
- edfaa09 build(deps): bump go.yaml.in/yaml/v4 from 4.0.0-rc.9 to 4.0.0 in /test/e2e (#2324)
- 786e91d build(deps): bump go.yaml.in/yaml/v4 from 4.0.0-rc.9 to 4.0.0 (#2323)
- f111842 build(deps): bump github.com/onsi/ginkgo/v2 from 2.33.1 to 2.34.0 in /test/e2e (#2320)
- 15f74b4 build(deps): bump go.yaml.in/yaml/v4 from 4.0.0-rc.7 to 4.0.0-rc.9 in /test/e2e (#2319)
- caf3fbc build(deps): bump go.yaml.in/yaml/v4 from 4.0.0-rc.7 to 4.0.0-rc.9 (#2318)
- f5dbbde refactor: use remote.NewWarningLogger for registry warnings (#2317)
- 4fdee3b build(deps): bump go.yaml.in/yaml/v4 from 4.0.0-rc.6 to 4.0.0-rc.7 (#2307)
- efc60d2 build(deps): bump go.yaml.in/yaml/v4 from 4.0.0-rc.6 to 4.0.0-rc.7 in /test/e2e (#2308)
- f2eefc8 build(deps): bump library/golang from 1.27.2-alpine to 1.27.3-alpine (#2309)
- 3bf31fc fix: allow fetch-config --output to special files (#2227)
- 19a99d1 feat: migrate from oras-go v2 to v3 (#2002)
- 986ac88 refactor: scope auth cache to command invocation (#2306)
- 1cc414e test: verify push display handler calls (#2293)
- 2d47c2e fix: require digests for blob fetch and delete (#2304)
- b50ff65 build(deps): bump the github-actions group across 1 directory with 3 updates (#2302)
- 62ac3ad build(deps): bump library/alpine from 3.24.2 to 3.24.3 (#2301)
- 4962d0f feat: add oci image metadata (#2300)
- e168dfd fix: reject custom header flags for an OCI layout path target (#2299)
- bc7b32d fix: print the format in the discover --output deprecation message (#2297)
- e84a5d3 fix(ci): release snaps to stable only (#2295)
Verification
Release artifacts are signed with the ORAS project release key C6FC42F0DE84A345FAADB742F44418110791EF37. Signatures (.asc files) are attached to this release.
Public keys are available in the KEYS file.
Release archives and the checksums file also have GitHub build provenance attestations. Verify an archive with:
gh attestation verify oras_1.4.0_linux_amd64.tar.gz --repo oras-project/orasThe attestations are Sigstore bundles, so they can also be downloaded with gh attestation download and checked with cosign verify-blob-attestation.