Builds

List builds

client.Builds.List(ctx) (*[]Build, error)

get/builds

Create a new build

client.Builds.New(ctx, body) (*Build, error)

post/builds

Get build details

client.Builds.Get(ctx, id) (*Build, error)

get/builds/{id}

Cancel build

client.Builds.Cancel(ctx, id) error

delete/builds/{id}

Stream build events (SSE)

client.Builds.Events(ctx, id, query) (*BuildEvent, error)

get/builds/{id}/events

ModelsExpand Collapse

type Build struct{…}

ID string

Build job identifier

CreatedAt Time

Build creation timestamp

formatdate-time

Status BuildStatus

Build job status

Accepts one of the following:

const BuildStatusQueued BuildStatus = "queued"

const BuildStatusBuilding BuildStatus = "building"

const BuildStatusPushing BuildStatus = "pushing"

const BuildStatusReady BuildStatus = "ready"

const BuildStatusFailed BuildStatus = "failed"

const BuildStatusCancelled BuildStatus = "cancelled"

BuilderInstanceID stringoptional

Instance ID of the builder VM (for debugging)

CompletedAt Timeoptional

Build completion timestamp

formatdate-time

DurationMs int64optional

Build duration in milliseconds

formatint64

Error stringoptional

Error message (only when status is failed)

ImageDigest stringoptional

Digest of built image (only when status is ready)

ImageRef stringoptional

Full image reference (only when status is ready)

Provenance BuildProvenanceoptional

BaseImageDigest stringoptional

Pinned base image digest used

BuildkitVersion stringoptional

BuildKit version used

LockfileHashes map[string, string]optional

Map of lockfile names to SHA256 hashes

SourceHash stringoptional

SHA256 hash of source tarball

Timestamp Timeoptional

Build completion timestamp

formatdate-time

QueuePosition int64optional

Position in build queue (only when status is queued)

StartedAt Timeoptional

Build start timestamp

formatdate-time

type BuildEvent struct{…}

Timestamp Time

Event timestamp

formatdate-time

Type BuildEventType

Event type

Accepts one of the following:

const BuildEventTypeLog BuildEventType = "log"

const BuildEventTypeStatus BuildEventType = "status"

const BuildEventTypeHeartbeat BuildEventType = "heartbeat"

Content stringoptional

Log line content (only for type=log)

Status BuildStatusoptional

New build status (only for type=status)

Accepts one of the following:

const BuildStatusQueued BuildStatus = "queued"

const BuildStatusBuilding BuildStatus = "building"

const BuildStatusPushing BuildStatus = "pushing"

const BuildStatusReady BuildStatus = "ready"

const BuildStatusFailed BuildStatus = "failed"

const BuildStatusCancelled BuildStatus = "cancelled"

type BuildPolicy struct{…}

CPUs int64optional

Number of vCPUs for builder VM (default 2)

MemoryMB int64optional

Memory limit for builder VM (default 2048)

NetworkMode BuildPolicyNetworkModeoptional

Network access during build

Accepts one of the following:

const BuildPolicyNetworkModeIsolated BuildPolicyNetworkMode = "isolated"

const BuildPolicyNetworkModeEgress BuildPolicyNetworkMode = "egress"

TimeoutSeconds int64optional

Maximum build duration (default 600)

type BuildProvenance struct{…}

BaseImageDigest stringoptional

Pinned base image digest used

BuildkitVersion stringoptional

BuildKit version used

LockfileHashes map[string, string]optional

Map of lockfile names to SHA256 hashes

SourceHash stringoptional

SHA256 hash of source tarball

Timestamp Timeoptional

Build completion timestamp

formatdate-time

type BuildStatus string

Build job status

Accepts one of the following:

const BuildStatusQueued BuildStatus = "queued"

const BuildStatusBuilding BuildStatus = "building"

const BuildStatusPushing BuildStatus = "pushing"

const BuildStatusReady BuildStatus = "ready"

const BuildStatusFailed BuildStatus = "failed"

const BuildStatusCancelled BuildStatus = "cancelled"