Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  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

containers

package module

Go to main page

Versions in this module

v0

v0.4.5

Feb 28, 2024

v0.4.4

Sep 19, 2023

v0.4.3

Aug 21, 2023

Changes in this version

+ var ErrorClientPull = errors.New("client pull failed")

+ var ErrorClientWait = errors.New("client wait failed")

+ var ErrorContainerCreate = errors.New("creating container failed")

+ var ErrorContainerInspect = errors.New("inspecting container failed")

+ var ErrorContainerLogs = errors.New("getting container logs failed")

+ var ErrorContainerOptions = errors.New("container options failed")

+ var ErrorContainerStart = errors.New("start container failed")

+ var ErrorContainerWait = errors.New("container wait failed")

+ var ErrorExitCode = errors.New("exit-code")

+ var ErrorImageBuild = errors.New("building image failed")

+ var ErrorImageBuildDockerFile = errors.New("building Dockerfile failed")

+ var ErrorImageBuildResCopy = errors.New("copying response from image build failed")

+ var ErrorImageOptions = errors.New("image options failed")

+ var ErrorImagePull = errors.New("pulling image failed")

+ var ErrorImagePullStatus = errors.New("copying pull status failed")

type Client

+ Docker *client.Client

v0.4.2

Mar 3, 2023

v0.4.1

Jan 18, 2023

v0.4.0

Jan 4, 2023

Changes in this version

+ var ForceRebuild = false

+ func NewFilter(key, value string) filters.Args

+ type Client struct

+ func New() (dockerClient *Client, err error)

+ func (c *Client) Clean(ctx context.Context, age time.Duration, filter filters.Args) error

+ func (c *Client) Image(ctx context.Context, image string, options ...ImageOption) (_image *Image, err error)

+ type Container struct

+ func (c *Container) Cleanup(ctx context.Context) error

+ func (c *Container) Run(ctx context.Context) (*MuxedReadCloser, error)

+ func (c *Container) Wait(ctx context.Context) error

+ type ContainerOption func(*Container) error

+ func Command(cmd []string) ContainerOption

+ func Shell(cmd []string) ContainerOption

+ func Variable(key, value string) ContainerOption

+ func Variables(vars map[string]string) ContainerOption

+ func Volume(sourcePath, containerPath string) ContainerOption

+ func WorkDir(workDir string) ContainerOption

+ type Image struct

+ func (i *Image) Instantiate(ctx context.Context, options ...ContainerOption) (*Container, error)

+ func (i *Image) Name() string

+ func (i *Image) Pull(ctx context.Context) (*Image, error)

+ type ImageOption func(*Image) error

+ func Build(tarball io.Reader) ImageOption

+ type MuxedReadCloser struct

+ func (mx *MuxedReadCloser) Close() error

+ func (mx *MuxedReadCloser) Combined() io.ReadCloser

+ func (mx *MuxedReadCloser) Separated() (stdOut io.ReadCloser, stdErr io.ReadCloser)

+ func (mx *MuxedReadCloser) Stderr() io.ReadCloser

+ func (mx *MuxedReadCloser) Stdout() io.ReadCloser