Skip to content

Feature: container ​

Description ​

A platform feature that builds a Garden Linux container image compatible with Docker and Podman. The artifact is delivered as an OCI image tarball.

What it does ​

Produces an OCI-compatible container image via image.oci. The image is a minimal base image built on top of the base and _archgrouped elements, with package management utilities and daemon services excluded that are not needed in a container environment.

Custom images built with this feature can be loaded directly into a container runtime:

bash
podman load -i container-amd64-today-local.container.tar.gz
# or
docker load -i container-amd64-today-local.container.tar.gz

Files ​

Files present in this feature and their purpose. See the feature file reference for the semantics of each file type.

FilePurpose
image.oci (ref)Builds an OCI image tarball from the rootfs, packaging it with the correct OCI manifest and config layers.
info.yaml (ref)Declares type: platform and included/excluded features.
pkg.exclude (ref)Prevents installation of garden-repo-manager and rng-tools (not needed in containers).

Includes:

  • base — provides the minimal Garden Linux base system.
  • _archgrouped — groups architecture-specific package selections for the container build.