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

core

package

Go to main page

Versions in this module

v0

v0.34.0

Oct 21, 2024

Changes in this version

+ const LabelReap

+ func AddDefaultLabels(sessionID string, target map[string]string)

+ func MergeCustomLabels(dst, src map[string]string) error

+ func MustExtractDockerHost(ctx context.Context) string

+ func MustExtractDockerSocket(ctx context.Context) string

v0.33.0

Aug 20, 2024

Changes in this version

+ func ExtractImagesFromReader(r io.Reader, buildArgs map[string]*string) ([]string, error)

v0.32.0

Jul 5, 2024

v0.31.0

May 9, 2024

v0.30.0

Apr 8, 2024

v0.29.1

Mar 6, 2024

v0.29.0

Mar 6, 2024

v0.28.0

Feb 15, 2024

Changes in this version

+ const IP

+ const IndexDockerIO

+ const LabelBase

+ const LabelLang

+ const LabelReaper

+ const LabelRyuk

+ const LabelSessionID

+ const LabelVersion

+ const URL

+ const URLIP

+ const URLPath

+ const URLPort

+ const URLSchema

+ const URLSubdomain

+ const URLUsername

+ var DockerHostContextKey = dockerHostContext("docker_host")

+ var DockerSocketPath = "/var/run/docker.sock"

+ var DockerSocketPathWithSchema = DockerSocketSchema + DockerSocketPath

+ var DockerSocketSchema = "unix://"

+ var ErrDockerHostNotSet = errors.New("DOCKER_HOST is not set")

+ var ErrDockerSocketNotSetInContext = errors.New("socket not set in context")

+ var ErrDockerSocketNotSetInProperties = errors.New("socket not set in ~/.testcontainers.properties")

+ var ErrDockerSocketOverrideNotSet = errors.New("TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE is not set")

+ var ErrNoUnixSchema = errors.New("URL schema is not unix")

+ var ErrRootlessDockerNotFound = errors.New("rootless Docker not found")

+ var ErrRootlessDockerNotFoundHomeDesktopDir = errors.New("checked path: ~/.docker/desktop/docker.sock")

+ var ErrRootlessDockerNotFoundHomeRunDir = errors.New("checked path: ~/.docker/run/docker.sock")

+ var ErrRootlessDockerNotFoundRunDir = errors.New("checked path: /run/user/${uid}/docker.sock")

+ var ErrRootlessDockerNotFoundXDGRuntimeDir = errors.New("checked path: $XDG_RUNTIME_DIR")

+ var ErrRootlessDockerNotSupportedWindows = errors.New("rootless Docker is not supported on Windows")

+ var ErrSocketNotFound = errors.New("socket not found")

+ var ErrSocketNotFoundInPath = errors.New("docker socket not found in " + DockerSocketPath)

+ var ErrTestcontainersHostNotSetInProperties = errors.New("tc.host not set in ~/.testcontainers.properties")

+ var ErrXDGRuntimeDirNotSet = errors.New("XDG_RUNTIME_DIR is not set")

+ var TCPSchema = "tcp://"

+ var WindowsDockerSocketPath = "//var/run/docker.sock"

+ func DefaultGatewayIP() (string, error)

+ func DefaultLabels(sessionID string) map[string]string

+ func ExtractDockerHost(ctx context.Context) string

+ func ExtractDockerSocket(ctx context.Context) string

+ func ExtractImagesFromDockerfile(dockerfile string, buildArgs map[string]*string) ([]string, error)

+ func ExtractRegistry(image string, fallback string) string

+ func InAContainer() bool

+ func IsURL(str string) bool

+ func IsWindows() bool

+ func NewClient(ctx context.Context, ops ...client.Opt) (*client.Client, error)

+ func ProcessID() string

+ func ProjectPath() string

+ func SessionID() string