Releases · oras-project/oras-go

12 Aug 15:15

shizhMSFT

v2.0.0-rc.2

c76df08

v2.0.0-rc.2 Pre-release

Pre-release

New Features

Supports artifacts-spec v1.0.0-rc.2
Added new API content.ReadAll() to safely read fetched blobs
content/file.Store allows skipping unnamed blobs when pushing
oras.Copy() and oras.ExtendedCopy() support platform selection
oras.ExtendedCopy() supports filtering predecessors by artifact type and / or annotations using regular expressions

Bug Fixes

fix #236: same content with different names will be skipped when being pushing to file store
fix #239: oras.Copy() may skip tagging if manifest blob already exists in the destination
fix #252: pushing blobs to ECR will fail

Other Changes

Improved documentation
Migrated to codecov.io for code coverage reports
oras.Pack() packs empty config blob of size 0 bytes instead of {} (empty JSON object of size 2 bytes).

Detailed Commits

Bug: oras.Copy() may skip tagging if manifest blob already exists in the destination by @m5i-work in #243
created pull blob example by @wangxiaoxuan273 in #234
added an example of copying artifact manifest by @wangxiaoxuan273 in #241
moved ReadAll and related functions to package Content by @wangxiaoxuan273 in #245
update artifact-spec to v1.0.0-rc.2 by @Wwwsylvia in #251
Reuse post token for put when pushing blobs by @qweeah in #253
Migrate to codecov.io by @junczhuMSFT in #247
replaced io.ReadAll with content.ReadAll in examples by @wangxiaoxuan273 in #255
Added an example of using ExtendedCopy by @wangxiaoxuan273 in #248
Failed to download all the files in an artifact using oras.Copy() by @m5i-work in #256
fix: Fix runnable examples by @lizMSFT in #257
Allow skipping unnamed blobs when pushing to file store by @m5i-work in #254
Upload empty blob when packing by @m5i-work in #262
support filtering on annotation with regex by @wangxiaoxuan273 in #259
fix: fix typo in example test by @lizMSFT in #263
feat: Support platform selection on Copy by @lizMSFT in #244
added filtering by artifact type with regex by @wangxiaoxuan273 in #258
fix: added manifest parsing when annotation is not in the descriptor by @wangxiaoxuan273 in #266

New Contributors

@junczhuMSFT made their first contribution in #247
@lizMSFT made their first contribution in #257

Full Changelog: v2.0.0-rc.1...v2.0.0-rc.2

Contributors

qweeah, Wwwsylvia, and 4 other contributors

Assets 2

07 Jul 11:46

shizhMSFT

v2.0.0-rc.1

4660638

v2.0.0-rc.1 Pre-release

Pre-release

Major Changes

Updates implementation to conform artifact-spec v1.0.0-rc.1.
- Supports the Referrer API, and is compatible with the legacy draft.1 API.
- Supports the Discovery API.
BREAKING CHANGE registry.Repositories() and registry.Tags() support last parameter.
New PackArtifact() method for easier packing artifacts.
New Tag() method to re-tag a manifest.

What's Changed

Update godoc link to main branch by @Wwwsylvia in #198
migrate REVIEWING.md from ORAS-go to community by @FeynmanZhou in #194
Update Referrers API to match RC.1 by @m5i-work in #191
Clean up unused files by @shizhMSFT in #212
Filter referrers by artifact type by @m5i-work in #211
examples for the auth module by @wangxiaoxuan273 in #182
Add auth examples in README by @Wwwsylvia in #216
Support last parameter for listing catalog and tags by @patrickzheng200 in #217
Update artifact spec to v1.0.0-rc.1 by @Wwwsylvia in #222
added a refresh token example by @wangxiaoxuan273 in #219
Implement client feature for Discovery API by @m5i-work in #214
Check ORAS-Api-Version for referrers API by @m5i-work in #227
Add PackArtifact by @Wwwsylvia in #223
Skip version checking for pre-RC1 endpoint by @m5i-work in #229
Added Tag function to oras/registry.go by @patrickzheng200 in #226
Use annotation constant from artifact-spec by @m5i-work in #231
added one example for downloading artifact reference manifest by @wangxiaoxuan273 in #173

New Contributors

@FeynmanZhou made their first contribution in #194
@m5i-work made their first contribution in #191

Full Changelog: v2.0.0-alpha...v2.0.0-rc.1

Contributors

Wwwsylvia, m5i-work, and 4 other contributors

Assets 2

24 Jun 07:09

shizhMSFT

v2.0.0-alpha

c7bac50

v2.0.0-alpha Pre-release

Pre-release

In version v2, ORAS Go library has been completely refreshed with:

More unified interfaces
Notably fewer dependencies
Higher test coverage
Better documentation

Besides, ORAS Go v2 is now a registry client.

Major Changes in `v2`

Moves content.FileStore to file.Store
Moves content.OCIStore to oci.Store
Moves content.MemoryStore to memory.Store
Provides SDK to interact with OCI-compliant and Docker-compliant registries
Supports Copy with more flexible options
Supports Extended Copy with options (experimental)
No longer supports docker.Login and docker.Logout (removes the dependency on docker); instead, provides authentication through auth.Client

Documentation and examples are available at pkg.go.dev.
Detailed migration guide are available at MIGRATION_GUIDE.md.

New Contributors

@scottrigby made their first contribution in #74
@Wwwsylvia made their first contribution in #86
@sajayantony made their first contribution in #116
@qweeah made their first contribution in #117
@wangxiaoxuan273 made their first contribution in #145
@caniszczyk made their first contribution in #105
@patrickzheng200 made their first contribution in #186

Full Changelog: v0.5.0...v2.0.0-alpha

Contributors

caniszczyk, scottrigby, and 5 other contributors

Assets 2

15 Jun 13:07

shizhMSFT

v1.2.0

991ecbb

v1.2.0

What's Changed

use io.ReadFull for ProviderWrapper in case of partial read by @raygecao in #142
Bump containerd to v1.6.4 by @lucacome in #151
Bump containerd to v1.6.6 by @lucacome in #160
Bump cobra to v1.4.0 by @lucacome in #167
Bump dependencies by @lucacome in #168
Implement Delete in the oci store content implementation by @viovanov in #174
Add a loginWithTLS function to V1 by @souleb in #171