% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/images.R
\name{ensure_buildx_builder}
\alias{ensure_buildx_builder}
\title{Ensure a buildx builder with the docker-container driver exists and is usable}
\usage{
ensure_buildx_builder(builder_name = "starburst-builder")
}
\arguments{
\item{builder_name}{Name of the buildx builder (default "starburst-builder")}
}
\value{
TRUE if the named builder is usable, FALSE otherwise
}
\description{
Idempotent across repeated runs and cross-platform (Windows/macOS/Linux).
Probes for an existing builder via \code{docker buildx inspect}; creates it
only when missing; bootstraps it so it is ready to build. A docker-container
driver is required for multi-platform (\code{linux/amd64,linux/arm64})
builds. Does not mutate the user's default buildx context (no \code{--use});
the build pins the builder explicitly via \code{--builder}.
}
\details{
Returns TRUE if the named builder is usable, FALSE otherwise, and never
throws -- callers decide policy. This fixes the failure mode where
\code{buildx create} errored on an already-existing builder, the error was
swallowed, and the subsequent \code{buildx build} failed with "existing
instance for <name> but no append mode" (GitHub #24).
}
\keyword{internal}
