pulumi-docker-build

What it is and what it does

This is a Pulumi resource provider that lets you define Docker image builds as infrastructure code using Pulumi's programming model. It wraps Docker's buildx and BuildKit tooling, allowing you to declare and manage image builds declaratively rather than through imperative shell commands. The provider is distinct from the general-purpose Docker provider, which handles container runtime and networking; this one focuses exclusively on the build process itself.

You use it within a Pulumi program to specify build configurations, then Pulumi orchestrates the actual build via buildx and BuildKit. It depends on pulumi, parver, semver, and typing-extensions, and requires Python 3.9 or later.

Use it for:

• Define multi-platform Docker builds as Pulumi stack code alongside other infrastructure
• Automate image builds as part of a larger infrastructure deployment within the Pulumi workflow
• Version and track Docker image build configurations in version control as Pulumi code
• Integrate BuildKit advanced features into infrastructure-as-code pipelines

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Pulumi provider for building Docker images using buildx and BuildKit, enabling infrastructure-as-code management of modern Docker image builds.

Yes, if you are already using Pulumi and need to build Docker images as part of infrastructure automation. The package is actively maintained, has low install friction, carries a permissive license, and has no known vulnerabilities. It fills a specific gap for teams that want image builds in their Pulumi stacks. If you are not using Pulumi or only need ad-hoc Docker builds, this is not the right tool.

Install

pulumi-docker-build on PyPI

pip install pulumi-docker-build

uv add pulumi-docker-build

poetry add pulumi-docker-build

Installing pulumi-docker-build

Before you install

Low install friction with a pure-Python wheel. Actively maintained with a recent release and an active repository.

License in practice

Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.

Quickstart

pip install pulumi-docker-build

import pulumi_docker_build as docker_build

image = docker_build.Image('my-image', context='./app')

Requires Python 3.9 or later and Docker with buildx and BuildKit support installed on the system.

Verify before relying

• Whether this provider is suitable for production workloads or still in early/experimental stages
• Specific buildx and BuildKit version compatibility requirements

Package facts

Evidence: pulumi_docker_build-0.0.22-py3-none-any.whl

Keywords: docker, buildkit, buildx, kind/native

Tags

More Build Tools packages