Config-driven LangGraph Image Builder

Create a utility that turns a LangGraph configuration file into a built Docker image, wiring together validation, Dockerfile generation, build execution, and a concise build summary.

Capabilities

Derive build inputs

• Given a configuration file path and optional tag, determine the final tag using the package defaults when none is provided; fail fast on invalid configs. @test

Generate Dockerfile from config

• Produce an inline Dockerfile string and build contexts from the validated configuration, honoring an optional platform override in the generated build instructions. @test

Build image with overrides

• Build the Docker image from the inline Dockerfile, respecting a base-image override, forwarding arbitrary build arguments, applying any platform list, and skipping image pulls when requested. @test

Summarize build results

• Return a summary containing the tag used, resolved base image, Dockerfile text, contexts, whether a pull was performed, forwarded build arguments/platform, success flag, and path to the saved build log. @test

Implementation

@generates

API

from dataclasses import dataclass
from pathlib import Path
from typing import Optional

@dataclass
class BuildSummary:
    tag: str
    base_image: str
    dockerfile: str
    contexts: dict[str, str]
    pulled: bool
    build_args: dict[str, str]
    platform: Optional[str]
    success: bool
    log_path: Path

def build_from_config(
    config_path: str,
    tag: Optional[str] = None,
    *,
    base_image: Optional[str] = None,
    platform: Optional[str] = None,
    pull: bool = True,
    build_args: Optional[dict[str, str]] = None,
    log_dir: Optional[str] = None
) -> BuildSummary:
    """
    Validate the config file, derive a Docker tag when none is supplied, generate
    an inline Dockerfile plus build contexts, run the Docker image build with
    optional overrides, and persist build logs to a file.
    """

Dependencies { .dependencies }

langgraph-cli { .dependency }

Provides configuration validation, Dockerfile generation, and Docker image build tooling for LangGraph projects.