1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072 |
- package container
- import (
- "bytes"
- "encoding/json"
- "fmt"
- "io"
- "net"
- "os"
- "path/filepath"
- "runtime"
- "strconv"
- "strings"
- "sync"
- "syscall"
- "time"
- containertypes "github.com/docker/docker/api/types/container"
- mounttypes "github.com/docker/docker/api/types/mount"
- networktypes "github.com/docker/docker/api/types/network"
- swarmtypes "github.com/docker/docker/api/types/swarm"
- "github.com/docker/docker/container/stream"
- "github.com/docker/docker/daemon/exec"
- "github.com/docker/docker/daemon/logger"
- "github.com/docker/docker/daemon/logger/jsonfilelog"
- "github.com/docker/docker/daemon/network"
- "github.com/docker/docker/image"
- "github.com/docker/docker/layer"
- "github.com/docker/docker/libcontainerd"
- "github.com/docker/docker/opts"
- "github.com/docker/docker/pkg/containerfs"
- "github.com/docker/docker/pkg/idtools"
- "github.com/docker/docker/pkg/ioutils"
- "github.com/docker/docker/pkg/signal"
- "github.com/docker/docker/pkg/symlink"
- "github.com/docker/docker/pkg/system"
- "github.com/docker/docker/restartmanager"
- "github.com/docker/docker/runconfig"
- "github.com/docker/docker/volume"
- "github.com/docker/go-connections/nat"
- "github.com/docker/go-units"
- "github.com/docker/libnetwork"
- "github.com/docker/libnetwork/netlabel"
- "github.com/docker/libnetwork/options"
- "github.com/docker/libnetwork/types"
- agentexec "github.com/docker/swarmkit/agent/exec"
- "github.com/pkg/errors"
- "github.com/sirupsen/logrus"
- "golang.org/x/net/context"
- )
- const configFileName = "config.v2.json"
- const (
- // DefaultStopTimeout is the timeout (in seconds) for the syscall signal used to stop a container.
- DefaultStopTimeout = 10
- )
- var (
- errInvalidEndpoint = errors.New("invalid endpoint while building port map info")
- errInvalidNetwork = errors.New("invalid network settings while building port map info")
- )
- // Container holds the structure defining a container object.
- type Container struct {
- StreamConfig *stream.Config
- // embed for Container to support states directly.
- *State `json:"State"` // Needed for Engine API version <= 1.11
- Root string `json:"-"` // Path to the "home" of the container, including metadata.
- BaseFS containerfs.ContainerFS `json:"-"` // interface containing graphdriver mount
- RWLayer layer.RWLayer `json:"-"`
- ID string
- Created time.Time
- Managed bool
- Path string
- Args []string
- Config *containertypes.Config
- ImageID image.ID `json:"Image"`
- NetworkSettings *network.Settings
- LogPath string
- Name string
- Driver string
- Platform string
- // MountLabel contains the options for the 'mount' command
- MountLabel string
- ProcessLabel string
- RestartCount int
- HasBeenStartedBefore bool
- HasBeenManuallyStopped bool // used for unless-stopped restart policy
- MountPoints map[string]*volume.MountPoint
- HostConfig *containertypes.HostConfig `json:"-"` // do not serialize the host config in the json, otherwise we'll make the container unportable
- ExecCommands *exec.Store `json:"-"`
- DependencyStore agentexec.DependencyGetter `json:"-"`
- SecretReferences []*swarmtypes.SecretReference
- ConfigReferences []*swarmtypes.ConfigReference
- // logDriver for closing
- LogDriver logger.Logger `json:"-"`
- LogCopier *logger.Copier `json:"-"`
- restartManager restartmanager.RestartManager
- attachContext *attachContext
- // Fields here are specific to Unix platforms
- AppArmorProfile string
- HostnamePath string
- HostsPath string
- ShmPath string
- ResolvConfPath string
- SeccompProfile string
- NoNewPrivileges bool
- // Fields here are specific to Windows
- NetworkSharedContainerID string `json:"-"`
- SharedEndpointList []string `json:"-"`
- }
- // NewBaseContainer creates a new container with its
- // basic configuration.
- func NewBaseContainer(id, root string) *Container {
- return &Container{
- ID: id,
- State: NewState(),
- ExecCommands: exec.NewStore(),
- Root: root,
- MountPoints: make(map[string]*volume.MountPoint),
- StreamConfig: stream.NewConfig(),
- attachContext: &attachContext{},
- }
- }
- // FromDisk loads the container configuration stored in the host.
- func (container *Container) FromDisk() error {
- pth, err := container.ConfigPath()
- if err != nil {
- return err
- }
- jsonSource, err := os.Open(pth)
- if err != nil {
- return err
- }
- defer jsonSource.Close()
- dec := json.NewDecoder(jsonSource)
- // Load container settings
- if err := dec.Decode(container); err != nil {
- return err
- }
- // Ensure the platform is set if blank. Assume it is the platform of the
- // host OS if not, to ensure containers created before multiple-platform
- // support are migrated
- if container.Platform == "" {
- container.Platform = runtime.GOOS
- }
- return container.readHostConfig()
- }
- // toDisk saves the container configuration on disk and returns a deep copy.
- func (container *Container) toDisk() (*Container, error) {
- var (
- buf bytes.Buffer
- deepCopy Container
- )
- pth, err := container.ConfigPath()
- if err != nil {
- return nil, err
- }
- // Save container settings
- f, err := ioutils.NewAtomicFileWriter(pth, 0600)
- if err != nil {
- return nil, err
- }
- defer f.Close()
- w := io.MultiWriter(&buf, f)
- if err := json.NewEncoder(w).Encode(container); err != nil {
- return nil, err
- }
- if err := json.NewDecoder(&buf).Decode(&deepCopy); err != nil {
- return nil, err
- }
- deepCopy.HostConfig, err = container.WriteHostConfig()
- if err != nil {
- return nil, err
- }
- return &deepCopy, nil
- }
- // CheckpointTo makes the Container's current state visible to queries, and persists state.
- // Callers must hold a Container lock.
- func (container *Container) CheckpointTo(store ViewDB) error {
- deepCopy, err := container.toDisk()
- if err != nil {
- return err
- }
- return store.Save(deepCopy)
- }
- // readHostConfig reads the host configuration from disk for the container.
- func (container *Container) readHostConfig() error {
- container.HostConfig = &containertypes.HostConfig{}
- // If the hostconfig file does not exist, do not read it.
- // (We still have to initialize container.HostConfig,
- // but that's OK, since we just did that above.)
- pth, err := container.HostConfigPath()
- if err != nil {
- return err
- }
- f, err := os.Open(pth)
- if err != nil {
- if os.IsNotExist(err) {
- return nil
- }
- return err
- }
- defer f.Close()
- if err := json.NewDecoder(f).Decode(&container.HostConfig); err != nil {
- return err
- }
- container.InitDNSHostConfig()
- return nil
- }
- // WriteHostConfig saves the host configuration on disk for the container,
- // and returns a deep copy of the saved object. Callers must hold a Container lock.
- func (container *Container) WriteHostConfig() (*containertypes.HostConfig, error) {
- var (
- buf bytes.Buffer
- deepCopy containertypes.HostConfig
- )
- pth, err := container.HostConfigPath()
- if err != nil {
- return nil, err
- }
- f, err := ioutils.NewAtomicFileWriter(pth, 0644)
- if err != nil {
- return nil, err
- }
- defer f.Close()
- w := io.MultiWriter(&buf, f)
- if err := json.NewEncoder(w).Encode(&container.HostConfig); err != nil {
- return nil, err
- }
- if err := json.NewDecoder(&buf).Decode(&deepCopy); err != nil {
- return nil, err
- }
- return &deepCopy, nil
- }
- // SetupWorkingDirectory sets up the container's working directory as set in container.Config.WorkingDir
- func (container *Container) SetupWorkingDirectory(rootIDs idtools.IDPair) error {
- // TODO @jhowardmsft, @gupta-ak LCOW Support. This will need revisiting.
- // We will need to do remote filesystem operations here.
- if container.Platform != runtime.GOOS {
- return nil
- }
- if container.Config.WorkingDir == "" {
- return nil
- }
- container.Config.WorkingDir = filepath.Clean(container.Config.WorkingDir)
- pth, err := container.GetResourcePath(container.Config.WorkingDir)
- if err != nil {
- return err
- }
- if err := idtools.MkdirAllAndChownNew(pth, 0755, rootIDs); err != nil {
- pthInfo, err2 := os.Stat(pth)
- if err2 == nil && pthInfo != nil && !pthInfo.IsDir() {
- return errors.Errorf("Cannot mkdir: %s is not a directory", container.Config.WorkingDir)
- }
- return err
- }
- return nil
- }
- // GetResourcePath evaluates `path` in the scope of the container's BaseFS, with proper path
- // sanitisation. Symlinks are all scoped to the BaseFS of the container, as
- // though the container's BaseFS was `/`.
- //
- // The BaseFS of a container is the host-facing path which is bind-mounted as
- // `/` inside the container. This method is essentially used to access a
- // particular path inside the container as though you were a process in that
- // container.
- //
- // NOTE: The returned path is *only* safely scoped inside the container's BaseFS
- // if no component of the returned path changes (such as a component
- // symlinking to a different path) between using this method and using the
- // path. See symlink.FollowSymlinkInScope for more details.
- func (container *Container) GetResourcePath(path string) (string, error) {
- // IMPORTANT - These are paths on the OS where the daemon is running, hence
- // any filepath operations must be done in an OS agnostic way.
- r, e := container.BaseFS.ResolveScopedPath(path, false)
- // Log this here on the daemon side as there's otherwise no indication apart
- // from the error being propagated all the way back to the client. This makes
- // debugging significantly easier and clearly indicates the error comes from the daemon.
- if e != nil {
- logrus.Errorf("Failed to ResolveScopedPath BaseFS %s path %s %s\n", container.BaseFS.Path(), path, e)
- }
- return r, e
- }
- // GetRootResourcePath evaluates `path` in the scope of the container's root, with proper path
- // sanitisation. Symlinks are all scoped to the root of the container, as
- // though the container's root was `/`.
- //
- // The root of a container is the host-facing configuration metadata directory.
- // Only use this method to safely access the container's `container.json` or
- // other metadata files. If in doubt, use container.GetResourcePath.
- //
- // NOTE: The returned path is *only* safely scoped inside the container's root
- // if no component of the returned path changes (such as a component
- // symlinking to a different path) between using this method and using the
- // path. See symlink.FollowSymlinkInScope for more details.
- func (container *Container) GetRootResourcePath(path string) (string, error) {
- // IMPORTANT - These are paths on the OS where the daemon is running, hence
- // any filepath operations must be done in an OS agnostic way.
- cleanPath := filepath.Join(string(os.PathSeparator), path)
- return symlink.FollowSymlinkInScope(filepath.Join(container.Root, cleanPath), container.Root)
- }
- // ExitOnNext signals to the monitor that it should not restart the container
- // after we send the kill signal.
- func (container *Container) ExitOnNext() {
- container.RestartManager().Cancel()
- }
- // HostConfigPath returns the path to the container's JSON hostconfig
- func (container *Container) HostConfigPath() (string, error) {
- return container.GetRootResourcePath("hostconfig.json")
- }
- // ConfigPath returns the path to the container's JSON config
- func (container *Container) ConfigPath() (string, error) {
- return container.GetRootResourcePath(configFileName)
- }
- // CheckpointDir returns the directory checkpoints are stored in
- func (container *Container) CheckpointDir() string {
- return filepath.Join(container.Root, "checkpoints")
- }
- // StartLogger starts a new logger driver for the container.
- func (container *Container) StartLogger() (logger.Logger, error) {
- cfg := container.HostConfig.LogConfig
- initDriver, err := logger.GetLogDriver(cfg.Type)
- if err != nil {
- return nil, errors.Wrap(err, "failed to get logging factory")
- }
- info := logger.Info{
- Config: cfg.Config,
- ContainerID: container.ID,
- ContainerName: container.Name,
- ContainerEntrypoint: container.Path,
- ContainerArgs: container.Args,
- ContainerImageID: container.ImageID.String(),
- ContainerImageName: container.Config.Image,
- ContainerCreated: container.Created,
- ContainerEnv: container.Config.Env,
- ContainerLabels: container.Config.Labels,
- DaemonName: "docker",
- }
- // Set logging file for "json-logger"
- if cfg.Type == jsonfilelog.Name {
- info.LogPath, err = container.GetRootResourcePath(fmt.Sprintf("%s-json.log", container.ID))
- if err != nil {
- return nil, err
- }
- }
- l, err := initDriver(info)
- if err != nil {
- return nil, err
- }
- if containertypes.LogMode(cfg.Config["mode"]) == containertypes.LogModeNonBlock {
- bufferSize := int64(-1)
- if s, exists := cfg.Config["max-buffer-size"]; exists {
- bufferSize, err = units.RAMInBytes(s)
- if err != nil {
- return nil, err
- }
- }
- l = logger.NewRingLogger(l, info, bufferSize)
- }
- return l, nil
- }
- // GetProcessLabel returns the process label for the container.
- func (container *Container) GetProcessLabel() string {
- // even if we have a process label return "" if we are running
- // in privileged mode
- if container.HostConfig.Privileged {
- return ""
- }
- return container.ProcessLabel
- }
- // GetMountLabel returns the mounting label for the container.
- // This label is empty if the container is privileged.
- func (container *Container) GetMountLabel() string {
- return container.MountLabel
- }
- // GetExecIDs returns the list of exec commands running on the container.
- func (container *Container) GetExecIDs() []string {
- return container.ExecCommands.List()
- }
- // ShouldRestart decides whether the daemon should restart the container or not.
- // This is based on the container's restart policy.
- func (container *Container) ShouldRestart() bool {
- shouldRestart, _, _ := container.RestartManager().ShouldRestart(uint32(container.ExitCode()), container.HasBeenManuallyStopped, container.FinishedAt.Sub(container.StartedAt))
- return shouldRestart
- }
- // AddMountPointWithVolume adds a new mount point configured with a volume to the container.
- func (container *Container) AddMountPointWithVolume(destination string, vol volume.Volume, rw bool) {
- operatingSystem := container.Platform
- if operatingSystem == "" {
- operatingSystem = runtime.GOOS
- }
- volumeParser := volume.NewParser(operatingSystem)
- container.MountPoints[destination] = &volume.MountPoint{
- Type: mounttypes.TypeVolume,
- Name: vol.Name(),
- Driver: vol.DriverName(),
- Destination: destination,
- RW: rw,
- Volume: vol,
- CopyData: volumeParser.DefaultCopyMode(),
- }
- }
- // UnmountVolumes unmounts all volumes
- func (container *Container) UnmountVolumes(volumeEventLog func(name, action string, attributes map[string]string)) error {
- var errors []string
- for _, volumeMount := range container.MountPoints {
- if volumeMount.Volume == nil {
- continue
- }
- if err := volumeMount.Cleanup(); err != nil {
- errors = append(errors, err.Error())
- continue
- }
- attributes := map[string]string{
- "driver": volumeMount.Volume.DriverName(),
- "container": container.ID,
- }
- volumeEventLog(volumeMount.Volume.Name(), "unmount", attributes)
- }
- if len(errors) > 0 {
- return fmt.Errorf("error while unmounting volumes for container %s: %s", container.ID, strings.Join(errors, "; "))
- }
- return nil
- }
- // IsDestinationMounted checks whether a path is mounted on the container or not.
- func (container *Container) IsDestinationMounted(destination string) bool {
- return container.MountPoints[destination] != nil
- }
- // StopSignal returns the signal used to stop the container.
- func (container *Container) StopSignal() int {
- var stopSignal syscall.Signal
- if container.Config.StopSignal != "" {
- stopSignal, _ = signal.ParseSignal(container.Config.StopSignal)
- }
- if int(stopSignal) == 0 {
- stopSignal, _ = signal.ParseSignal(signal.DefaultStopSignal)
- }
- return int(stopSignal)
- }
- // StopTimeout returns the timeout (in seconds) used to stop the container.
- func (container *Container) StopTimeout() int {
- if container.Config.StopTimeout != nil {
- return *container.Config.StopTimeout
- }
- return DefaultStopTimeout
- }
- // InitDNSHostConfig ensures that the dns fields are never nil.
- // New containers don't ever have those fields nil,
- // but pre created containers can still have those nil values.
- // The non-recommended host configuration in the start api can
- // make these fields nil again, this corrects that issue until
- // we remove that behavior for good.
- // See https://github.com/docker/docker/pull/17779
- // for a more detailed explanation on why we don't want that.
- func (container *Container) InitDNSHostConfig() {
- container.Lock()
- defer container.Unlock()
- if container.HostConfig.DNS == nil {
- container.HostConfig.DNS = make([]string, 0)
- }
- if container.HostConfig.DNSSearch == nil {
- container.HostConfig.DNSSearch = make([]string, 0)
- }
- if container.HostConfig.DNSOptions == nil {
- container.HostConfig.DNSOptions = make([]string, 0)
- }
- }
- // GetEndpointInNetwork returns the container's endpoint to the provided network.
- func (container *Container) GetEndpointInNetwork(n libnetwork.Network) (libnetwork.Endpoint, error) {
- endpointName := strings.TrimPrefix(container.Name, "/")
- return n.EndpointByName(endpointName)
- }
- func (container *Container) buildPortMapInfo(ep libnetwork.Endpoint) error {
- if ep == nil {
- return errInvalidEndpoint
- }
- networkSettings := container.NetworkSettings
- if networkSettings == nil {
- return errInvalidNetwork
- }
- if len(networkSettings.Ports) == 0 {
- pm, err := getEndpointPortMapInfo(ep)
- if err != nil {
- return err
- }
- networkSettings.Ports = pm
- }
- return nil
- }
- func getEndpointPortMapInfo(ep libnetwork.Endpoint) (nat.PortMap, error) {
- pm := nat.PortMap{}
- driverInfo, err := ep.DriverInfo()
- if err != nil {
- return pm, err
- }
- if driverInfo == nil {
- // It is not an error for epInfo to be nil
- return pm, nil
- }
- if expData, ok := driverInfo[netlabel.ExposedPorts]; ok {
- if exposedPorts, ok := expData.([]types.TransportPort); ok {
- for _, tp := range exposedPorts {
- natPort, err := nat.NewPort(tp.Proto.String(), strconv.Itoa(int(tp.Port)))
- if err != nil {
- return pm, fmt.Errorf("Error parsing Port value(%v):%v", tp.Port, err)
- }
- pm[natPort] = nil
- }
- }
- }
- mapData, ok := driverInfo[netlabel.PortMap]
- if !ok {
- return pm, nil
- }
- if portMapping, ok := mapData.([]types.PortBinding); ok {
- for _, pp := range portMapping {
- natPort, err := nat.NewPort(pp.Proto.String(), strconv.Itoa(int(pp.Port)))
- if err != nil {
- return pm, err
- }
- natBndg := nat.PortBinding{HostIP: pp.HostIP.String(), HostPort: strconv.Itoa(int(pp.HostPort))}
- pm[natPort] = append(pm[natPort], natBndg)
- }
- }
- return pm, nil
- }
- // GetSandboxPortMapInfo retrieves the current port-mapping programmed for the given sandbox
- func GetSandboxPortMapInfo(sb libnetwork.Sandbox) nat.PortMap {
- pm := nat.PortMap{}
- if sb == nil {
- return pm
- }
- for _, ep := range sb.Endpoints() {
- pm, _ = getEndpointPortMapInfo(ep)
- if len(pm) > 0 {
- break
- }
- }
- return pm
- }
- // BuildEndpointInfo sets endpoint-related fields on container.NetworkSettings based on the provided network and endpoint.
- func (container *Container) BuildEndpointInfo(n libnetwork.Network, ep libnetwork.Endpoint) error {
- if ep == nil {
- return errInvalidEndpoint
- }
- networkSettings := container.NetworkSettings
- if networkSettings == nil {
- return errInvalidNetwork
- }
- epInfo := ep.Info()
- if epInfo == nil {
- // It is not an error to get an empty endpoint info
- return nil
- }
- if _, ok := networkSettings.Networks[n.Name()]; !ok {
- networkSettings.Networks[n.Name()] = &network.EndpointSettings{
- EndpointSettings: &networktypes.EndpointSettings{},
- }
- }
- networkSettings.Networks[n.Name()].NetworkID = n.ID()
- networkSettings.Networks[n.Name()].EndpointID = ep.ID()
- iface := epInfo.Iface()
- if iface == nil {
- return nil
- }
- if iface.MacAddress() != nil {
- networkSettings.Networks[n.Name()].MacAddress = iface.MacAddress().String()
- }
- if iface.Address() != nil {
- ones, _ := iface.Address().Mask.Size()
- networkSettings.Networks[n.Name()].IPAddress = iface.Address().IP.String()
- networkSettings.Networks[n.Name()].IPPrefixLen = ones
- }
- if iface.AddressIPv6() != nil && iface.AddressIPv6().IP.To16() != nil {
- onesv6, _ := iface.AddressIPv6().Mask.Size()
- networkSettings.Networks[n.Name()].GlobalIPv6Address = iface.AddressIPv6().IP.String()
- networkSettings.Networks[n.Name()].GlobalIPv6PrefixLen = onesv6
- }
- return nil
- }
- type named interface {
- Name() string
- }
- // UpdateJoinInfo updates network settings when container joins network n with endpoint ep.
- func (container *Container) UpdateJoinInfo(n named, ep libnetwork.Endpoint) error {
- if err := container.buildPortMapInfo(ep); err != nil {
- return err
- }
- epInfo := ep.Info()
- if epInfo == nil {
- // It is not an error to get an empty endpoint info
- return nil
- }
- if epInfo.Gateway() != nil {
- container.NetworkSettings.Networks[n.Name()].Gateway = epInfo.Gateway().String()
- }
- if epInfo.GatewayIPv6().To16() != nil {
- container.NetworkSettings.Networks[n.Name()].IPv6Gateway = epInfo.GatewayIPv6().String()
- }
- return nil
- }
- // UpdateSandboxNetworkSettings updates the sandbox ID and Key.
- func (container *Container) UpdateSandboxNetworkSettings(sb libnetwork.Sandbox) error {
- container.NetworkSettings.SandboxID = sb.ID()
- container.NetworkSettings.SandboxKey = sb.Key()
- return nil
- }
- // BuildJoinOptions builds endpoint Join options from a given network.
- func (container *Container) BuildJoinOptions(n named) ([]libnetwork.EndpointOption, error) {
- var joinOptions []libnetwork.EndpointOption
- if epConfig, ok := container.NetworkSettings.Networks[n.Name()]; ok {
- for _, str := range epConfig.Links {
- name, alias, err := opts.ParseLink(str)
- if err != nil {
- return nil, err
- }
- joinOptions = append(joinOptions, libnetwork.CreateOptionAlias(name, alias))
- }
- for k, v := range epConfig.DriverOpts {
- joinOptions = append(joinOptions, libnetwork.EndpointOptionGeneric(options.Generic{k: v}))
- }
- }
- return joinOptions, nil
- }
- // BuildCreateEndpointOptions builds endpoint options from a given network.
- func (container *Container) BuildCreateEndpointOptions(n libnetwork.Network, epConfig *networktypes.EndpointSettings, sb libnetwork.Sandbox, daemonDNS []string) ([]libnetwork.EndpointOption, error) {
- var (
- bindings = make(nat.PortMap)
- pbList []types.PortBinding
- exposeList []types.TransportPort
- createOptions []libnetwork.EndpointOption
- )
- defaultNetName := runconfig.DefaultDaemonNetworkMode().NetworkName()
- if (!container.EnableServiceDiscoveryOnDefaultNetwork() && n.Name() == defaultNetName) ||
- container.NetworkSettings.IsAnonymousEndpoint {
- createOptions = append(createOptions, libnetwork.CreateOptionAnonymous())
- }
- if epConfig != nil {
- ipam := epConfig.IPAMConfig
- if ipam != nil {
- var (
- ipList []net.IP
- ip, ip6, linkip net.IP
- )
- for _, ips := range ipam.LinkLocalIPs {
- if linkip = net.ParseIP(ips); linkip == nil && ips != "" {
- return nil, errors.Errorf("Invalid link-local IP address: %s", ipam.LinkLocalIPs)
- }
- ipList = append(ipList, linkip)
- }
- if ip = net.ParseIP(ipam.IPv4Address); ip == nil && ipam.IPv4Address != "" {
- return nil, errors.Errorf("Invalid IPv4 address: %s)", ipam.IPv4Address)
- }
- if ip6 = net.ParseIP(ipam.IPv6Address); ip6 == nil && ipam.IPv6Address != "" {
- return nil, errors.Errorf("Invalid IPv6 address: %s)", ipam.IPv6Address)
- }
- createOptions = append(createOptions,
- libnetwork.CreateOptionIpam(ip, ip6, ipList, nil))
- }
- for _, alias := range epConfig.Aliases {
- createOptions = append(createOptions, libnetwork.CreateOptionMyAlias(alias))
- }
- for k, v := range epConfig.DriverOpts {
- createOptions = append(createOptions, libnetwork.EndpointOptionGeneric(options.Generic{k: v}))
- }
- }
- if container.NetworkSettings.Service != nil {
- svcCfg := container.NetworkSettings.Service
- var vip string
- if svcCfg.VirtualAddresses[n.ID()] != nil {
- vip = svcCfg.VirtualAddresses[n.ID()].IPv4
- }
- var portConfigs []*libnetwork.PortConfig
- for _, portConfig := range svcCfg.ExposedPorts {
- portConfigs = append(portConfigs, &libnetwork.PortConfig{
- Name: portConfig.Name,
- Protocol: libnetwork.PortConfig_Protocol(portConfig.Protocol),
- TargetPort: portConfig.TargetPort,
- PublishedPort: portConfig.PublishedPort,
- })
- }
- createOptions = append(createOptions, libnetwork.CreateOptionService(svcCfg.Name, svcCfg.ID, net.ParseIP(vip), portConfigs, svcCfg.Aliases[n.ID()]))
- }
- if !containertypes.NetworkMode(n.Name()).IsUserDefined() {
- createOptions = append(createOptions, libnetwork.CreateOptionDisableResolution())
- }
- // configs that are applicable only for the endpoint in the network
- // to which container was connected to on docker run.
- // Ideally all these network-specific endpoint configurations must be moved under
- // container.NetworkSettings.Networks[n.Name()]
- if n.Name() == container.HostConfig.NetworkMode.NetworkName() ||
- (n.Name() == defaultNetName && container.HostConfig.NetworkMode.IsDefault()) {
- if container.Config.MacAddress != "" {
- mac, err := net.ParseMAC(container.Config.MacAddress)
- if err != nil {
- return nil, err
- }
- genericOption := options.Generic{
- netlabel.MacAddress: mac,
- }
- createOptions = append(createOptions, libnetwork.EndpointOptionGeneric(genericOption))
- }
- }
- // Port-mapping rules belong to the container & applicable only to non-internal networks
- portmaps := GetSandboxPortMapInfo(sb)
- if n.Info().Internal() || len(portmaps) > 0 {
- return createOptions, nil
- }
- if container.HostConfig.PortBindings != nil {
- for p, b := range container.HostConfig.PortBindings {
- bindings[p] = []nat.PortBinding{}
- for _, bb := range b {
- bindings[p] = append(bindings[p], nat.PortBinding{
- HostIP: bb.HostIP,
- HostPort: bb.HostPort,
- })
- }
- }
- }
- portSpecs := container.Config.ExposedPorts
- ports := make([]nat.Port, len(portSpecs))
- var i int
- for p := range portSpecs {
- ports[i] = p
- i++
- }
- nat.SortPortMap(ports, bindings)
- for _, port := range ports {
- expose := types.TransportPort{}
- expose.Proto = types.ParseProtocol(port.Proto())
- expose.Port = uint16(port.Int())
- exposeList = append(exposeList, expose)
- pb := types.PortBinding{Port: expose.Port, Proto: expose.Proto}
- binding := bindings[port]
- for i := 0; i < len(binding); i++ {
- pbCopy := pb.GetCopy()
- newP, err := nat.NewPort(nat.SplitProtoPort(binding[i].HostPort))
- var portStart, portEnd int
- if err == nil {
- portStart, portEnd, err = newP.Range()
- }
- if err != nil {
- return nil, errors.Wrapf(err, "Error parsing HostPort value (%s)", binding[i].HostPort)
- }
- pbCopy.HostPort = uint16(portStart)
- pbCopy.HostPortEnd = uint16(portEnd)
- pbCopy.HostIP = net.ParseIP(binding[i].HostIP)
- pbList = append(pbList, pbCopy)
- }
- if container.HostConfig.PublishAllPorts && len(binding) == 0 {
- pbList = append(pbList, pb)
- }
- }
- var dns []string
- if len(container.HostConfig.DNS) > 0 {
- dns = container.HostConfig.DNS
- } else if len(daemonDNS) > 0 {
- dns = daemonDNS
- }
- if len(dns) > 0 {
- createOptions = append(createOptions,
- libnetwork.CreateOptionDNS(dns))
- }
- createOptions = append(createOptions,
- libnetwork.CreateOptionPortMapping(pbList),
- libnetwork.CreateOptionExposedPorts(exposeList))
- return createOptions, nil
- }
- // UpdateMonitor updates monitor configure for running container
- func (container *Container) UpdateMonitor(restartPolicy containertypes.RestartPolicy) {
- type policySetter interface {
- SetPolicy(containertypes.RestartPolicy)
- }
- if rm, ok := container.RestartManager().(policySetter); ok {
- rm.SetPolicy(restartPolicy)
- }
- }
- // FullHostname returns hostname and optional domain appended to it.
- func (container *Container) FullHostname() string {
- fullHostname := container.Config.Hostname
- if container.Config.Domainname != "" {
- fullHostname = fmt.Sprintf("%s.%s", fullHostname, container.Config.Domainname)
- }
- return fullHostname
- }
- // RestartManager returns the current restartmanager instance connected to container.
- func (container *Container) RestartManager() restartmanager.RestartManager {
- if container.restartManager == nil {
- container.restartManager = restartmanager.New(container.HostConfig.RestartPolicy, container.RestartCount)
- }
- return container.restartManager
- }
- // ResetRestartManager initializes new restartmanager based on container config
- func (container *Container) ResetRestartManager(resetCount bool) {
- if container.restartManager != nil {
- container.restartManager.Cancel()
- }
- if resetCount {
- container.RestartCount = 0
- }
- container.restartManager = nil
- }
- type attachContext struct {
- ctx context.Context
- cancel context.CancelFunc
- mu sync.Mutex
- }
- // InitAttachContext initializes or returns existing context for attach calls to
- // track container liveness.
- func (container *Container) InitAttachContext() context.Context {
- container.attachContext.mu.Lock()
- defer container.attachContext.mu.Unlock()
- if container.attachContext.ctx == nil {
- container.attachContext.ctx, container.attachContext.cancel = context.WithCancel(context.Background())
- }
- return container.attachContext.ctx
- }
- // CancelAttachContext cancels attach context. All attach calls should detach
- // after this call.
- func (container *Container) CancelAttachContext() {
- container.attachContext.mu.Lock()
- if container.attachContext.ctx != nil {
- container.attachContext.cancel()
- container.attachContext.ctx = nil
- }
- container.attachContext.mu.Unlock()
- }
- func (container *Container) startLogging() error {
- if container.HostConfig.LogConfig.Type == "none" {
- return nil // do not start logging routines
- }
- l, err := container.StartLogger()
- if err != nil {
- return fmt.Errorf("failed to initialize logging driver: %v", err)
- }
- copier := logger.NewCopier(map[string]io.Reader{"stdout": container.StdoutPipe(), "stderr": container.StderrPipe()}, l)
- container.LogCopier = copier
- copier.Run()
- container.LogDriver = l
- // set LogPath field only for json-file logdriver
- if jl, ok := l.(*jsonfilelog.JSONFileLogger); ok {
- container.LogPath = jl.LogPath()
- }
- return nil
- }
- // StdinPipe gets the stdin stream of the container
- func (container *Container) StdinPipe() io.WriteCloser {
- return container.StreamConfig.StdinPipe()
- }
- // StdoutPipe gets the stdout stream of the container
- func (container *Container) StdoutPipe() io.ReadCloser {
- return container.StreamConfig.StdoutPipe()
- }
- // StderrPipe gets the stderr stream of the container
- func (container *Container) StderrPipe() io.ReadCloser {
- return container.StreamConfig.StderrPipe()
- }
- // CloseStreams closes the container's stdio streams
- func (container *Container) CloseStreams() error {
- return container.StreamConfig.CloseStreams()
- }
- // InitializeStdio is called by libcontainerd to connect the stdio.
- func (container *Container) InitializeStdio(iop libcontainerd.IOPipe) error {
- if err := container.startLogging(); err != nil {
- container.Reset(false)
- return err
- }
- container.StreamConfig.CopyToPipe(iop)
- if container.StreamConfig.Stdin() == nil && !container.Config.Tty {
- if iop.Stdin != nil {
- if err := iop.Stdin.Close(); err != nil {
- logrus.Warnf("error closing stdin: %+v", err)
- }
- }
- }
- return nil
- }
- // SecretMountPath returns the path of the secret mount for the container
- func (container *Container) SecretMountPath() string {
- return filepath.Join(container.Root, "secrets")
- }
- // SecretFilePath returns the path to the location of a secret on the host.
- func (container *Container) SecretFilePath(secretRef swarmtypes.SecretReference) string {
- return filepath.Join(container.SecretMountPath(), secretRef.SecretID)
- }
- func getSecretTargetPath(r *swarmtypes.SecretReference) string {
- if filepath.IsAbs(r.File.Name) {
- return r.File.Name
- }
- return filepath.Join(containerSecretMountPath, r.File.Name)
- }
- // ConfigsDirPath returns the path to the directory where configs are stored on
- // disk.
- func (container *Container) ConfigsDirPath() string {
- return filepath.Join(container.Root, "configs")
- }
- // ConfigFilePath returns the path to the on-disk location of a config.
- func (container *Container) ConfigFilePath(configRef swarmtypes.ConfigReference) string {
- return filepath.Join(container.ConfigsDirPath(), configRef.ConfigID)
- }
- // CreateDaemonEnvironment creates a new environment variable slice for this container.
- func (container *Container) CreateDaemonEnvironment(tty bool, linkedEnv []string) []string {
- // Setup environment
- // TODO @jhowardmsft LCOW Support. This will need revisiting later.
- platform := container.Platform
- if platform == "" {
- platform = runtime.GOOS
- }
- env := []string{}
- if runtime.GOOS != "windows" || (system.LCOWSupported() && platform == "linux") {
- env = []string{
- "PATH=" + system.DefaultPathEnv(platform),
- "HOSTNAME=" + container.Config.Hostname,
- }
- if tty {
- env = append(env, "TERM=xterm")
- }
- env = append(env, linkedEnv...)
- }
- // because the env on the container can override certain default values
- // we need to replace the 'env' keys where they match and append anything
- // else.
- env = ReplaceOrAppendEnvValues(env, container.Config.Env)
- return env
- }
|