Module oci_spec::image

source ·
Expand description

OCI image spec types and definitions.

Structs§

  • ArtifactManifest
    The OCI Artifact manifest describes content addressable artifacts in order to store them along side container images in a registry.
  • ArtifactManifestBuilder
    Builder for ArtifactManifest.
  • Config
    The execution parameters which SHOULD be used as a base when running a container using the image.
  • ConfigBuilder
    Builder for Config.
  • Descriptor
    A Content Descriptor (or simply Descriptor) describes the disposition of the targeted content. It includes the type of the content, a content identifier (digest), and the byte-size of the raw content. Descriptors SHOULD be embedded in other formats to securely reference external content.
  • DescriptorBuilder
    Builder for Descriptor.
  • Digest
    A parsed pair of algorithm:digest as defined by https://github.com/opencontainers/image-spec/blob/main/descriptor.md#digests
  • History
    Describes the history of a layer.
  • HistoryBuilder
    Builder for History.
  • ImageConfiguration
    The image configuration is associated with an image and describes some basic information about the image such as date created, author, as well as execution/runtime configuration like its entrypoint, default arguments, networking, and volumes.
  • ImageConfigurationBuilder
    Builder for ImageConfiguration.
  • ImageIndex
    The image index is a higher-level manifest which points to specific image manifests, ideal for one or more platforms. While the use of an image index is OPTIONAL for image providers, image consumers SHOULD be prepared to process them.
  • ImageIndexBuilder
    Builder for ImageIndex.
  • ImageManifest
    Unlike the image index, which contains information about a set of images that can span a variety of architectures and operating systems, an image manifest provides a configuration and set of layers for a single container image for a specific architecture and operating system.
  • ImageManifestBuilder
    Builder for ImageManifest.
  • OciLayout
    The oci layout JSON object serves as a marker for the base of an Open Container Image Layout and to provide the version of the image-layout in use. The imageLayoutVersion value will align with the OCI Image Specification version at the time changes to the layout are made, and will pin a given version until changes to the image layout are required.
  • OciLayoutBuilder
    Builder for OciLayout.
  • Platform
    Describes the minimum runtime requirements of the image.
  • PlatformBuilder
    Builder for Platform.
  • RootFs
    RootFs references the layer content addresses used by the image.
  • RootFsBuilder
    Builder for RootFs.
  • Sha256Digest
    A SHA-256 digest, guaranteed to be 64 lowercase hexadecimal ASCII characters.

Enums§

  • Arch
    Name of the CPU target architecture.
  • DigestAlgorithm
    A digest algorithm; at the current time only SHA-256 is widely used and supported in the ecosystem. Other SHA variants are included as they are noted in the standards. Other digest algorithms may be added in the future, so this structure is marked as non-exhaustive.
  • MediaType
    Media types used by OCI image format spec. Values MUST comply with RFC 6838, including the naming requirements in its section 4.2.
  • Os
    Name of the target operating system.

Constants§

  • ANNOTATION_AUTHORS
    AnnotationAuthors is the annotation key for the contact details of the people or organization responsible for the image (freeform string).
  • ANNOTATION_BASE_IMAGE_DIGEST
    AnnotationBaseImageDigest is the annotation key for the digest of the image’s base image.
  • ANNOTATION_BASE_IMAGE_NAME
    AnnotationBaseImageName is the annotation key for the image reference of the image’s base image.
  • ANNOTATION_CREATED
    AnnotationCreated is the annotation key for the date and time on which the image was built (date-time string as defined by RFC 3339).
  • ANNOTATION_DESCRIPTION
    AnnotationDescription is the annotation key for the human-readable description of the software packaged in the image.
  • ANNOTATION_DOCUMENTATION
    AnnotationDocumentation is the annotation key for the URL to get documentation on the image.
  • ANNOTATION_LICENSES
    AnnotationLicenses is the annotation key for the license(s) under which contained software is distributed as an SPDX License Expression.
  • ANNOTATION_REF_NAME
    AnnotationRefName is the annotation key for the name of the reference for a target. SHOULD only be considered valid when on descriptors on index.json within image layout.
  • ANNOTATION_REVISION
    AnnotationRevision is the annotation key for the source control revision identifier for the packaged software.
  • ANNOTATION_SOURCE
    AnnotationSource is the annotation key for the URL to get source code for building the image.
  • ANNOTATION_TITLE
    AnnotationTitle is the annotation key for the human-readable title of the image.
  • ANNOTATION_URL
    AnnotationURL is the annotation key for the URL to find more information on the image.
  • ANNOTATION_VENDOR
    AnnotationVendor is the annotation key for the name of the distributing entity, organization or individual.
  • ANNOTATION_VERSION
    AnnotationVersion is the annotation key for the version of the packaged software. The version MAY match a label or tag in the source code repository. The version MAY be Semantic versioning-compatible.
  • LABEL_VERSION
    In theory, this key is not standard. In practice, it’s used by at least the RHEL UBI images for a long time.
  • SCHEMA_VERSION
    The expected schema version; equals 2 for compatibility with older versions of Docker.
  • VERSION_DEV
    Indicates development branch. Releases will be empty string.
  • VERSION_MAJOR
    API incompatible changes.
  • VERSION_MINOR
    Changing functionality in a backwards-compatible manner
  • VERSION_PATCH
    Backwards-compatible bug fixes.

Traits§

  • ToDockerV2S2
    Trait to get the Docker Image Manifest V2 Schema 2 media type for an OCI media type

Functions§

  • version
    Retrieve the version as string representation.