orangeqs.juice.cli.build

Juice CLI commands for building CI images.

Module Contents

Functions

build_base_image_cmd

Build a Juice base image and tag it locally.

API

orangeqs.juice.cli.build.build_base_image_cmd(tag: str | None, juice_version: str, output_dir: pathlib.Path | None, extra_packages: tuple[str, ...], render_only: bool) → None

Build a Juice base image and tag it locally.

A base image is the bottom layer of a Juice environment: a container image baking in orangeqs-juice-core (pinned to --version) plus stable dependencies. The orchestrator builds the per-installation user layer on top of it at install time.

Mainly intended for CI, which builds and publishes base images to a registry. Although one can build a base image locally, it is not the use case the command is designed for.

With --render-only the command writes only the build context (the Containerfile and pyproject.toml) and skips podman, so an external, unprivileged builder such as Kaniko can perform the actual build.