dockerclient

Documentation

Index

• Constants
• Variables
• type DockerAPIVersion
  • func (lhs DockerAPIVersion) Matches(selector string) (bool, error)
• type DockerVersion
  • func GetKnownAPIVersions() []DockerVersion
  • func (d DockerVersion) String() string
• type LoggingDriver

Constants

const (
	// PullImageTimeout is the timeout for the PullImage API
	PullImageTimeout = 2 * time.Hour
	// ListImagesTimeout is the timeout for the ListImages API
	ListImagesTimeout = 10 * time.Minute
	// LoadImageTimeout is the timeout for the LoadImage API. It's set
	// to much lower value than pullImageTimeout as it involves loading
	// image from either a file or STDIN calls involved.
	// This value is set based on benchmarking the time of loading the pause container image,
	// since it's currently only used to load that image. If this is to be used to load any
	// other image in the future, additional benchmarking will be required.
	// Per benchmark, 2 min is roughly 4x of the worst case (29s) across 400 image loads on
	// al1/al2/al2gpu/al2arm with smallest instance type available (t2.nano/a1.medium) and
	// burst balance = 0.
	LoadImageTimeout = 2 * time.Minute
	// RemoveImageTimeout is the timeout for the RemoveImage API.
	RemoveImageTimeout = 3 * time.Minute

	// CreateContainerTimeout is the timeout for the CreateContainer API.
	CreateContainerTimeout = 4 * time.Minute
	// ListContainersTimeout is the timeout for the ListContainers API.
	ListContainersTimeout = 10 * time.Minute
	// InspectContainerTimeout is the timeout for the InspectContainer API.
	InspectContainerTimeout = 30 * time.Second
	// StopContainerTimeout is the timeout for the StopContainer API.
	StopContainerTimeout = 30 * time.Second
	// RemoveContainerTimeout is the timeout for the RemoveContainer API.
	RemoveContainerTimeout = 5 * time.Minute

	// CreateVolumeTimeout is the timeout for CreateVolume API.
	CreateVolumeTimeout = 5 * time.Minute
	// InspectVolumeTimeout is the timeout for InspectVolume API.
	InspectVolumeTimeout = 5 * time.Minute
	// RemoveVolumeTimeout is the timeout for RemoveVolume API.
	RemoveVolumeTimeout = 5 * time.Minute

	// ListPluginsTimeout is the timeout for ListPlugins API.
	ListPluginsTimeout = 1 * time.Minute

	// StatsInactivityTimeout controls the amount of time we hold open a
	// connection to the Docker daemon waiting for stats data.
	// We set this a few seconds below our stats publishling interval (20s)
	// so that we can disconnect and warn the user when metrics reporting
	// may be impacted. This is usually caused by a over-stressed docker daemon.
	StatsInactivityTimeout = 18 * time.Second

	// DockerPullBeginTimeout is the timeout from when a 'pull' is called to when
	// we expect to see output on the pull progress stream. This is to work
	// around a docker bug which sometimes results in pulls not progressing.
	DockerPullBeginTimeout = 5 * time.Minute

	// VersionTimeout is the timeout for the Version API
	VersionTimeout = 10 * time.Second

	// InfoTimeout is the timeout for the Info API
	InfoTimeout = 10 * time.Second
)

Timelimits for docker operations enforced above docker

Variables

var LoggingDriverMinimumVersion = map[LoggingDriver]DockerVersion{
	JSONFileDriver:   Version_1_18,
	SyslogDriver:     Version_1_18,
	JournaldDriver:   Version_1_19,
	GelfDriver:       Version_1_20,
	FluentdDriver:    Version_1_20,
	AWSLogsDriver:    Version_1_21,
	SplunklogsDriver: Version_1_22,
	LogentriesDriver: Version_1_25,
	SumoLogicDriver:  Version_1_29,
	NoneDriver:       Version_1_19,
}

Types

type DockerAPIVersion

type DockerAPIVersion string

func (DockerAPIVersion) Matches

func (lhs DockerAPIVersion) Matches(selector string) (bool, error)

Matches returns whether or not a version matches a given selector. The selector can be any of the following:

* x.y -- Matches a version exactly the same as the selector version * >=x.y -- Matches a version greater than or equal to the selector version * >x.y -- Matches a version greater than the selector version * <=x.y -- Matches a version less than or equal to the selector version * <x.y -- Matches a version less than the selector version * x.y,a.b -- Matches if the version matches either of the two selector versions

type DockerVersion

type DockerVersion string

const (
	Version_1_17 DockerVersion = "1.17"
	Version_1_18 DockerVersion = "1.18"
	Version_1_19 DockerVersion = "1.19"
	Version_1_20 DockerVersion = "1.20"
	Version_1_21 DockerVersion = "1.21"
	Version_1_22 DockerVersion = "1.22"
	Version_1_23 DockerVersion = "1.23"
	Version_1_24 DockerVersion = "1.24"
	Version_1_25 DockerVersion = "1.25"
	Version_1_26 DockerVersion = "1.26"
	Version_1_27 DockerVersion = "1.27"
	Version_1_28 DockerVersion = "1.28"
	Version_1_29 DockerVersion = "1.29"
	Version_1_30 DockerVersion = "1.30"
	Version_1_31 DockerVersion = "1.31"
	Version_1_32 DockerVersion = "1.32"
)

func GetKnownAPIVersions

func GetKnownAPIVersions() []DockerVersion

GetKnownAPIVersions returns all of the API versions that we know about. It doesn't care if the version is supported by Docker or ECS agent

func (DockerVersion) String

func (d DockerVersion) String() string

type LoggingDriver

type LoggingDriver string

const (
	JSONFileDriver   LoggingDriver = "json-file"
	SyslogDriver     LoggingDriver = "syslog"
	JournaldDriver   LoggingDriver = "journald"
	GelfDriver       LoggingDriver = "gelf"
	FluentdDriver    LoggingDriver = "fluentd"
	AWSLogsDriver    LoggingDriver = "awslogs"
	SplunklogsDriver LoggingDriver = "splunk"
	LogentriesDriver LoggingDriver = "logentries"
	SumoLogicDriver  LoggingDriver = "sumologic"
	NoneDriver       LoggingDriver = "none"
)