Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

images

package

Go to main page

Versions in this module

v0

v0.0.7

Mar 3, 2026

Changes in this version

type Manager

+ WaitForReady func(ctx context.Context, name string) error

+ type StatusEvent struct

+ Err error

+ Status string

v0.0.6

Feb 16, 2026

Changes in this version

+ type MirrorRequest struct

+ SourceImage string

+ type MirrorResult struct

+ Digest string

+ LocalRef string

+ SourceImage string

+ func MirrorBaseImage(ctx context.Context, registryURL string, req MirrorRequest, ...) (*MirrorResult, error)

type OCIClient

+ func (c *OCIClient) InspectManifestForLinux(ctx context.Context, imageRef string) (string, error)

+ func (c *OCIClient) PullAndUnpackForLinux(ctx context.Context, imageRef, digest, exportDir string) error

v0.0.5

Jan 16, 2026

v0.0.4

Jan 12, 2026

Changes in this version

+ const DefaultImageFormat

+ const StatusConverting

+ const StatusFailed

+ const StatusPending

+ const StatusPulling

+ const StatusReady

+ var ErrInvalidName = errors.New("invalid image name")

+ var ErrNotFound = errors.New("image not found")

+ func CreateEmptyExt4Disk(diskPath string, sizeBytes int64) error

+ func ExportRootfs(rootfsDir, outputPath string, format ExportFormat) (int64, error)

+ func GetDiskPath(p *paths.Paths, imageName string, digest string) (string, error)

+ func IsSystemdImage(entrypoint, cmd []string) bool

+ type BuildQueue struct

+ func NewBuildQueue(maxConcurrent int) *BuildQueue

+ func (q *BuildQueue) ActiveCount() int

+ func (q *BuildQueue) Enqueue(imageName string, req CreateImageRequest, startFn func()) int

+ func (q *BuildQueue) GetPosition(imageName string) *int

+ func (q *BuildQueue) MarkComplete(imageName string)

+ func (q *BuildQueue) PendingCount() int

+ func (q *BuildQueue) QueueLength() int

+ type CreateImageRequest struct

+ Name string

+ type ExportFormat string

+ const FormatCpio

+ const FormatErofs

+ const FormatExt4

+ type Image struct

+ Cmd []string

+ CreatedAt time.Time

+ Digest string

+ Entrypoint []string

+ Env map[string]string

+ Error *string

+ Name string

+ QueuePosition *int

+ SizeBytes *int64

+ Status string

+ WorkingDir string

+ type Manager interface

+ CreateImage func(ctx context.Context, req CreateImageRequest) (*Image, error)

+ DeleteImage func(ctx context.Context, name string) error

+ GetImage func(ctx context.Context, name string) (*Image, error)

+ ImportLocalImage func(ctx context.Context, repo, reference, digest string) (*Image, error)

+ ListImages func(ctx context.Context) ([]Image, error)

+ RecoverInterruptedBuilds func()

+ TotalImageBytes func(ctx context.Context) (int64, error)

+ TotalOCICacheBytes func(ctx context.Context) (int64, error)

+ func NewManager(p *paths.Paths, maxConcurrentBuilds int, meter metric.Meter) (Manager, error)

+ type ManifestInspector interface

+ type Metrics struct

+ type NormalizedRef struct

+ func ParseNormalizedRef(s string) (*NormalizedRef, error)

+ func (r *NormalizedRef) Digest() string

+ func (r *NormalizedRef) DigestHex() string

+ func (r *NormalizedRef) IsDigest() bool

+ func (r *NormalizedRef) Repository() string

+ func (r *NormalizedRef) Resolve(ctx context.Context, inspector ManifestInspector) (*ResolvedRef, error)

+ func (r *NormalizedRef) String() string

+ func (r *NormalizedRef) Tag() string

+ type OCIClient struct

+ func NewOCIClient(cacheDir string) (*OCIClient, error)

+ func (c *OCIClient) InspectManifest(ctx context.Context, imageRef string) (string, error)

+ func (c *OCIClient) PullAndUnpack(ctx context.Context, imageRef, digest, exportDir string) error

+ type QueuedBuild struct

+ ImageName string

+ Request CreateImageRequest

+ StartFn func()

+ type ResolvedRef struct

+ func NewResolvedRef(normalized *NormalizedRef, digest string) *ResolvedRef

+ func (r *ResolvedRef) Digest() string

+ func (r *ResolvedRef) DigestHex() string

+ func (r *ResolvedRef) Repository() string

+ func (r *ResolvedRef) String() string

+ func (r *ResolvedRef) Tag() string