Skip to content

v1.4.0

Latest

Choose a tag to compare

@github-actions github-actions released this 17 Nov 15:35
· 1 commit to main since this release
v1.4.0
fdeb304

Changes since v1.3.6

Highlights

  • ORAS now uses oras-go v3 (github.com/oras-project/oras-go/v3 v3.0.0) instead of oras.land/oras-go/v2 (#2002)
    • oras copy can 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=1 and 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-prefixes
    • certs.d: per-registry CA and client certificates (refs #2118)
    • auth.json: credentials, checked after the ORAS credential store (skipped when --registry-config is given)
    • policy.json and registries.d: pull policy with signedBy verification
    • Command line flags such as --plain-http, --insecure, --ca-file, --cert-file/--key-file, --distribution-spec and -u/-p override the files

Behavior changes

  • oras blob fetch and oras blob delete now 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-path or --to-oci-layout-path, as they already were for --oci-layout (#2299, fixes #2298)
  • For an untagged push, oras push --format json no longer reports "referenceAsTags": ["<registry>/<repo>:"], and the go-template output no longer counts it as a tag (#2328)

Bug fixes

  • oras manifest fetch-config --output works 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_CACHE store no longer keeps an index.json, so several ORAS processes can safely share one cache directory (#2329, fixes #2312)
  • --from-password, --to-password, --from-identity-token and --to-identity-token now show the warning about secrets on the command line. Secrets read with --password-stdin and --identity-token-stdin now come from the command's input (#2331)
  • Fix panics in the TTY progress output when a status method is called before tracking starts. oras copy TTY output now uses the right fetcher for successors (#2332)
  • The oras discover --output deprecation 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/oras image 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 stable channel 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/v2 v2.7.0 → github.com/oras-project/oras-go/v3 v3.0.0 (#2002)
  • github.com/spf13/pflag v1.0.10 → v1.1.0 (#2322)
  • go.yaml.in/yaml/v4 v4.0.0-rc.6 → v4.0.0 (#2307, #2318, #2323)
  • golang.org/x/sync v0.24.0 → v0.25.0 (#2326)
  • golang.org/x/term v0.47.0 → v0.48.0 (#2334)
  • Container base images: golang 1.27.3-alpine (#2309) and alpine 3.24.4 (#2301, #2336)
  • GitHub Actions and e2e test dependency updates (#2302, #2308, #2319, #2320, #2324, #2327)

Other

  • Registry Warning headers are now logged with oras-go v3's remote.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/oras

The attestations are Sigstore bundles, so they can also be downloaded with gh attestation download and checked with cosign verify-blob-attestation.