{"full_name":"oras-project/oras-go","owner":"oras-project","name":"oras-go","shard":"1","url":"https://github.com/oras-project/oras-go","description":"ORAS Go library","homepage":"https://oras.land","topics":["oras","artifact","container","registry","go"],"tag_pages":["container","go","registry"],"language":"Go","license":"Apache-2.0","avatar":"https://avatars.githubusercontent.com/u/81890686?v=4","created_at":"2021-04-28T17:24:08Z","pushed_at":"2026-11-12T15:34:47Z","metrics":{"stars":301,"forks":189,"watchers":9,"issues":558,"prs":1200,"releases":49,"issues_open":1,"issues_closed":557,"prs_open":1,"prs_closed":192,"prs_merged":1007,"discussions":16},"growth":{"day":{"stars":1,"forks":0,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[299,299,299,299,300,300,301],"forks":[189,189,189,189,189,189,189],"watchers":[null,9,9,9,9,9,9],"issues_open":[null,1,1,1,1,1,1],"prs_open":[null,0,1,0,0,0,1]},"boards":{},"same_owner":[],"issues":[{"number":1779,"title":"feat: build a configured ClientBuilder from config.Configs","comments":3,"created_at":"2026-11-10T00:31:50Z"}],"discussions":[{"number":1106,"title":"Any way to check a repository similar to the registry ping?","comments":1,"category":"Q&A","created_at":"2026-02-24T14:50:37Z"},{"number":1088,"title":"Built-in compression support for layer push/fetch","comments":1,"category":"Ideas","created_at":"2025-12-28T13:37:39Z"},{"number":911,"title":"panic: invalid OCI Image Index: trailing data","comments":1,"category":"Q&A","created_at":"2025-03-04T18:21:00Z"},{"number":703,"title":"Digest without timestamp","comments":1,"category":"Q&A","created_at":"2024-02-06T17:57:33Z"},{"number":586,"title":"Add more information in Warning","comments":0,"category":"Ideas","created_at":"2023-08-01T12:23:07Z"},{"number":476,"title":"How to authenticate with AAD access token","comments":1,"category":"Q&A","created_at":"2023-04-06T15:27:45Z"},{"number":413,"title":"SDK for `oras login`","comments":3,"category":"Ideas","created_at":"2023-01-16T18:27:06Z"},{"number":277,"title":"Support disabling digest validation for manifestStore.Fetch in remote package","comments":0,"category":"General","created_at":"2022-08-23T03:40:57Z"}],"latest_release":{"name":"v3.0.0","tag":"v3.0.0","published_at":"2026-11-01T16:00:17Z","body":"ORAS Go v3.0.0 is the first stable release of the v3 line. It adds a configuration layer compatible with `containers/image`, a client builder, registry mirrors, policy and signature verification, content verification, and new push modes. It also reorganizes remote-registry configuration so that a registry owns the settings its repositories share.\n\n**The module path has changed.** v3 is published as `github.com/oras-project/oras-go/v3`:\n\n```diff\n-oras.land/oras-go/v2\n+github.com/oras-project/oras-go/v3\n```\n\n```sh\ngo get github.com/oras-project/oras-go/v3@v3.0.0\ngo mod tidy\n```\n\nThe v2 and v3 module paths are distinct, so one application can import both while it migrates package by package. The minimum supported Go version is 1.26.\n\nStart with the [Migration Guide](https://github.com/oras-project/oras-go/blob/v3.0.0/MIGRATION_GUIDE.md). It has before-and-after code for every breaking change listed below.\n\n## What's New\n\n### Configuration and clients\n\n* **Unified configuration**: `registry/remote/config.LoadConfigs` loads Docker credentials, containers `auth.json`, `registries.conf`, `policy.json`, `registries.d`, and certificate directories. The default path strategy follows `containers/image`. An experimental UAPI strategy is also available.\n* **Configured clients**: `remote.ClientBuilder` builds clients, registries, and repositories with TLS, retries, credentials, token flow, warnings, logging, policy, and mirror settings applied consistently. Use `builder.NewRegistry(props)` and `builder.NewRepository(props)`.\n* **Registry mirrors**: repositories created from registry properties try applicable mirrors for reads and fall back to the primary. Writes always go to the primary.\n* **Policy and signatures**: `registry/remote/policy` enforces allow/deny policy, and a denial wraps `policy.ErrDenied`. `registry/remote/signature` verifies OpenPGP simple signatures with `registries.d` lookaside storage, resolving the lookaside location for each scope as it is used.\n* **ORAS-specific `registries.conf` keys**: `[[registry]]` entries accept `token-flow`, `referrers-api`, and `blocked-realm-prefixes`, and mirrors inherit them from the primary.\n* **Resource-scoped credentials**: the new `properties.Resource` names a registry, optionally narrowed to a namespace or repository. Credentials and token scope hints are keyed by it, so logins to two namespaces of one registry no longer overwrite each other. `credentials.StoreOptions.Hierarchical` adds longest-prefix namespace matching for containers `auth.json` (Podman/Buildah).\n* **Bearer token flow**: `auth.Client.TokenFetcher` selects the token flow. The default tries the OAuth2 password grant and falls back to the distribution token flow when the realm rejects it with 400, 401, 404, or 405, so registries such as GitLab, GHCR, GCR, ACR, and Artifactory work without configuration. Set `CompositeTokenFetcher.StrictOAuth2` (or `token-flow = \"oauth2\"`) to disable the fallback.\n\n### Content and transfer\n\n* **Content verification**: `content.Verify`, `oras.Verify`, `oras.VerifyGraph`, and `oras.ExtendedVerify` check content integrity without writing it and collect per-node results in a report. `oci.Verify` sweeps an OCI image layout and reports missing, unreferenced, and leftover blobs, as well as invalid `oci-layout` or `index.json` files.\n* **Unsafe push**: the `content.UnsafePusher` interface pushes content whose digest or size is not known up front, such as a stream or a tar built on the fly, and computes both while writing. It is implemented by `memory.Store`, `oci.Storage`, `oci.Store`, and `remote.Repository`, and is bounded by `MaxUnsafePushBytes` (4 GiB by default).\n* **Push modes**: `MaxChunkSize` enables OCI chunked uploads and honors the registry's `OCI-Chunk-Min-Length`. `SingleRequestPushThreshold` pushes small blobs in a single `POST`. Both are opt-in, on `remote.Registry` and `remote.Repository`.\n* **Fewer round trips on copy**: the opt-in `SkipExistsCheckBelowSize` skips the destination","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}