Help us shape the future of Go! Take the 2026 Go Developer Survey

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
- API
  
  Reference documentation for the pkg.go.dev API
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

builder

package

Go to main page

Versions in this module

v0

v0.2.1

Nov 1, 2026

v0.2.0

Oct 25, 2026

Changes in this version

+ type Builder struct

+ Downloader *vscode.Downloader

+ Resolver *features.Resolver

+ func New() *Builder

+ func (b *Builder) BaseMetadata(ctx context.Context, dc *spec.DevContainer, opts Options) ([]metadata.Entry, error)

+ func (b *Builder) Build(ctx context.Context, opts Options) (*Result, error)

+ func (b *Builder) Generate(ctx context.Context, opts Options) (*Result, error)

+ type Options struct

+ BuildArgs map[string]string

+ BuildKitAddress string

+ CacheFrom []string

+ CacheTo []string

+ Docker *dockerclient.Client

+ FeatureBaseDir string

+ FeatureLockfile *features.LockfileState

+ InstallVSCodeServer bool

+ KeepWorkDir bool

+ Labels map[string]string

+ Load bool

+ Logger func(format string, args ...any)

+ Metadata metadata.CollectOptions

+ NoCache bool

+ OmitSyntaxDirective bool

+ Output string

+ OutputDir string

+ OutputWriter io.Writer

+ Platforms []string

+ Progress string

+ Pull bool

+ Push bool

+ RegistryAuth buildkit.RegistryAuth

+ SkipFeatureAutoMapping bool

+ SkipFeatures bool

+ SkipImageMetaResolve bool

+ Spec *spec.DevContainer

+ SpecPath string

+ Stderr io.Writer

+ Stdout io.Writer

+ Tags []string

+ UserDataFolder string

+ VSCode vscode.Spec

+ WorkDir string

+ Workspace string

+ type Result struct

+ ContextDir string

+ Features []features.Resolved

+ FinalDockerfile string

+ VSCodeServer *vscode.Result