feat: add platform option to push command #1500

TerryHowe · 2024-09-16T17:21:24Z

What this PR does / why we need it:

Add the platform option to the push command for example:

oras push --plain-http localhost:15000/oras:darwin,arm64  --artifact-platform darwin/arm64 --artifact-type 'application/vnd.oci.image.config.v1+json'  bin/darwin/arm64/oras:application/x-elf

Create the manifest for example:

oras manifest index create localhost:15000/oras:v1 sha256:ed3691788db69623790c46256dd11d8d6edc31be6e4762b53c74dfc3bb6792cf

The results

% oras manifest fetch --pretty localhost:15000/oras@sha256:c9e54542075ad502900d11b9b5d5bdb4b974ad580842515684d3fbb4849e2bb1
{
  "schemaVersion": 2,
  "mediaType": "application/vnd.oci.image.manifest.v1+json",
  "artifactType": "application/vnd.oci.image.config.v1+json",
  "config": {
    "mediaType": "application/vnd.unknown.config.v1+json",
    "digest": "sha256:e9302bbb2fb8f6c2df866d3c4e41917849442f89a575f36f43366a7279804f70",
    "size": 38
  },
  "layers": [
    {
      "mediaType": "application/x-elf",
      "digest": "sha256:69c16b8386b7949fe37ff2356296b6331c1e6d5fbbc3e616192cc10ece55ea8d",
      "size": 11673840,
      "annotations": {
        "org.opencontainers.image.title": "bin/darwin/amd64/oras"
      }
    }
  ],
  "annotations": {
    "org.opencontainers.image.created": "2024-09-16T16:54:48Z"
  }
}
% oras manifest fetch-config --pretty localhost:15000/oras@sha256:c9e54542075ad502900d11b9b5d5bdb4b974ad580842515684d3fbb4849e2bb1
{
  "architecture": "amd64",
  "os": "darwin"
}

Which issue(s) this PR fixes (optional, in fixes #<issue number>(, fixes #<issue_number>, ...) format, will close the issue(s) when PR gets merged):
Closes #1066
Partial #1053

Please check the following list:

Does the affected code have corresponding tests, e.g. unit test, E2E test?
Does this change require a documentation update?
Does this introduce breaking changes that would require an announcement or bumping the major version?
Do all new files have an appropriate license header?

codecov · 2024-09-16T17:23:49Z

Codecov Report

Attention: Patch coverage is 62.96296% with 10 lines in your changes missing coverage. Please review.

Project coverage is 85.87%. Comparing base (1d60e22) to head (4b2321a).

Files with missing lines	Patch %	Lines
cmd/oras/root/push.go	54.54%	7 Missing and 3 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1500      +/-   ##
==========================================
- Coverage   85.97%   85.87%   -0.10%     
==========================================
  Files         118      118              
  Lines        4228     4255      +27     
==========================================
+ Hits         3635     3654      +19     
- Misses        354      359       +5     
- Partials      239      242       +3

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

cmd/oras/root/push.go

wangxiaoxuan273 · 2024-09-18T02:04:56Z

cmd/oras/root/push.go

+		desc := ocispec.Descriptor{
+			MediaType: oras.MediaTypeUnknownConfig,
+			Digest:    digest.FromBytes(blob),
+			Size:      int64(len(blob)),
+		}


nit: This part can be replaced by func NewDescriptorFromBytes(mediaType string, content []byte) ocispec.Descriptor of oras-go. Reference: NewDescriptorFromBytes

cmd/oras/root/push.go

shizhMSFT · 2024-09-18T07:32:14Z

cmd/oras/root/push.go

+				if opts.Platform.Platform != nil && opts.artifactType != "" {
+					return errors.New("--artifact-type and --platform cannot both be provided for 1.0 OCI image")
+				}


They can be used together, can't they?

Indeed they can be used together. We can populate the artifactType as mediaType into the config descriptor.

shizhMSFT · 2024-09-18T07:33:36Z

cmd/oras/root/push.go

+			return err
+		}
+		desc := ocispec.Descriptor{
+			MediaType: oras.MediaTypeUnknownConfig,


This value depends on the image-spec version.

If the image-spec version is v1.0. The media type can also be the value of --artifact-type.

Wwwsylvia

LGTM with nit, but I am not a maintainer.

Wwwsylvia · 2024-09-25T06:58:18Z

cmd/oras/root/push.go

+		if opts.Flag == option.ImageSpecV1_0 {
+			if opts.artifactType != "" {


nit: how about

Suggested change

if opts.Flag == option.ImageSpecV1_0 {

if opts.artifactType != "" {

if opts.Flag == option.ImageSpecV1_0 && opts.artifactType != "" {

sabre1041

LGTM

cmd/oras/root/push.go

cmd/oras/internal/option/platform.go

cmd/oras/root/push.go

qweeah

LGTM with minor suggestion

qweeah · 2024-10-16T00:40:59Z

Sorry merging 55cf426 is not intended, I was playing with the PR locally and the upstream is accidentally set to this PR.

TerryHowe · 2024-10-16T00:47:39Z

Sorry merging 55cf426 is not intended, I was playing with the PR locally and the upstream is accidentally set to this PR.

reverted

Signed-off-by: Terry Howe <[email protected]>

TerryHowe requested review from sajayantony, shizhMSFT, SteveLasker and qweeah as code owners September 16, 2024 17:21

TerryHowe force-pushed the feature-push-platform branch 4 times, most recently from 641cbba to 7e915b1 Compare September 17, 2024 13:56

qweeah reviewed Sep 18, 2024

View reviewed changes

cmd/oras/root/push.go Outdated Show resolved Hide resolved

qweeah reviewed Sep 18, 2024

View reviewed changes

cmd/oras/root/push.go Outdated Show resolved Hide resolved

qweeah reviewed Sep 18, 2024

View reviewed changes

cmd/oras/root/push.go Outdated Show resolved Hide resolved

shizhMSFT changed the title ~~feature: add platform option to push command~~ feat: add platform option to push command Sep 18, 2024

shizhMSFT mentioned this pull request Sep 18, 2024

feat: add how-to for multiple architecture oras-project/oras-www#395

Open

wangxiaoxuan273 reviewed Sep 18, 2024

View reviewed changes

shizhMSFT reviewed Sep 18, 2024

View reviewed changes

TerryHowe force-pushed the feature-push-platform branch 6 times, most recently from 3038b7b to fafd301 Compare September 23, 2024 14:28

Wwwsylvia approved these changes Sep 25, 2024

View reviewed changes

TerryHowe force-pushed the feature-push-platform branch from fafd301 to a8a6a36 Compare September 25, 2024 14:38

sabre1041 approved these changes Sep 26, 2024

View reviewed changes

qweeah requested changes Sep 29, 2024

View reviewed changes

cmd/oras/root/push.go Outdated Show resolved Hide resolved

cmd/oras/root/push.go Outdated Show resolved Hide resolved

cmd/oras/internal/option/platform.go Outdated Show resolved Hide resolved

TerryHowe force-pushed the feature-push-platform branch 2 times, most recently from 8d4062e to 35fe5b7 Compare September 30, 2024 16:19

TerryHowe commented Oct 1, 2024

View reviewed changes

cmd/oras/root/push.go Outdated Show resolved Hide resolved

qweeah requested changes Oct 10, 2024

View reviewed changes

cmd/oras/root/push.go Outdated Show resolved Hide resolved

cmd/oras/root/push.go Outdated Show resolved Hide resolved

TerryHowe force-pushed the feature-push-platform branch 4 times, most recently from 76c1ad3 to 45456d0 Compare October 15, 2024 14:35

qweeah reviewed Oct 15, 2024

View reviewed changes

cmd/oras/root/push.go Outdated Show resolved Hide resolved

qweeah approved these changes Oct 15, 2024

View reviewed changes

TerryHowe force-pushed the feature-push-platform branch 2 times, most recently from 956c7e3 to 1334a8d Compare October 15, 2024 16:34

TerryHowe force-pushed the feature-push-platform branch from 55cf426 to 1334a8d Compare October 16, 2024 00:47

TerryHowe force-pushed the feature-push-platform branch from c8d6849 to e0ef359 Compare October 16, 2024 11:33

feature: add platform option to push command

4b2321a

Signed-off-by: Terry Howe <[email protected]>

TerryHowe force-pushed the feature-push-platform branch from e0ef359 to 4b2321a Compare October 16, 2024 12:51

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: add platform option to push command #1500

feat: add platform option to push command #1500

TerryHowe commented Sep 16, 2024 •

edited

Loading

codecov bot commented Sep 16, 2024 •

edited

Loading

wangxiaoxuan273 Sep 18, 2024

TerryHowe Sep 24, 2024

shizhMSFT Sep 18, 2024

Wwwsylvia Sep 18, 2024

TerryHowe Sep 22, 2024

shizhMSFT Sep 18, 2024

Wwwsylvia Sep 18, 2024

TerryHowe Sep 22, 2024

Wwwsylvia left a comment

Wwwsylvia Sep 25, 2024

TerryHowe Sep 25, 2024

sabre1041 left a comment

qweeah left a comment

qweeah commented Oct 16, 2024

TerryHowe commented Oct 16, 2024

		if opts.Flag == option.ImageSpecV1_0 {
		if opts.artifactType != "" {

	if opts.Flag == option.ImageSpecV1_0 {
	if opts.artifactType != "" {
	if opts.Flag == option.ImageSpecV1_0 && opts.artifactType != "" {

feat: add platform option to push command #1500

Are you sure you want to change the base?

feat: add platform option to push command #1500

Conversation

TerryHowe commented Sep 16, 2024 • edited Loading

codecov bot commented Sep 16, 2024 • edited Loading

Codecov Report

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Wwwsylvia left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

sabre1041 left a comment

Choose a reason for hiding this comment

qweeah left a comment

Choose a reason for hiding this comment

qweeah commented Oct 16, 2024

TerryHowe commented Oct 16, 2024

TerryHowe commented Sep 16, 2024 •

edited

Loading

codecov bot commented Sep 16, 2024 •

edited

Loading