Documentation ¶
Index ¶
- Variables
- func Compare(a, b *Config) bool
- func DecodeContainerConfig(src io.Reader) (*Config, *HostConfig, error)
- func Merge(userConf, imageConf *Config) error
- func Parse(cmd *flag.FlagSet, args []string) (*Config, *HostConfig, *flag.FlagSet, error)
- type Command
- type Config
- type ContainerConfigWrapper
- type DeviceMapping
- type Entrypoint
- type ExecConfig
- type HostConfig
- type IpcMode
- type KeyValuePair
- type LogConfig
- type LxcConfig
- type NetworkMode
- type PidMode
- type RestartPolicy
- type UTSMode
Constants ¶
This section is empty.
Variables ¶
var ( ErrConflictContainerNetworkAndLinks = fmt.Errorf("Conflicting options: --net=container can't be used with links. This would result in undefined behavior") ErrConflictNetworkAndDns = fmt.Errorf("Conflicting options: --dns and the network mode (--net)") ErrConflictNetworkHostname = fmt.Errorf("Conflicting options: -h and the network mode (--net)") ErrConflictHostNetworkAndLinks = fmt.Errorf("Conflicting options: --net=host can't be used with links. This would result in undefined behavior") ErrConflictContainerNetworkAndMac = fmt.Errorf("Conflicting options: --mac-address and the network mode (--net)") ErrConflictNetworkHosts = fmt.Errorf("Conflicting options: --add-host and the network mode (--net)") )
Functions ¶
func Compare ¶
Compare two Config struct. Do not compare the "Image" nor "Hostname" fields If OpenStdin is set, then it differs
func DecodeContainerConfig ¶ added in v1.7.0
func DecodeContainerConfig(src io.Reader) (*Config, *HostConfig, error)
Types ¶
type Command ¶ added in v1.7.0
type Command struct {
// contains filtered or unexported fields
}
func NewCommand ¶ added in v1.7.0
func (*Command) MarshalJSON ¶ added in v1.7.0
func (*Command) UnmarshalJSON ¶ added in v1.7.0
UnmarshalJSON decoded the entrypoint whether it's a string or an array of strings.
type Config ¶
type Config struct { Hostname string Domainname string User string AttachStdin bool AttachStdout bool AttachStderr bool PortSpecs []string // Deprecated - Can be in the format of 8080/tcp ExposedPorts map[nat.Port]struct{} Tty bool // Attach standard streams to a tty, including stdin if it is not closed. OpenStdin bool // Open stdin StdinOnce bool // If true, close stdin after the 1 attached client disconnects. Env []string Cmd *Command Image string // Name of the image as it was passed by the operator (eg. could be symbolic) Volumes map[string]struct{} VolumeDriver string WorkingDir string Entrypoint *Entrypoint NetworkDisabled bool MacAddress string OnBuild []string Labels map[string]string }
Note: the Config structure should hold only portable information about the container. Here, "portable" means "independent from the host we are running on". Non-portable information *should* appear in HostConfig.
type ContainerConfigWrapper ¶ added in v1.7.0
type ContainerConfigWrapper struct { *Config // contains filtered or unexported fields }
func MergeConfigs ¶ added in v1.3.0
func MergeConfigs(config *Config, hostConfig *HostConfig) *ContainerConfigWrapper
func (ContainerConfigWrapper) GetHostConfig ¶ added in v1.7.0
func (w ContainerConfigWrapper) GetHostConfig() *HostConfig
func (ContainerConfigWrapper) HostConfig ¶ added in v1.7.0
func (c ContainerConfigWrapper) HostConfig() *HostConfig
type DeviceMapping ¶ added in v1.2.0
func ParseDevice ¶ added in v1.2.0
func ParseDevice(device string) (DeviceMapping, error)
type Entrypoint ¶ added in v1.7.0
type Entrypoint struct {
// contains filtered or unexported fields
}
Entrypoint encapsulates the container entrypoint. It might be represented as a string or an array of strings. We need to override the json decoder to accept both options. The JSON decoder will fail if the api sends an string and
we try to decode it into an array of string.
func NewEntrypoint ¶ added in v1.7.0
func NewEntrypoint(parts ...string) *Entrypoint
func (*Entrypoint) Len ¶ added in v1.7.0
func (e *Entrypoint) Len() int
func (*Entrypoint) MarshalJSON ¶ added in v1.7.0
func (e *Entrypoint) MarshalJSON() ([]byte, error)
func (*Entrypoint) Slice ¶ added in v1.7.0
func (e *Entrypoint) Slice() []string
func (*Entrypoint) UnmarshalJSON ¶ added in v1.7.0
func (e *Entrypoint) UnmarshalJSON(b []byte) error
UnmarshalJSON decoded the entrypoint whether it's a string or an array of strings.
type ExecConfig ¶ added in v1.3.0
type HostConfig ¶
type HostConfig struct { Binds []string ContainerIDFile string LxcConf *LxcConfig Memory int64 // Memory limit (in bytes) MemorySwap int64 // Total memory usage (memory + swap); set `-1` to disable swap CpuPeriod int64 CpusetCpus string // CpusetCpus 0-2, 0,1 CpusetMems string // CpusetMems 0-2, 0,1 CpuQuota int64 BlkioWeight int64 // Block IO weight (relative weight vs. other containers) OomKillDisable bool // Whether to disable OOM Killer or not Privileged bool PortBindings nat.PortMap Links []string PublishAllPorts bool Dns []string DnsSearch []string ExtraHosts []string VolumesFrom []string Devices []DeviceMapping NetworkMode NetworkMode IpcMode IpcMode PidMode PidMode UTSMode UTSMode CapAdd []string CapDrop []string RestartPolicy RestartPolicy SecurityOpt []string ReadonlyRootfs bool Ulimits []*ulimit.Ulimit LogConfig LogConfig CgroupParent string // Parent cgroup. }
func DecodeHostConfig ¶ added in v1.7.0
func DecodeHostConfig(src io.Reader) (*HostConfig, error)
type IpcMode ¶ added in v1.4.0
type IpcMode string
func (IpcMode) IsContainer ¶ added in v1.4.0
type KeyValuePair ¶
type LxcConfig ¶ added in v1.7.0
type LxcConfig struct {
// contains filtered or unexported fields
}
func NewLxcConfig ¶ added in v1.7.0
func NewLxcConfig(values []KeyValuePair) *LxcConfig
func (*LxcConfig) MarshalJSON ¶ added in v1.7.0
func (*LxcConfig) Slice ¶ added in v1.7.0
func (c *LxcConfig) Slice() []KeyValuePair
func (*LxcConfig) UnmarshalJSON ¶ added in v1.7.0
type NetworkMode ¶ added in v0.11.0
type NetworkMode string
func (NetworkMode) IsBridge ¶ added in v1.7.0
func (n NetworkMode) IsBridge() bool
func (NetworkMode) IsContainer ¶ added in v0.11.0
func (n NetworkMode) IsContainer() bool
func (NetworkMode) IsHost ¶ added in v0.11.0
func (n NetworkMode) IsHost() bool
func (NetworkMode) IsNone ¶ added in v1.3.0
func (n NetworkMode) IsNone() bool
func (NetworkMode) IsPrivate ¶ added in v1.3.0
func (n NetworkMode) IsPrivate() bool
IsPrivate indicates whether container use it's private network stack
type PidMode ¶ added in v1.5.0
type PidMode string
type RestartPolicy ¶ added in v1.2.0
func ParseRestartPolicy ¶ added in v1.7.0
func ParseRestartPolicy(policy string) (RestartPolicy, error)
ParseRestartPolicy returns the parsed policy or an error indicating what is incorrect
func (*RestartPolicy) IsAlways ¶ added in v1.7.0
func (rp *RestartPolicy) IsAlways() bool
func (*RestartPolicy) IsNone ¶ added in v1.7.0
func (rp *RestartPolicy) IsNone() bool
func (*RestartPolicy) IsOnFailure ¶ added in v1.7.0
func (rp *RestartPolicy) IsOnFailure() bool