Image

Declarative image builder used to define Sandbox runtime environments.

Use factory methods such as #base(String) or #debianSlim(String) and chain mutating methods to append Dockerfile instructions.

Methods

base()

public static Image base(String baseImage)

Creates an image definition from an existing base image.

Parameters:

• baseImage String - base image reference (for example python:3.12-slim-bookworm)

Returns:

• Image - new Image initialized with a FROM instruction

debianSlim()

public static Image debianSlim(String pythonVersion)

Creates a Python Debian slim image.

Parameters:

• pythonVersion String - Python version to use; defaults to 3.11 when null or empty

Returns:

• Image - new Image using a Python slim base image

pipInstall()

public Image pipInstall(String... packages)

Adds a pip install instruction for one or more packages.

Parameters:

• packages String… - package names to install

Returns:

• Image - this Image for method chaining

runCommands()

public Image runCommands(String... commands)

Adds one or more RUN instructions.

Parameters:

• commands String… - shell commands to execute during image build

Returns:

• Image - this Image for method chaining

env()

public Image env(Map<String, String> envVars)

Adds environment variables using ENV instructions.

Parameters:

• envVars Map<String, String> - environment variables to set in the image

Returns:

• Image - this Image for method chaining

workdir()

public Image workdir(String path)

Sets the default working directory using a WORKDIR instruction.

Parameters:

• path String - working directory path

Returns:

• Image - this Image for method chaining

entrypoint()

public Image entrypoint(String... commands)

Sets the container entrypoint.

Parameters:

• commands String… - entrypoint command and arguments

Returns:

• Image - this Image for method chaining

cmd()

public Image cmd(String... commands)

Sets the default container command.

Parameters:

• commands String… - default command and arguments

Returns:

• Image - this Image for method chaining

getDockerfile()

public String getDockerfile()

Returns generated Dockerfile content.

Returns:

• String - Dockerfile text assembled by this builder