Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

protocol.md: Fix note formatting and add a note about annotations and image lists #6

Closed
wants to merge 5 commits into from

Conversation

stbergmann
Copy link

No description provided.

(The Pulp folks asked for that clarification in response to my work-in-progress
implementation of this protocol for Pulp at
<pulp/pulp_container#1301> "Implement flatpak index
view".)
docs/protocol.md Outdated Show resolved Hide resolved
@@ -109,4 +115,6 @@ The basic structure of the JSON returned from a request is:

Notes
-----
* For images within an image list, the architecture matched by `architecture=` queries and returned in the JSON result is the architecture extracted from the images `config.json`, not the architecture in the manifest list or image index.
* For images within an image list, the architecture matched by `architecture=` queries and returned in the JSON result is the architecture extracted from the images `config.json`, not the architecture in the manifest list or image index.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* For images within an image list, the architecture matched by `architecture=` queries and returned in the JSON result is the architecture extracted from the images `config.json`, not the architecture in the manifest list or image index.
* For images within a manifest list or OCI index, the architecture matched by `architecture=` queries and returned in the JSON result is the architecture extracted from the images `config.json`.

The architecture attribute must be specified in respective listed manifests: https://docs.docker.com/engine/reference/commandline/manifest/#inspect-a-manifest-list, https://github.com/opencontainers/image-spec/blob/main/image-index.md#image-index-property-descriptions. What is the rationale behind this statement, @owtaylor?

Copy link

@lubosmj lubosmj Jun 22, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, my bad, the platform object that holds the architecture attribute is optional.

@stbergmann stbergmann force-pushed the protocolnotes branch 2 times, most recently from 730d0c1 to 29040c2 Compare June 27, 2023 15:27
owtaylor added a commit to owtaylor/flatpak-oci-specs that referenced this pull request Jun 30, 2023
Specify that if a parameter is repeated (arch=amd64&arch=arm64), this is
treated as OR. This matches the original Flagstate implementation,
and is more useful than AND, since the result of such a query would
always be empty.

Based on changes from Stephan Bergmann <[email protected]>; see
owtaylor/flagstate#6
@stbergmann
Copy link
Author

Abandoned in favor of flatpak/flatpak-oci-specs#1 "Add an appending describing how Flatpak uses the specification" and flatpak/flatpak-oci-specs#2 "Registry Index: multiple parameters with the same key are OR'ed together".

@stbergmann stbergmann closed this Jun 30, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants