convert.md

Rules to convert OCI layout directories to container images.

Use image_manifest_from_oci_layout to convert an OCI layout directory to a single-platform container image manifest, and image_index_from_oci_layout to convert an OCI layout directory to a multi-platform container image index.

image_index_from_oci_layout

load("@rules_img//img:convert.bzl", "image_index_from_oci_layout")

image_index_from_oci_layout(name, src, layers, manifests)

ATTRIBUTES

Name	Description	Type	Mandatory	Default
name	A unique name for this target.	Name	required
src	The directory containing the OCI layout to convert from.	Label	required
layers	A list of layer media types. This applies to all manifests. Use the well-defined media types in @rules_img//img:media_types.bzl.	List of strings	required
manifests	An ordered list of platform specifications in 'os/architecture' or 'os/architecture/variant' format. Example: ["linux/arm64", "linux/amd64/v3"]	List of strings	required

image_manifest_from_oci_layout

load("@rules_img//img:convert.bzl", "image_manifest_from_oci_layout")

image_manifest_from_oci_layout(name, src, architecture, layers, os, variant)

ATTRIBUTES

Name	Description	Type	Mandatory	Default
name	A unique name for this target.	Name	required
src	The directory containing the OCI layout to convert from.	Label	required
architecture	The target architecture for the image manifest.	String	required
layers	A list of layer media types. Use the well-defined media types in @rules_img//img:media_types.bzl.	List of strings	required
os	The target operating system for the image manifest.	String	required
variant	The platform variant (e.g., 'v3' for amd64/v3, 'v8' for arm64/v8).	String	optional	""