Store Image / ImageIndex with name / tag annotation #81
Assignees
Comments
dtrudg
changed the title
dtrudg
added a commit
to dtrudg/oci-tools
that referenced
this issue
Sep 27, 2024
Adds `f.AppendImage` and `f.AppendIndex`, which append a `v1.Image` or a `v1.ImageIndex` to the SIF, respectively. The `OptAppendReference` functional option can be used to provide a `name.Reference` that will be stored as an annotation against the new descriptor in the RootIndex, with the key `org.opencontainers.image.ref.name`, as is convention for associating references with items stored in an OCI layout. Fixes sylabs#83 Fixes sylabs#81
dtrudg
added a commit
to dtrudg/oci-tools
that referenced
this issue
Sep 27, 2024
Adds `f.AppendImage` and `f.AppendIndex`, which append a `v1.Image` or a `v1.ImageIndex` to the SIF, respectively. The `OptAppendReference` functional option can be used to provide a `name.Reference` that will be stored as an annotation against the new descriptor in the RootIndex, with the key `org.opencontainers.image.ref.name`, as is convention for associating references with items stored in an OCI layout. Fixes sylabs#83 Fixes sylabs#81
dtrudg
added a commit
to dtrudg/oci-tools
that referenced
this issue
Sep 27, 2024
Adds `f.AppendImage` and `f.AppendIndex`, which append a `v1.Image` or a `v1.ImageIndex` to the SIF, respectively. The `OptAppendReference` functional option can be used to provide a `name.Reference` that will be stored as an annotation against the new descriptor in the RootIndex, with the key `org.opencontainers.image.ref.name`, as is convention for associating references with items stored in an OCI layout. Fixes sylabs#83 Fixes sylabs#81
dtrudg
added a commit
to dtrudg/oci-tools
that referenced
this issue
Sep 27, 2024
Adds `f.AppendImage` and `f.AppendIndex`, which append a `v1.Image` or a `v1.ImageIndex` to the SIF, respectively. The `OptAppendReference` functional option can be used to provide a `name.Reference` that will be stored as an annotation against the new descriptor in the RootIndex, with the key `org.opencontainers.image.ref.name`, as is convention for associating references with items stored in an OCI layout. Fixes sylabs#83 Fixes sylabs#81
dtrudg
added a commit
to dtrudg/oci-tools
that referenced
this issue
Sep 27, 2024
Adds `f.AppendImage` and `f.AppendIndex`, which append a `v1.Image` or a `v1.ImageIndex` to the SIF, respectively. The `OptAppendReference` functional option can be used to provide a `name.Reference` that will be stored as an annotation against the new descriptor in the RootIndex, with the key `org.opencontainers.image.ref.name`, as is convention for associating references with items stored in an OCI layout. Fixes sylabs#83 Fixes sylabs#81
dtrudg
added a commit
to dtrudg/oci-tools
that referenced
this issue
Sep 27, 2024
Adds `f.AppendImage` and `f.AppendIndex`, which append a `v1.Image` or a `v1.ImageIndex` to the SIF, respectively. The `OptAppendReference` functional option can be used to provide a `name.Reference` that will be stored as an annotation against the new descriptor in the RootIndex, with the key `org.opencontainers.image.ref.name`, as is convention for associating references with items stored in an OCI layout. Fixes sylabs#83 Fixes sylabs#81
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
OCI-SIF files can hold more than one OCI image and / or image index. When there is only one image in an OCI-SIF then consumers can trivially use that image. If more manifests are present in the RootIndex then we need to be able to select which one to use. Users are unlikely to wish to have to select between images using only a sha256 digest, given that friendly tags are used in most flows. We need to be able to store images in an OCI-SIF so that they are associated with a friendly tag.
By convention, in oci-layout directories, the
index.json(analogous to our RootIndex) allows a tag / name to be associated with a manifest via the org.opencontainers.image.ref.name annotation. On the FileImage interface proposed in #80 we should provide a simple method to store an Image / ImageIndex with a tag that will become an org.opencontainers.image.ref.name annotation in the RootIndex.This is likely via an option on
AppendImage/Indexmethods discussed in #83The text was updated successfully, but these errors were encountered: