github.com/lazyboychen7/engine@v17.12.1-ce-rc2+incompatible/container/container_unix.go (about)

     1  // +build linux freebsd
     2  
     3  package container
     4  
     5  import (
     6  	"io/ioutil"
     7  	"os"
     8  
     9  	"github.com/docker/docker/api/types"
    10  	containertypes "github.com/docker/docker/api/types/container"
    11  	mounttypes "github.com/docker/docker/api/types/mount"
    12  	"github.com/docker/docker/pkg/chrootarchive"
    13  	"github.com/docker/docker/pkg/mount"
    14  	"github.com/docker/docker/pkg/stringid"
    15  	"github.com/docker/docker/pkg/system"
    16  	"github.com/docker/docker/volume"
    17  	"github.com/opencontainers/selinux/go-selinux/label"
    18  	"github.com/pkg/errors"
    19  	"github.com/sirupsen/logrus"
    20  	"golang.org/x/sys/unix"
    21  )
    22  
    23  const (
    24  	// DefaultStopTimeout is the timeout (in seconds) for the syscall signal used to stop a container.
    25  	DefaultStopTimeout = 10
    26  
    27  	containerSecretMountPath = "/run/secrets"
    28  )
    29  
    30  // TrySetNetworkMount attempts to set the network mounts given a provided destination and
    31  // the path to use for it; return true if the given destination was a network mount file
    32  func (container *Container) TrySetNetworkMount(destination string, path string) bool {
    33  	if destination == "/etc/resolv.conf" {
    34  		container.ResolvConfPath = path
    35  		return true
    36  	}
    37  	if destination == "/etc/hostname" {
    38  		container.HostnamePath = path
    39  		return true
    40  	}
    41  	if destination == "/etc/hosts" {
    42  		container.HostsPath = path
    43  		return true
    44  	}
    45  
    46  	return false
    47  }
    48  
    49  // BuildHostnameFile writes the container's hostname file.
    50  func (container *Container) BuildHostnameFile() error {
    51  	hostnamePath, err := container.GetRootResourcePath("hostname")
    52  	if err != nil {
    53  		return err
    54  	}
    55  	container.HostnamePath = hostnamePath
    56  	return ioutil.WriteFile(container.HostnamePath, []byte(container.Config.Hostname+"\n"), 0644)
    57  }
    58  
    59  // NetworkMounts returns the list of network mounts.
    60  func (container *Container) NetworkMounts() []Mount {
    61  	var mounts []Mount
    62  	shared := container.HostConfig.NetworkMode.IsContainer()
    63  	parser := volume.NewParser(container.OS)
    64  	if container.ResolvConfPath != "" {
    65  		if _, err := os.Stat(container.ResolvConfPath); err != nil {
    66  			logrus.Warnf("ResolvConfPath set to %q, but can't stat this filename (err = %v); skipping", container.ResolvConfPath, err)
    67  		} else {
    68  			writable := !container.HostConfig.ReadonlyRootfs
    69  			if m, exists := container.MountPoints["/etc/resolv.conf"]; exists {
    70  				writable = m.RW
    71  			} else {
    72  				label.Relabel(container.ResolvConfPath, container.MountLabel, shared)
    73  			}
    74  			mounts = append(mounts, Mount{
    75  				Source:      container.ResolvConfPath,
    76  				Destination: "/etc/resolv.conf",
    77  				Writable:    writable,
    78  				Propagation: string(parser.DefaultPropagationMode()),
    79  			})
    80  		}
    81  	}
    82  	if container.HostnamePath != "" {
    83  		if _, err := os.Stat(container.HostnamePath); err != nil {
    84  			logrus.Warnf("HostnamePath set to %q, but can't stat this filename (err = %v); skipping", container.HostnamePath, err)
    85  		} else {
    86  			writable := !container.HostConfig.ReadonlyRootfs
    87  			if m, exists := container.MountPoints["/etc/hostname"]; exists {
    88  				writable = m.RW
    89  			} else {
    90  				label.Relabel(container.HostnamePath, container.MountLabel, shared)
    91  			}
    92  			mounts = append(mounts, Mount{
    93  				Source:      container.HostnamePath,
    94  				Destination: "/etc/hostname",
    95  				Writable:    writable,
    96  				Propagation: string(parser.DefaultPropagationMode()),
    97  			})
    98  		}
    99  	}
   100  	if container.HostsPath != "" {
   101  		if _, err := os.Stat(container.HostsPath); err != nil {
   102  			logrus.Warnf("HostsPath set to %q, but can't stat this filename (err = %v); skipping", container.HostsPath, err)
   103  		} else {
   104  			writable := !container.HostConfig.ReadonlyRootfs
   105  			if m, exists := container.MountPoints["/etc/hosts"]; exists {
   106  				writable = m.RW
   107  			} else {
   108  				label.Relabel(container.HostsPath, container.MountLabel, shared)
   109  			}
   110  			mounts = append(mounts, Mount{
   111  				Source:      container.HostsPath,
   112  				Destination: "/etc/hosts",
   113  				Writable:    writable,
   114  				Propagation: string(parser.DefaultPropagationMode()),
   115  			})
   116  		}
   117  	}
   118  	return mounts
   119  }
   120  
   121  // CopyImagePathContent copies files in destination to the volume.
   122  func (container *Container) CopyImagePathContent(v volume.Volume, destination string) error {
   123  	rootfs, err := container.GetResourcePath(destination)
   124  	if err != nil {
   125  		return err
   126  	}
   127  
   128  	if _, err = ioutil.ReadDir(rootfs); err != nil {
   129  		if os.IsNotExist(err) {
   130  			return nil
   131  		}
   132  		return err
   133  	}
   134  
   135  	id := stringid.GenerateNonCryptoID()
   136  	path, err := v.Mount(id)
   137  	if err != nil {
   138  		return err
   139  	}
   140  
   141  	defer func() {
   142  		if err := v.Unmount(id); err != nil {
   143  			logrus.Warnf("error while unmounting volume %s: %v", v.Name(), err)
   144  		}
   145  	}()
   146  	if err := label.Relabel(path, container.MountLabel, true); err != nil && err != unix.ENOTSUP {
   147  		return err
   148  	}
   149  	return copyExistingContents(rootfs, path)
   150  }
   151  
   152  // ShmResourcePath returns path to shm
   153  func (container *Container) ShmResourcePath() (string, error) {
   154  	return container.GetRootResourcePath("shm")
   155  }
   156  
   157  // HasMountFor checks if path is a mountpoint
   158  func (container *Container) HasMountFor(path string) bool {
   159  	_, exists := container.MountPoints[path]
   160  	if exists {
   161  		return true
   162  	}
   163  
   164  	// Also search among the tmpfs mounts
   165  	for dest := range container.HostConfig.Tmpfs {
   166  		if dest == path {
   167  			return true
   168  		}
   169  	}
   170  
   171  	return false
   172  }
   173  
   174  // UnmountIpcMount uses the provided unmount function to unmount shm if it was mounted
   175  func (container *Container) UnmountIpcMount(unmount func(pth string) error) error {
   176  	if container.HasMountFor("/dev/shm") {
   177  		return nil
   178  	}
   179  
   180  	// container.ShmPath should not be used here as it may point
   181  	// to the host's or other container's /dev/shm
   182  	shmPath, err := container.ShmResourcePath()
   183  	if err != nil {
   184  		return err
   185  	}
   186  	if shmPath == "" {
   187  		return nil
   188  	}
   189  	if err = unmount(shmPath); err != nil && !os.IsNotExist(err) {
   190  		if mounted, mErr := mount.Mounted(shmPath); mounted || mErr != nil {
   191  			return errors.Wrapf(err, "umount %s", shmPath)
   192  		}
   193  	}
   194  	return nil
   195  }
   196  
   197  // IpcMounts returns the list of IPC mounts
   198  func (container *Container) IpcMounts() []Mount {
   199  	var mounts []Mount
   200  	parser := volume.NewParser(container.OS)
   201  
   202  	if container.HasMountFor("/dev/shm") {
   203  		return mounts
   204  	}
   205  	if container.ShmPath == "" {
   206  		return mounts
   207  	}
   208  
   209  	label.SetFileLabel(container.ShmPath, container.MountLabel)
   210  	mounts = append(mounts, Mount{
   211  		Source:      container.ShmPath,
   212  		Destination: "/dev/shm",
   213  		Writable:    true,
   214  		Propagation: string(parser.DefaultPropagationMode()),
   215  	})
   216  
   217  	return mounts
   218  }
   219  
   220  // SecretMounts returns the mounts for the secret path.
   221  func (container *Container) SecretMounts() []Mount {
   222  	var mounts []Mount
   223  	for _, r := range container.SecretReferences {
   224  		if r.File == nil {
   225  			continue
   226  		}
   227  		mounts = append(mounts, Mount{
   228  			Source:      container.SecretFilePath(*r),
   229  			Destination: getSecretTargetPath(r),
   230  			Writable:    false,
   231  		})
   232  	}
   233  
   234  	return mounts
   235  }
   236  
   237  // UnmountSecrets unmounts the local tmpfs for secrets
   238  func (container *Container) UnmountSecrets() error {
   239  	if _, err := os.Stat(container.SecretMountPath()); err != nil {
   240  		if os.IsNotExist(err) {
   241  			return nil
   242  		}
   243  		return err
   244  	}
   245  
   246  	return detachMounted(container.SecretMountPath())
   247  }
   248  
   249  // ConfigMounts returns the mounts for configs.
   250  func (container *Container) ConfigMounts() []Mount {
   251  	var mounts []Mount
   252  	for _, configRef := range container.ConfigReferences {
   253  		if configRef.File == nil {
   254  			continue
   255  		}
   256  		mounts = append(mounts, Mount{
   257  			Source:      container.ConfigFilePath(*configRef),
   258  			Destination: configRef.File.Name,
   259  			Writable:    false,
   260  		})
   261  	}
   262  
   263  	return mounts
   264  }
   265  
   266  type conflictingUpdateOptions string
   267  
   268  func (e conflictingUpdateOptions) Error() string {
   269  	return string(e)
   270  }
   271  
   272  func (e conflictingUpdateOptions) Conflict() {}
   273  
   274  // UpdateContainer updates configuration of a container. Callers must hold a Lock on the Container.
   275  func (container *Container) UpdateContainer(hostConfig *containertypes.HostConfig) error {
   276  	// update resources of container
   277  	resources := hostConfig.Resources
   278  	cResources := &container.HostConfig.Resources
   279  
   280  	// validate NanoCPUs, CPUPeriod, and CPUQuota
   281  	// Because NanoCPU effectively updates CPUPeriod/CPUQuota,
   282  	// once NanoCPU is already set, updating CPUPeriod/CPUQuota will be blocked, and vice versa.
   283  	// In the following we make sure the intended update (resources) does not conflict with the existing (cResource).
   284  	if resources.NanoCPUs > 0 && cResources.CPUPeriod > 0 {
   285  		return conflictingUpdateOptions("Conflicting options: Nano CPUs cannot be updated as CPU Period has already been set")
   286  	}
   287  	if resources.NanoCPUs > 0 && cResources.CPUQuota > 0 {
   288  		return conflictingUpdateOptions("Conflicting options: Nano CPUs cannot be updated as CPU Quota has already been set")
   289  	}
   290  	if resources.CPUPeriod > 0 && cResources.NanoCPUs > 0 {
   291  		return conflictingUpdateOptions("Conflicting options: CPU Period cannot be updated as NanoCPUs has already been set")
   292  	}
   293  	if resources.CPUQuota > 0 && cResources.NanoCPUs > 0 {
   294  		return conflictingUpdateOptions("Conflicting options: CPU Quota cannot be updated as NanoCPUs has already been set")
   295  	}
   296  
   297  	if resources.BlkioWeight != 0 {
   298  		cResources.BlkioWeight = resources.BlkioWeight
   299  	}
   300  	if resources.CPUShares != 0 {
   301  		cResources.CPUShares = resources.CPUShares
   302  	}
   303  	if resources.NanoCPUs != 0 {
   304  		cResources.NanoCPUs = resources.NanoCPUs
   305  	}
   306  	if resources.CPUPeriod != 0 {
   307  		cResources.CPUPeriod = resources.CPUPeriod
   308  	}
   309  	if resources.CPUQuota != 0 {
   310  		cResources.CPUQuota = resources.CPUQuota
   311  	}
   312  	if resources.CpusetCpus != "" {
   313  		cResources.CpusetCpus = resources.CpusetCpus
   314  	}
   315  	if resources.CpusetMems != "" {
   316  		cResources.CpusetMems = resources.CpusetMems
   317  	}
   318  	if resources.Memory != 0 {
   319  		// if memory limit smaller than already set memoryswap limit and doesn't
   320  		// update the memoryswap limit, then error out.
   321  		if resources.Memory > cResources.MemorySwap && resources.MemorySwap == 0 {
   322  			return conflictingUpdateOptions("Memory limit should be smaller than already set memoryswap limit, update the memoryswap at the same time")
   323  		}
   324  		cResources.Memory = resources.Memory
   325  	}
   326  	if resources.MemorySwap != 0 {
   327  		cResources.MemorySwap = resources.MemorySwap
   328  	}
   329  	if resources.MemoryReservation != 0 {
   330  		cResources.MemoryReservation = resources.MemoryReservation
   331  	}
   332  	if resources.KernelMemory != 0 {
   333  		cResources.KernelMemory = resources.KernelMemory
   334  	}
   335  	if resources.CPURealtimePeriod != 0 {
   336  		cResources.CPURealtimePeriod = resources.CPURealtimePeriod
   337  	}
   338  	if resources.CPURealtimeRuntime != 0 {
   339  		cResources.CPURealtimeRuntime = resources.CPURealtimeRuntime
   340  	}
   341  
   342  	// update HostConfig of container
   343  	if hostConfig.RestartPolicy.Name != "" {
   344  		if container.HostConfig.AutoRemove && !hostConfig.RestartPolicy.IsNone() {
   345  			return conflictingUpdateOptions("Restart policy cannot be updated because AutoRemove is enabled for the container")
   346  		}
   347  		container.HostConfig.RestartPolicy = hostConfig.RestartPolicy
   348  	}
   349  
   350  	return nil
   351  }
   352  
   353  // DetachAndUnmount uses a detached mount on all mount destinations, then
   354  // unmounts each volume normally.
   355  // This is used from daemon/archive for `docker cp`
   356  func (container *Container) DetachAndUnmount(volumeEventLog func(name, action string, attributes map[string]string)) error {
   357  	networkMounts := container.NetworkMounts()
   358  	mountPaths := make([]string, 0, len(container.MountPoints)+len(networkMounts))
   359  
   360  	for _, mntPoint := range container.MountPoints {
   361  		dest, err := container.GetResourcePath(mntPoint.Destination)
   362  		if err != nil {
   363  			logrus.Warnf("Failed to get volume destination path for container '%s' at '%s' while lazily unmounting: %v", container.ID, mntPoint.Destination, err)
   364  			continue
   365  		}
   366  		mountPaths = append(mountPaths, dest)
   367  	}
   368  
   369  	for _, m := range networkMounts {
   370  		dest, err := container.GetResourcePath(m.Destination)
   371  		if err != nil {
   372  			logrus.Warnf("Failed to get volume destination path for container '%s' at '%s' while lazily unmounting: %v", container.ID, m.Destination, err)
   373  			continue
   374  		}
   375  		mountPaths = append(mountPaths, dest)
   376  	}
   377  
   378  	for _, mountPath := range mountPaths {
   379  		if err := detachMounted(mountPath); err != nil {
   380  			logrus.Warnf("%s unmountVolumes: Failed to do lazy umount fo volume '%s': %v", container.ID, mountPath, err)
   381  		}
   382  	}
   383  	return container.UnmountVolumes(volumeEventLog)
   384  }
   385  
   386  // copyExistingContents copies from the source to the destination and
   387  // ensures the ownership is appropriately set.
   388  func copyExistingContents(source, destination string) error {
   389  	volList, err := ioutil.ReadDir(source)
   390  	if err != nil {
   391  		return err
   392  	}
   393  	if len(volList) > 0 {
   394  		srcList, err := ioutil.ReadDir(destination)
   395  		if err != nil {
   396  			return err
   397  		}
   398  		if len(srcList) == 0 {
   399  			// If the source volume is empty, copies files from the root into the volume
   400  			if err := chrootarchive.NewArchiver(nil).CopyWithTar(source, destination); err != nil {
   401  				return err
   402  			}
   403  		}
   404  	}
   405  	return copyOwnership(source, destination)
   406  }
   407  
   408  // copyOwnership copies the permissions and uid:gid of the source file
   409  // to the destination file
   410  func copyOwnership(source, destination string) error {
   411  	stat, err := system.Stat(source)
   412  	if err != nil {
   413  		return err
   414  	}
   415  
   416  	destStat, err := system.Stat(destination)
   417  	if err != nil {
   418  		return err
   419  	}
   420  
   421  	// In some cases, even though UID/GID match and it would effectively be a no-op,
   422  	// this can return a permission denied error... for example if this is an NFS
   423  	// mount.
   424  	// Since it's not really an error that we can't chown to the same UID/GID, don't
   425  	// even bother trying in such cases.
   426  	if stat.UID() != destStat.UID() || stat.GID() != destStat.GID() {
   427  		if err := os.Chown(destination, int(stat.UID()), int(stat.GID())); err != nil {
   428  			return err
   429  		}
   430  	}
   431  
   432  	if stat.Mode() != destStat.Mode() {
   433  		return os.Chmod(destination, os.FileMode(stat.Mode()))
   434  	}
   435  	return nil
   436  }
   437  
   438  // TmpfsMounts returns the list of tmpfs mounts
   439  func (container *Container) TmpfsMounts() ([]Mount, error) {
   440  	parser := volume.NewParser(container.OS)
   441  	var mounts []Mount
   442  	for dest, data := range container.HostConfig.Tmpfs {
   443  		mounts = append(mounts, Mount{
   444  			Source:      "tmpfs",
   445  			Destination: dest,
   446  			Data:        data,
   447  		})
   448  	}
   449  	for dest, mnt := range container.MountPoints {
   450  		if mnt.Type == mounttypes.TypeTmpfs {
   451  			data, err := parser.ConvertTmpfsOptions(mnt.Spec.TmpfsOptions, mnt.Spec.ReadOnly)
   452  			if err != nil {
   453  				return nil, err
   454  			}
   455  			mounts = append(mounts, Mount{
   456  				Source:      "tmpfs",
   457  				Destination: dest,
   458  				Data:        data,
   459  			})
   460  		}
   461  	}
   462  	return mounts, nil
   463  }
   464  
   465  // EnableServiceDiscoveryOnDefaultNetwork Enable service discovery on default network
   466  func (container *Container) EnableServiceDiscoveryOnDefaultNetwork() bool {
   467  	return false
   468  }
   469  
   470  // GetMountPoints gives a platform specific transformation to types.MountPoint. Callers must hold a Container lock.
   471  func (container *Container) GetMountPoints() []types.MountPoint {
   472  	mountPoints := make([]types.MountPoint, 0, len(container.MountPoints))
   473  	for _, m := range container.MountPoints {
   474  		mountPoints = append(mountPoints, types.MountPoint{
   475  			Type:        m.Type,
   476  			Name:        m.Name,
   477  			Source:      m.Path(),
   478  			Destination: m.Destination,
   479  			Driver:      m.Driver,
   480  			Mode:        m.Mode,
   481  			RW:          m.RW,
   482  			Propagation: m.Propagation,
   483  		})
   484  	}
   485  	return mountPoints
   486  }