Skip to content

Commit a3a7b2e

Browse files
committed
spec.md: add some description about manifest list
Signed-off-by: Lei Jitang <[email protected]>
1 parent c2ba0e3 commit a3a7b2e

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

spec.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Open Container Initiative Image Format Specification
22

3-
This specification defines an OCI Image, consisting of a [manifest](manifest.md), a set of [filesystem layers](layer.md), and a [configuration](config.md).
3+
This specification defines an OCI Image, consisting of a [manifest](manifest.md), a [manifest list](manifest-list.md) (optional), a set of [filesystem layers](layer.md), and a [configuration](config.md).
44

55
The goal of this specification is to enable the creation of interoperable tools for building, transporting, and preparing a container image to run.
66

@@ -29,6 +29,8 @@ The key words "unspecified", "undefined", and "implementation-defined" are to be
2929

3030
At a high level the image manifest contains metadata about the contents and dependencies of the image including the content-addressable identity of one or more [filesystem layer changeset](layer.md) archives that will be unpacked to make up the final runnable filesystem.
3131
The image configuration includes information such as application arguments, environments, etc.
32+
The manifest list is a higher-level manifest which points to one or more manifests.
33+
Typically, these manifests may provide different implementations of the image, possibly varying by platform or other attributes.
3234

3335
![](img/build-diagram.png)
3436

@@ -42,7 +44,7 @@ The [OCI Image Media Types](media-types.md) document is a starting point to unde
4244

4345
The high-level components of the spec include:
4446

45-
* An archival format for container images, consisting of an [image manifest](manifest.md), an [image layout](image-layout.md), a set of [filesystem layers](layer.md), and [image configuration](config.md) (base OCI layer)
47+
* An archival format for container images, consisting of an [image manifest](manifest.md), a [manifest list](manifest-list.md) (optional), an [image layout](image-layout.md), a set of [filesystem layers](layer.md), and [image configuration](config.md) (base OCI layer)
4648
* A [process of referencing container images by a cryptographic hash of their content](descriptor.md) (base OCI layer)
4749
* A format for [storing CAS blobs and references to them](image-layout.md) (optional OCI layer)
4850
* Signatures that are based on signing image content address (optional OCI layer)

0 commit comments

Comments
 (0)