212 lines
6.9 KiB
Go
212 lines
6.9 KiB
Go
package runconfig
|
|
|
|
import (
|
|
"encoding/json"
|
|
"io"
|
|
"strings"
|
|
|
|
"github.com/docker/docker/pkg/nat"
|
|
)
|
|
|
|
// 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.
|
|
type Entrypoint struct {
|
|
parts []string
|
|
}
|
|
|
|
// MarshalJSON Marshals (or serializes) the Entrypoint into the json format.
|
|
// This method is needed to implement json.Marshaller.
|
|
func (e *Entrypoint) MarshalJSON() ([]byte, error) {
|
|
if e == nil {
|
|
return []byte{}, nil
|
|
}
|
|
return json.Marshal(e.Slice())
|
|
}
|
|
|
|
// UnmarshalJSON decodes the entrypoint whether it's a string or an array of strings.
|
|
// This method is needed to implement json.Unmarshaler.
|
|
func (e *Entrypoint) UnmarshalJSON(b []byte) error {
|
|
if len(b) == 0 {
|
|
return nil
|
|
}
|
|
|
|
p := make([]string, 0, 1)
|
|
if err := json.Unmarshal(b, &p); err != nil {
|
|
var s string
|
|
if err := json.Unmarshal(b, &s); err != nil {
|
|
return err
|
|
}
|
|
p = append(p, s)
|
|
}
|
|
e.parts = p
|
|
return nil
|
|
}
|
|
|
|
// Len returns the number of parts of the Entrypoint.
|
|
func (e *Entrypoint) Len() int {
|
|
if e == nil {
|
|
return 0
|
|
}
|
|
return len(e.parts)
|
|
}
|
|
|
|
// Slice gets the parts of the Entrypoint as a Slice of string.
|
|
func (e *Entrypoint) Slice() []string {
|
|
if e == nil {
|
|
return nil
|
|
}
|
|
return e.parts
|
|
}
|
|
|
|
// NewEntrypoint creates an Entrypoint based on the specified parts (as strings).
|
|
func NewEntrypoint(parts ...string) *Entrypoint {
|
|
return &Entrypoint{parts}
|
|
}
|
|
|
|
// Command encapsulates the container command.
|
|
// 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.
|
|
type Command struct {
|
|
parts []string
|
|
}
|
|
|
|
// ToString gets a string representing a Command.
|
|
func (e *Command) ToString() string {
|
|
return strings.Join(e.parts, " ")
|
|
}
|
|
|
|
// MarshalJSON Marshals (or serializes) the Command into the json format.
|
|
// This method is needed to implement json.Marshaller.
|
|
func (e *Command) MarshalJSON() ([]byte, error) {
|
|
if e == nil {
|
|
return []byte{}, nil
|
|
}
|
|
return json.Marshal(e.Slice())
|
|
}
|
|
|
|
// UnmarshalJSON decodes the entrypoint whether it's a string or an array of strings.
|
|
// This method is needed to implement json.Unmarshaler.
|
|
func (e *Command) UnmarshalJSON(b []byte) error {
|
|
if len(b) == 0 {
|
|
return nil
|
|
}
|
|
|
|
p := make([]string, 0, 1)
|
|
if err := json.Unmarshal(b, &p); err != nil {
|
|
var s string
|
|
if err := json.Unmarshal(b, &s); err != nil {
|
|
return err
|
|
}
|
|
p = append(p, s)
|
|
}
|
|
e.parts = p
|
|
return nil
|
|
}
|
|
|
|
// Len returns the number of parts of the Entrypoint.
|
|
func (e *Command) Len() int {
|
|
if e == nil {
|
|
return 0
|
|
}
|
|
return len(e.parts)
|
|
}
|
|
|
|
// Slice gets the parts of the Entrypoint as a Slice of string.
|
|
func (e *Command) Slice() []string {
|
|
if e == nil {
|
|
return nil
|
|
}
|
|
return e.parts
|
|
}
|
|
|
|
// NewCommand creates a Command based on the specified parts (as strings).
|
|
func NewCommand(parts ...string) *Command {
|
|
return &Command{parts}
|
|
}
|
|
|
|
// Config contains the configuration data about a container.
|
|
// It 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 Config struct {
|
|
Hostname string // Hostname
|
|
Domainname string // Domainname
|
|
User string // User that will run the command(s) inside the container
|
|
AttachStdin bool // Attach the standard input, makes possible user interaction
|
|
AttachStdout bool // Attach the standard output
|
|
AttachStderr bool // Attach the standard error
|
|
ExposedPorts map[nat.Port]struct{} // List of exposed ports
|
|
PublishService string // Name of the network service exposed by the container
|
|
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 // List of environment variable to set in the container
|
|
Cmd *Command // Command to run when starting the container
|
|
Image string // Name of the image as it was passed by the operator (eg. could be symbolic)
|
|
Volumes map[string]struct{} // List of volumes (mounts) used for the container
|
|
VolumeDriver string // Name of the volume driver used to mount volumes
|
|
WorkingDir string // Current directory (PWD) in the command will be launched
|
|
Entrypoint *Entrypoint // Entrypoint to run when starting the container
|
|
NetworkDisabled bool // Is network disabled
|
|
MacAddress string // Mac Address of the container
|
|
OnBuild []string // ONBUILD metadata that were defined on the image Dockerfile
|
|
Labels map[string]string // List of labels set to this container
|
|
}
|
|
|
|
// ContainerConfigWrapper is a Config wrapper that hold the container Config (portable)
|
|
// and the corresponding HostConfig (non-portable).
|
|
type ContainerConfigWrapper struct {
|
|
*Config
|
|
InnerHostConfig *HostConfig `json:"HostConfig,omitempty"`
|
|
Cpuset string `json:",omitempty"` // Deprecated. Exported for backwards compatibility.
|
|
*HostConfig // Deprecated. Exported to read attrubutes from json that are not in the inner host config structure.
|
|
|
|
}
|
|
|
|
// GetHostConfig gets the HostConfig of the Config.
|
|
// It's mostly there to handle Deprecated fields of the ContainerConfigWrapper
|
|
func (w *ContainerConfigWrapper) GetHostConfig() *HostConfig {
|
|
hc := w.HostConfig
|
|
|
|
if hc == nil && w.InnerHostConfig != nil {
|
|
hc = w.InnerHostConfig
|
|
} else if w.InnerHostConfig != nil {
|
|
if hc.Memory != 0 && w.InnerHostConfig.Memory == 0 {
|
|
w.InnerHostConfig.Memory = hc.Memory
|
|
}
|
|
if hc.MemorySwap != 0 && w.InnerHostConfig.MemorySwap == 0 {
|
|
w.InnerHostConfig.MemorySwap = hc.MemorySwap
|
|
}
|
|
if hc.CPUShares != 0 && w.InnerHostConfig.CPUShares == 0 {
|
|
w.InnerHostConfig.CPUShares = hc.CPUShares
|
|
}
|
|
|
|
hc = w.InnerHostConfig
|
|
}
|
|
|
|
if hc != nil && w.Cpuset != "" && hc.CpusetCpus == "" {
|
|
hc.CpusetCpus = w.Cpuset
|
|
}
|
|
|
|
return hc
|
|
}
|
|
|
|
// DecodeContainerConfig decodes a json encoded config into a ContainerConfigWrapper
|
|
// struct and returns both a Config and an HostConfig struct
|
|
// Be aware this function is not checking whether the resulted structs are nil,
|
|
// it's your business to do so
|
|
func DecodeContainerConfig(src io.Reader) (*Config, *HostConfig, error) {
|
|
decoder := json.NewDecoder(src)
|
|
|
|
var w ContainerConfigWrapper
|
|
if err := decoder.Decode(&w); err != nil {
|
|
return nil, nil, err
|
|
}
|
|
|
|
return w.Config, w.GetHostConfig(), nil
|
|
}
|