daemon_unix.go 54 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511
  1. // +build linux freebsd
  2. package daemon // import "github.com/docker/docker/daemon"
  3. import (
  4. "bufio"
  5. "context"
  6. "fmt"
  7. "io/ioutil"
  8. "net"
  9. "os"
  10. "path/filepath"
  11. "runtime"
  12. "runtime/debug"
  13. "strconv"
  14. "strings"
  15. "time"
  16. containerd_cgroups "github.com/containerd/cgroups"
  17. "github.com/docker/docker/api/types"
  18. "github.com/docker/docker/api/types/blkiodev"
  19. pblkiodev "github.com/docker/docker/api/types/blkiodev"
  20. containertypes "github.com/docker/docker/api/types/container"
  21. "github.com/docker/docker/container"
  22. "github.com/docker/docker/daemon/config"
  23. "github.com/docker/docker/daemon/initlayer"
  24. "github.com/docker/docker/opts"
  25. "github.com/docker/docker/pkg/containerfs"
  26. "github.com/docker/docker/pkg/idtools"
  27. "github.com/docker/docker/pkg/ioutils"
  28. "github.com/docker/docker/pkg/mount"
  29. "github.com/docker/docker/pkg/parsers"
  30. "github.com/docker/docker/pkg/parsers/kernel"
  31. "github.com/docker/docker/pkg/sysinfo"
  32. "github.com/docker/docker/runconfig"
  33. volumemounts "github.com/docker/docker/volume/mounts"
  34. "github.com/docker/libnetwork"
  35. nwconfig "github.com/docker/libnetwork/config"
  36. "github.com/docker/libnetwork/drivers/bridge"
  37. "github.com/docker/libnetwork/netlabel"
  38. "github.com/docker/libnetwork/netutils"
  39. "github.com/docker/libnetwork/options"
  40. lntypes "github.com/docker/libnetwork/types"
  41. "github.com/opencontainers/runc/libcontainer/cgroups"
  42. rsystem "github.com/opencontainers/runc/libcontainer/system"
  43. "github.com/opencontainers/runtime-spec/specs-go"
  44. "github.com/opencontainers/selinux/go-selinux/label"
  45. "github.com/pkg/errors"
  46. "github.com/sirupsen/logrus"
  47. "github.com/vishvananda/netlink"
  48. "golang.org/x/sys/unix"
  49. )
  50. const (
  51. // DefaultShimBinary is the default shim to be used by containerd if none
  52. // is specified
  53. DefaultShimBinary = "containerd-shim"
  54. // DefaultRuntimeBinary is the default runtime to be used by
  55. // containerd if none is specified
  56. DefaultRuntimeBinary = "runc"
  57. // See https://git.kernel.org/cgit/linux/kernel/git/tip/tip.git/tree/kernel/sched/sched.h?id=8cd9234c64c584432f6992fe944ca9e46ca8ea76#n269
  58. linuxMinCPUShares = 2
  59. linuxMaxCPUShares = 262144
  60. platformSupported = true
  61. // It's not kernel limit, we want this 4M limit to supply a reasonable functional container
  62. linuxMinMemory = 4194304
  63. // constants for remapped root settings
  64. defaultIDSpecifier = "default"
  65. defaultRemappedID = "dockremap"
  66. // constant for cgroup drivers
  67. cgroupFsDriver = "cgroupfs"
  68. cgroupSystemdDriver = "systemd"
  69. // DefaultRuntimeName is the default runtime to be used by
  70. // containerd if none is specified
  71. DefaultRuntimeName = "runc"
  72. )
  73. type containerGetter interface {
  74. GetContainer(string) (*container.Container, error)
  75. }
  76. func getMemoryResources(config containertypes.Resources) *specs.LinuxMemory {
  77. memory := specs.LinuxMemory{}
  78. if config.Memory > 0 {
  79. memory.Limit = &config.Memory
  80. }
  81. if config.MemoryReservation > 0 {
  82. memory.Reservation = &config.MemoryReservation
  83. }
  84. if config.MemorySwap > 0 {
  85. memory.Swap = &config.MemorySwap
  86. }
  87. if config.MemorySwappiness != nil {
  88. swappiness := uint64(*config.MemorySwappiness)
  89. memory.Swappiness = &swappiness
  90. }
  91. if config.OomKillDisable != nil {
  92. memory.DisableOOMKiller = config.OomKillDisable
  93. }
  94. if config.KernelMemory != 0 {
  95. memory.Kernel = &config.KernelMemory
  96. }
  97. if config.KernelMemoryTCP != 0 {
  98. memory.KernelTCP = &config.KernelMemoryTCP
  99. }
  100. return &memory
  101. }
  102. func getCPUResources(config containertypes.Resources) (*specs.LinuxCPU, error) {
  103. cpu := specs.LinuxCPU{}
  104. if config.CPUShares < 0 {
  105. return nil, fmt.Errorf("shares: invalid argument")
  106. }
  107. if config.CPUShares >= 0 {
  108. shares := uint64(config.CPUShares)
  109. cpu.Shares = &shares
  110. }
  111. if config.CpusetCpus != "" {
  112. cpu.Cpus = config.CpusetCpus
  113. }
  114. if config.CpusetMems != "" {
  115. cpu.Mems = config.CpusetMems
  116. }
  117. if config.NanoCPUs > 0 {
  118. // https://www.kernel.org/doc/Documentation/scheduler/sched-bwc.txt
  119. period := uint64(100 * time.Millisecond / time.Microsecond)
  120. quota := config.NanoCPUs * int64(period) / 1e9
  121. cpu.Period = &period
  122. cpu.Quota = &quota
  123. }
  124. if config.CPUPeriod != 0 {
  125. period := uint64(config.CPUPeriod)
  126. cpu.Period = &period
  127. }
  128. if config.CPUQuota != 0 {
  129. q := config.CPUQuota
  130. cpu.Quota = &q
  131. }
  132. if config.CPURealtimePeriod != 0 {
  133. period := uint64(config.CPURealtimePeriod)
  134. cpu.RealtimePeriod = &period
  135. }
  136. if config.CPURealtimeRuntime != 0 {
  137. c := config.CPURealtimeRuntime
  138. cpu.RealtimeRuntime = &c
  139. }
  140. return &cpu, nil
  141. }
  142. func getBlkioWeightDevices(config containertypes.Resources) ([]specs.LinuxWeightDevice, error) {
  143. var stat unix.Stat_t
  144. var blkioWeightDevices []specs.LinuxWeightDevice
  145. for _, weightDevice := range config.BlkioWeightDevice {
  146. if err := unix.Stat(weightDevice.Path, &stat); err != nil {
  147. return nil, err
  148. }
  149. weight := weightDevice.Weight
  150. d := specs.LinuxWeightDevice{Weight: &weight}
  151. d.Major = int64(stat.Rdev / 256)
  152. d.Minor = int64(stat.Rdev % 256)
  153. blkioWeightDevices = append(blkioWeightDevices, d)
  154. }
  155. return blkioWeightDevices, nil
  156. }
  157. func (daemon *Daemon) parseSecurityOpt(container *container.Container, hostConfig *containertypes.HostConfig) error {
  158. container.NoNewPrivileges = daemon.configStore.NoNewPrivileges
  159. return parseSecurityOpt(container, hostConfig)
  160. }
  161. func parseSecurityOpt(container *container.Container, config *containertypes.HostConfig) error {
  162. var (
  163. labelOpts []string
  164. err error
  165. )
  166. for _, opt := range config.SecurityOpt {
  167. if opt == "no-new-privileges" {
  168. container.NoNewPrivileges = true
  169. continue
  170. }
  171. if opt == "disable" {
  172. labelOpts = append(labelOpts, "disable")
  173. continue
  174. }
  175. var con []string
  176. if strings.Contains(opt, "=") {
  177. con = strings.SplitN(opt, "=", 2)
  178. } else if strings.Contains(opt, ":") {
  179. con = strings.SplitN(opt, ":", 2)
  180. logrus.Warn("Security options with `:` as a separator are deprecated and will be completely unsupported in 17.04, use `=` instead.")
  181. }
  182. if len(con) != 2 {
  183. return fmt.Errorf("invalid --security-opt 1: %q", opt)
  184. }
  185. switch con[0] {
  186. case "label":
  187. labelOpts = append(labelOpts, con[1])
  188. case "apparmor":
  189. container.AppArmorProfile = con[1]
  190. case "seccomp":
  191. container.SeccompProfile = con[1]
  192. case "no-new-privileges":
  193. noNewPrivileges, err := strconv.ParseBool(con[1])
  194. if err != nil {
  195. return fmt.Errorf("invalid --security-opt 2: %q", opt)
  196. }
  197. container.NoNewPrivileges = noNewPrivileges
  198. default:
  199. return fmt.Errorf("invalid --security-opt 2: %q", opt)
  200. }
  201. }
  202. container.ProcessLabel, container.MountLabel, err = label.InitLabels(labelOpts)
  203. return err
  204. }
  205. func getBlkioThrottleDevices(devs []*blkiodev.ThrottleDevice) ([]specs.LinuxThrottleDevice, error) {
  206. var throttleDevices []specs.LinuxThrottleDevice
  207. var stat unix.Stat_t
  208. for _, d := range devs {
  209. if err := unix.Stat(d.Path, &stat); err != nil {
  210. return nil, err
  211. }
  212. d := specs.LinuxThrottleDevice{Rate: d.Rate}
  213. d.Major = int64(stat.Rdev / 256)
  214. d.Minor = int64(stat.Rdev % 256)
  215. throttleDevices = append(throttleDevices, d)
  216. }
  217. return throttleDevices, nil
  218. }
  219. func checkKernel() error {
  220. // Check for unsupported kernel versions
  221. // FIXME: it would be cleaner to not test for specific versions, but rather
  222. // test for specific functionalities.
  223. // Unfortunately we can't test for the feature "does not cause a kernel panic"
  224. // without actually causing a kernel panic, so we need this workaround until
  225. // the circumstances of pre-3.10 crashes are clearer.
  226. // For details see https://github.com/docker/docker/issues/407
  227. // Docker 1.11 and above doesn't actually run on kernels older than 3.4,
  228. // due to containerd-shim usage of PR_SET_CHILD_SUBREAPER (introduced in 3.4).
  229. if !kernel.CheckKernelVersion(3, 10, 0) {
  230. v, _ := kernel.GetKernelVersion()
  231. if os.Getenv("DOCKER_NOWARN_KERNEL_VERSION") == "" {
  232. logrus.Fatalf("Your Linux kernel version %s is not supported for running docker. Please upgrade your kernel to 3.10.0 or newer.", v.String())
  233. }
  234. }
  235. return nil
  236. }
  237. // adaptContainerSettings is called during container creation to modify any
  238. // settings necessary in the HostConfig structure.
  239. func (daemon *Daemon) adaptContainerSettings(hostConfig *containertypes.HostConfig, adjustCPUShares bool) error {
  240. if adjustCPUShares && hostConfig.CPUShares > 0 {
  241. // Handle unsupported CPUShares
  242. if hostConfig.CPUShares < linuxMinCPUShares {
  243. logrus.Warnf("Changing requested CPUShares of %d to minimum allowed of %d", hostConfig.CPUShares, linuxMinCPUShares)
  244. hostConfig.CPUShares = linuxMinCPUShares
  245. } else if hostConfig.CPUShares > linuxMaxCPUShares {
  246. logrus.Warnf("Changing requested CPUShares of %d to maximum allowed of %d", hostConfig.CPUShares, linuxMaxCPUShares)
  247. hostConfig.CPUShares = linuxMaxCPUShares
  248. }
  249. }
  250. if hostConfig.Memory > 0 && hostConfig.MemorySwap == 0 {
  251. // By default, MemorySwap is set to twice the size of Memory.
  252. hostConfig.MemorySwap = hostConfig.Memory * 2
  253. }
  254. if hostConfig.ShmSize == 0 {
  255. hostConfig.ShmSize = config.DefaultShmSize
  256. if daemon.configStore != nil {
  257. hostConfig.ShmSize = int64(daemon.configStore.ShmSize)
  258. }
  259. }
  260. // Set default IPC mode, if unset for container
  261. if hostConfig.IpcMode.IsEmpty() {
  262. m := config.DefaultIpcMode
  263. if daemon.configStore != nil {
  264. m = daemon.configStore.IpcMode
  265. }
  266. hostConfig.IpcMode = containertypes.IpcMode(m)
  267. }
  268. adaptSharedNamespaceContainer(daemon, hostConfig)
  269. var err error
  270. opts, err := daemon.generateSecurityOpt(hostConfig)
  271. if err != nil {
  272. return err
  273. }
  274. hostConfig.SecurityOpt = append(hostConfig.SecurityOpt, opts...)
  275. if hostConfig.OomKillDisable == nil {
  276. defaultOomKillDisable := false
  277. hostConfig.OomKillDisable = &defaultOomKillDisable
  278. }
  279. return nil
  280. }
  281. // adaptSharedNamespaceContainer replaces container name with its ID in hostConfig.
  282. // To be more precisely, it modifies `container:name` to `container:ID` of PidMode, IpcMode
  283. // and NetworkMode.
  284. //
  285. // When a container shares its namespace with another container, use ID can keep the namespace
  286. // sharing connection between the two containers even the another container is renamed.
  287. func adaptSharedNamespaceContainer(daemon containerGetter, hostConfig *containertypes.HostConfig) {
  288. containerPrefix := "container:"
  289. if hostConfig.PidMode.IsContainer() {
  290. pidContainer := hostConfig.PidMode.Container()
  291. // if there is any error returned here, we just ignore it and leave it to be
  292. // handled in the following logic
  293. if c, err := daemon.GetContainer(pidContainer); err == nil {
  294. hostConfig.PidMode = containertypes.PidMode(containerPrefix + c.ID)
  295. }
  296. }
  297. if hostConfig.IpcMode.IsContainer() {
  298. ipcContainer := hostConfig.IpcMode.Container()
  299. if c, err := daemon.GetContainer(ipcContainer); err == nil {
  300. hostConfig.IpcMode = containertypes.IpcMode(containerPrefix + c.ID)
  301. }
  302. }
  303. if hostConfig.NetworkMode.IsContainer() {
  304. netContainer := hostConfig.NetworkMode.ConnectedContainer()
  305. if c, err := daemon.GetContainer(netContainer); err == nil {
  306. hostConfig.NetworkMode = containertypes.NetworkMode(containerPrefix + c.ID)
  307. }
  308. }
  309. }
  310. func verifyContainerResources(resources *containertypes.Resources, sysInfo *sysinfo.SysInfo, update bool) (warnings []string, err error) {
  311. fixMemorySwappiness(resources)
  312. // memory subsystem checks and adjustments
  313. if resources.Memory != 0 && resources.Memory < linuxMinMemory {
  314. return warnings, fmt.Errorf("Minimum memory limit allowed is 4MB")
  315. }
  316. if resources.Memory > 0 && !sysInfo.MemoryLimit {
  317. warnings = append(warnings, "Your kernel does not support memory limit capabilities or the cgroup is not mounted. Limitation discarded.")
  318. resources.Memory = 0
  319. resources.MemorySwap = -1
  320. }
  321. if resources.Memory > 0 && resources.MemorySwap != -1 && !sysInfo.SwapLimit {
  322. warnings = append(warnings, "Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap.")
  323. resources.MemorySwap = -1
  324. }
  325. if resources.Memory > 0 && resources.MemorySwap > 0 && resources.MemorySwap < resources.Memory {
  326. return warnings, fmt.Errorf("Minimum memoryswap limit should be larger than memory limit, see usage")
  327. }
  328. if resources.Memory == 0 && resources.MemorySwap > 0 && !update {
  329. return warnings, fmt.Errorf("You should always set the Memory limit when using Memoryswap limit, see usage")
  330. }
  331. if resources.MemorySwappiness != nil && !sysInfo.MemorySwappiness {
  332. warnings = append(warnings, "Your kernel does not support memory swappiness capabilities or the cgroup is not mounted. Memory swappiness discarded.")
  333. resources.MemorySwappiness = nil
  334. }
  335. if resources.MemorySwappiness != nil {
  336. swappiness := *resources.MemorySwappiness
  337. if swappiness < 0 || swappiness > 100 {
  338. return warnings, fmt.Errorf("Invalid value: %v, valid memory swappiness range is 0-100", swappiness)
  339. }
  340. }
  341. if resources.MemoryReservation > 0 && !sysInfo.MemoryReservation {
  342. warnings = append(warnings, "Your kernel does not support memory soft limit capabilities or the cgroup is not mounted. Limitation discarded.")
  343. resources.MemoryReservation = 0
  344. }
  345. if resources.MemoryReservation > 0 && resources.MemoryReservation < linuxMinMemory {
  346. return warnings, fmt.Errorf("Minimum memory reservation allowed is 4MB")
  347. }
  348. if resources.Memory > 0 && resources.MemoryReservation > 0 && resources.Memory < resources.MemoryReservation {
  349. return warnings, fmt.Errorf("Minimum memory limit can not be less than memory reservation limit, see usage")
  350. }
  351. if resources.KernelMemory > 0 && !sysInfo.KernelMemory {
  352. warnings = append(warnings, "Your kernel does not support kernel memory limit capabilities or the cgroup is not mounted. Limitation discarded.")
  353. resources.KernelMemory = 0
  354. }
  355. if resources.KernelMemory > 0 && resources.KernelMemory < linuxMinMemory {
  356. return warnings, fmt.Errorf("Minimum kernel memory limit allowed is 4MB")
  357. }
  358. if resources.KernelMemory > 0 && !kernel.CheckKernelVersion(4, 0, 0) {
  359. warnings = append(warnings, "You specified a kernel memory limit on a kernel older than 4.0. Kernel memory limits are experimental on older kernels, it won't work as expected and can cause your system to be unstable.")
  360. }
  361. if resources.OomKillDisable != nil && !sysInfo.OomKillDisable {
  362. // only produce warnings if the setting wasn't to *disable* the OOM Kill; no point
  363. // warning the caller if they already wanted the feature to be off
  364. if *resources.OomKillDisable {
  365. warnings = append(warnings, "Your kernel does not support OomKillDisable. OomKillDisable discarded.")
  366. }
  367. resources.OomKillDisable = nil
  368. }
  369. if resources.OomKillDisable != nil && *resources.OomKillDisable && resources.Memory == 0 {
  370. warnings = append(warnings, "OOM killer is disabled for the container, but no memory limit is set, this can result in the system running out of resources.")
  371. }
  372. if resources.PidsLimit != 0 && !sysInfo.PidsLimit {
  373. warnings = append(warnings, "Your kernel does not support pids limit capabilities or the cgroup is not mounted. PIDs limit discarded.")
  374. resources.PidsLimit = 0
  375. }
  376. // cpu subsystem checks and adjustments
  377. if resources.NanoCPUs > 0 && resources.CPUPeriod > 0 {
  378. return warnings, fmt.Errorf("Conflicting options: Nano CPUs and CPU Period cannot both be set")
  379. }
  380. if resources.NanoCPUs > 0 && resources.CPUQuota > 0 {
  381. return warnings, fmt.Errorf("Conflicting options: Nano CPUs and CPU Quota cannot both be set")
  382. }
  383. if resources.NanoCPUs > 0 && (!sysInfo.CPUCfsPeriod || !sysInfo.CPUCfsQuota) {
  384. return warnings, fmt.Errorf("NanoCPUs can not be set, as your kernel does not support CPU cfs period/quota or the cgroup is not mounted")
  385. }
  386. // The highest precision we could get on Linux is 0.001, by setting
  387. // cpu.cfs_period_us=1000ms
  388. // cpu.cfs_quota=1ms
  389. // See the following link for details:
  390. // https://www.kernel.org/doc/Documentation/scheduler/sched-bwc.txt
  391. // Here we don't set the lower limit and it is up to the underlying platform (e.g., Linux) to return an error.
  392. // The error message is 0.01 so that this is consistent with Windows
  393. if resources.NanoCPUs < 0 || resources.NanoCPUs > int64(sysinfo.NumCPU())*1e9 {
  394. return warnings, fmt.Errorf("Range of CPUs is from 0.01 to %d.00, as there are only %d CPUs available", sysinfo.NumCPU(), sysinfo.NumCPU())
  395. }
  396. if resources.CPUShares > 0 && !sysInfo.CPUShares {
  397. warnings = append(warnings, "Your kernel does not support CPU shares or the cgroup is not mounted. Shares discarded.")
  398. resources.CPUShares = 0
  399. }
  400. if resources.CPUPeriod > 0 && !sysInfo.CPUCfsPeriod {
  401. warnings = append(warnings, "Your kernel does not support CPU cfs period or the cgroup is not mounted. Period discarded.")
  402. resources.CPUPeriod = 0
  403. }
  404. if resources.CPUPeriod != 0 && (resources.CPUPeriod < 1000 || resources.CPUPeriod > 1000000) {
  405. return warnings, fmt.Errorf("CPU cfs period can not be less than 1ms (i.e. 1000) or larger than 1s (i.e. 1000000)")
  406. }
  407. if resources.CPUQuota > 0 && !sysInfo.CPUCfsQuota {
  408. warnings = append(warnings, "Your kernel does not support CPU cfs quota or the cgroup is not mounted. Quota discarded.")
  409. resources.CPUQuota = 0
  410. }
  411. if resources.CPUQuota > 0 && resources.CPUQuota < 1000 {
  412. return warnings, fmt.Errorf("CPU cfs quota can not be less than 1ms (i.e. 1000)")
  413. }
  414. if resources.CPUPercent > 0 {
  415. warnings = append(warnings, fmt.Sprintf("%s does not support CPU percent. Percent discarded.", runtime.GOOS))
  416. resources.CPUPercent = 0
  417. }
  418. // cpuset subsystem checks and adjustments
  419. if (resources.CpusetCpus != "" || resources.CpusetMems != "") && !sysInfo.Cpuset {
  420. warnings = append(warnings, "Your kernel does not support cpuset or the cgroup is not mounted. Cpuset discarded.")
  421. resources.CpusetCpus = ""
  422. resources.CpusetMems = ""
  423. }
  424. cpusAvailable, err := sysInfo.IsCpusetCpusAvailable(resources.CpusetCpus)
  425. if err != nil {
  426. return warnings, errors.Wrapf(err, "Invalid value %s for cpuset cpus", resources.CpusetCpus)
  427. }
  428. if !cpusAvailable {
  429. return warnings, fmt.Errorf("Requested CPUs are not available - requested %s, available: %s", resources.CpusetCpus, sysInfo.Cpus)
  430. }
  431. memsAvailable, err := sysInfo.IsCpusetMemsAvailable(resources.CpusetMems)
  432. if err != nil {
  433. return warnings, errors.Wrapf(err, "Invalid value %s for cpuset mems", resources.CpusetMems)
  434. }
  435. if !memsAvailable {
  436. return warnings, fmt.Errorf("Requested memory nodes are not available - requested %s, available: %s", resources.CpusetMems, sysInfo.Mems)
  437. }
  438. // blkio subsystem checks and adjustments
  439. if resources.BlkioWeight > 0 && !sysInfo.BlkioWeight {
  440. warnings = append(warnings, "Your kernel does not support Block I/O weight or the cgroup is not mounted. Weight discarded.")
  441. resources.BlkioWeight = 0
  442. }
  443. if resources.BlkioWeight > 0 && (resources.BlkioWeight < 10 || resources.BlkioWeight > 1000) {
  444. return warnings, fmt.Errorf("Range of blkio weight is from 10 to 1000")
  445. }
  446. if resources.IOMaximumBandwidth != 0 || resources.IOMaximumIOps != 0 {
  447. return warnings, fmt.Errorf("Invalid QoS settings: %s does not support Maximum IO Bandwidth or Maximum IO IOps", runtime.GOOS)
  448. }
  449. if len(resources.BlkioWeightDevice) > 0 && !sysInfo.BlkioWeightDevice {
  450. warnings = append(warnings, "Your kernel does not support Block I/O weight_device or the cgroup is not mounted. Weight-device discarded.")
  451. resources.BlkioWeightDevice = []*pblkiodev.WeightDevice{}
  452. }
  453. if len(resources.BlkioDeviceReadBps) > 0 && !sysInfo.BlkioReadBpsDevice {
  454. warnings = append(warnings, "Your kernel does not support BPS Block I/O read limit or the cgroup is not mounted. Block I/O BPS read limit discarded.")
  455. resources.BlkioDeviceReadBps = []*pblkiodev.ThrottleDevice{}
  456. }
  457. if len(resources.BlkioDeviceWriteBps) > 0 && !sysInfo.BlkioWriteBpsDevice {
  458. warnings = append(warnings, "Your kernel does not support BPS Block I/O write limit or the cgroup is not mounted. Block I/O BPS write limit discarded.")
  459. resources.BlkioDeviceWriteBps = []*pblkiodev.ThrottleDevice{}
  460. }
  461. if len(resources.BlkioDeviceReadIOps) > 0 && !sysInfo.BlkioReadIOpsDevice {
  462. warnings = append(warnings, "Your kernel does not support IOPS Block read limit or the cgroup is not mounted. Block I/O IOPS read limit discarded.")
  463. resources.BlkioDeviceReadIOps = []*pblkiodev.ThrottleDevice{}
  464. }
  465. if len(resources.BlkioDeviceWriteIOps) > 0 && !sysInfo.BlkioWriteIOpsDevice {
  466. warnings = append(warnings, "Your kernel does not support IOPS Block write limit or the cgroup is not mounted. Block I/O IOPS write limit discarded.")
  467. resources.BlkioDeviceWriteIOps = []*pblkiodev.ThrottleDevice{}
  468. }
  469. return warnings, nil
  470. }
  471. func (daemon *Daemon) getCgroupDriver() string {
  472. cgroupDriver := cgroupFsDriver
  473. if UsingSystemd(daemon.configStore) {
  474. cgroupDriver = cgroupSystemdDriver
  475. }
  476. return cgroupDriver
  477. }
  478. // getCD gets the raw value of the native.cgroupdriver option, if set.
  479. func getCD(config *config.Config) string {
  480. for _, option := range config.ExecOptions {
  481. key, val, err := parsers.ParseKeyValueOpt(option)
  482. if err != nil || !strings.EqualFold(key, "native.cgroupdriver") {
  483. continue
  484. }
  485. return val
  486. }
  487. return ""
  488. }
  489. // VerifyCgroupDriver validates native.cgroupdriver
  490. func VerifyCgroupDriver(config *config.Config) error {
  491. cd := getCD(config)
  492. if cd == "" || cd == cgroupFsDriver || cd == cgroupSystemdDriver {
  493. return nil
  494. }
  495. return fmt.Errorf("native.cgroupdriver option %s not supported", cd)
  496. }
  497. // UsingSystemd returns true if cli option includes native.cgroupdriver=systemd
  498. func UsingSystemd(config *config.Config) bool {
  499. return getCD(config) == cgroupSystemdDriver
  500. }
  501. // verifyPlatformContainerSettings performs platform-specific validation of the
  502. // hostconfig and config structures.
  503. func verifyPlatformContainerSettings(daemon *Daemon, hostConfig *containertypes.HostConfig, config *containertypes.Config, update bool) (warnings []string, err error) {
  504. sysInfo := sysinfo.New(true)
  505. w, err := verifyContainerResources(&hostConfig.Resources, sysInfo, update)
  506. // no matter err is nil or not, w could have data in itself.
  507. warnings = append(warnings, w...)
  508. if err != nil {
  509. return warnings, err
  510. }
  511. if hostConfig.ShmSize < 0 {
  512. return warnings, fmt.Errorf("SHM size can not be less than 0")
  513. }
  514. if hostConfig.OomScoreAdj < -1000 || hostConfig.OomScoreAdj > 1000 {
  515. return warnings, fmt.Errorf("Invalid value %d, range for oom score adj is [-1000, 1000]", hostConfig.OomScoreAdj)
  516. }
  517. // ip-forwarding does not affect container with '--net=host' (or '--net=none')
  518. if sysInfo.IPv4ForwardingDisabled && !(hostConfig.NetworkMode.IsHost() || hostConfig.NetworkMode.IsNone()) {
  519. warnings = append(warnings, "IPv4 forwarding is disabled. Networking will not work.")
  520. }
  521. if hostConfig.NetworkMode.IsHost() && len(hostConfig.PortBindings) > 0 {
  522. warnings = append(warnings, "Published ports are discarded when using host network mode")
  523. }
  524. // check for various conflicting options with user namespaces
  525. if daemon.configStore.RemappedRoot != "" && hostConfig.UsernsMode.IsPrivate() {
  526. if hostConfig.Privileged {
  527. return warnings, fmt.Errorf("privileged mode is incompatible with user namespaces. You must run the container in the host namespace when running privileged mode")
  528. }
  529. if hostConfig.NetworkMode.IsHost() && !hostConfig.UsernsMode.IsHost() {
  530. return warnings, fmt.Errorf("cannot share the host's network namespace when user namespaces are enabled")
  531. }
  532. if hostConfig.PidMode.IsHost() && !hostConfig.UsernsMode.IsHost() {
  533. return warnings, fmt.Errorf("cannot share the host PID namespace when user namespaces are enabled")
  534. }
  535. }
  536. if hostConfig.CgroupParent != "" && UsingSystemd(daemon.configStore) {
  537. // CgroupParent for systemd cgroup should be named as "xxx.slice"
  538. if len(hostConfig.CgroupParent) <= 6 || !strings.HasSuffix(hostConfig.CgroupParent, ".slice") {
  539. return warnings, fmt.Errorf("cgroup-parent for systemd cgroup should be a valid slice named as \"xxx.slice\"")
  540. }
  541. }
  542. if hostConfig.Runtime == "" {
  543. hostConfig.Runtime = daemon.configStore.GetDefaultRuntimeName()
  544. }
  545. if rt := daemon.configStore.GetRuntime(hostConfig.Runtime); rt == nil {
  546. return warnings, fmt.Errorf("Unknown runtime specified %s", hostConfig.Runtime)
  547. }
  548. parser := volumemounts.NewParser(runtime.GOOS)
  549. for dest := range hostConfig.Tmpfs {
  550. if err := parser.ValidateTmpfsMountDestination(dest); err != nil {
  551. return warnings, err
  552. }
  553. }
  554. return warnings, nil
  555. }
  556. func (daemon *Daemon) loadRuntimes() error {
  557. return daemon.initRuntimes(daemon.configStore.Runtimes)
  558. }
  559. func (daemon *Daemon) initRuntimes(runtimes map[string]types.Runtime) (err error) {
  560. runtimeDir := filepath.Join(daemon.configStore.Root, "runtimes")
  561. // Remove old temp directory if any
  562. os.RemoveAll(runtimeDir + "-old")
  563. tmpDir, err := ioutils.TempDir(daemon.configStore.Root, "gen-runtimes")
  564. if err != nil {
  565. return errors.Wrap(err, "failed to get temp dir to generate runtime scripts")
  566. }
  567. defer func() {
  568. if err != nil {
  569. if err1 := os.RemoveAll(tmpDir); err1 != nil {
  570. logrus.WithError(err1).WithField("dir", tmpDir).
  571. Warn("failed to remove tmp dir")
  572. }
  573. return
  574. }
  575. if err = os.Rename(runtimeDir, runtimeDir+"-old"); err != nil {
  576. return
  577. }
  578. if err = os.Rename(tmpDir, runtimeDir); err != nil {
  579. err = errors.Wrap(err, "failed to setup runtimes dir, new containers may not start")
  580. return
  581. }
  582. if err = os.RemoveAll(runtimeDir + "-old"); err != nil {
  583. logrus.WithError(err).WithField("dir", tmpDir).
  584. Warn("failed to remove old runtimes dir")
  585. }
  586. }()
  587. for name, rt := range runtimes {
  588. if len(rt.Args) == 0 {
  589. continue
  590. }
  591. script := filepath.Join(tmpDir, name)
  592. content := fmt.Sprintf("#!/bin/sh\n%s %s $@\n", rt.Path, strings.Join(rt.Args, " "))
  593. if err := ioutil.WriteFile(script, []byte(content), 0700); err != nil {
  594. return err
  595. }
  596. }
  597. return nil
  598. }
  599. // verifyDaemonSettings performs validation of daemon config struct
  600. func verifyDaemonSettings(conf *config.Config) error {
  601. // Check for mutually incompatible config options
  602. if conf.BridgeConfig.Iface != "" && conf.BridgeConfig.IP != "" {
  603. return fmt.Errorf("You specified -b & --bip, mutually exclusive options. Please specify only one")
  604. }
  605. if !conf.BridgeConfig.EnableIPTables && !conf.BridgeConfig.InterContainerCommunication {
  606. return fmt.Errorf("You specified --iptables=false with --icc=false. ICC=false uses iptables to function. Please set --icc or --iptables to true")
  607. }
  608. if !conf.BridgeConfig.EnableIPTables && conf.BridgeConfig.EnableIPMasq {
  609. conf.BridgeConfig.EnableIPMasq = false
  610. }
  611. if err := VerifyCgroupDriver(conf); err != nil {
  612. return err
  613. }
  614. if conf.CgroupParent != "" && UsingSystemd(conf) {
  615. if len(conf.CgroupParent) <= 6 || !strings.HasSuffix(conf.CgroupParent, ".slice") {
  616. return fmt.Errorf("cgroup-parent for systemd cgroup should be a valid slice named as \"xxx.slice\"")
  617. }
  618. }
  619. if conf.DefaultRuntime == "" {
  620. conf.DefaultRuntime = config.StockRuntimeName
  621. }
  622. if conf.Runtimes == nil {
  623. conf.Runtimes = make(map[string]types.Runtime)
  624. }
  625. conf.Runtimes[config.StockRuntimeName] = types.Runtime{Path: DefaultRuntimeName}
  626. return nil
  627. }
  628. // checkSystem validates platform-specific requirements
  629. func checkSystem() error {
  630. if os.Geteuid() != 0 {
  631. return fmt.Errorf("The Docker daemon needs to be run as root")
  632. }
  633. return checkKernel()
  634. }
  635. // configureMaxThreads sets the Go runtime max threads threshold
  636. // which is 90% of the kernel setting from /proc/sys/kernel/threads-max
  637. func configureMaxThreads(config *config.Config) error {
  638. mt, err := ioutil.ReadFile("/proc/sys/kernel/threads-max")
  639. if err != nil {
  640. return err
  641. }
  642. mtint, err := strconv.Atoi(strings.TrimSpace(string(mt)))
  643. if err != nil {
  644. return err
  645. }
  646. maxThreads := (mtint / 100) * 90
  647. debug.SetMaxThreads(maxThreads)
  648. logrus.Debugf("Golang's threads limit set to %d", maxThreads)
  649. return nil
  650. }
  651. func overlaySupportsSelinux() (bool, error) {
  652. f, err := os.Open("/proc/kallsyms")
  653. if err != nil {
  654. if os.IsNotExist(err) {
  655. return false, nil
  656. }
  657. return false, err
  658. }
  659. defer f.Close()
  660. var symAddr, symType, symName, text string
  661. s := bufio.NewScanner(f)
  662. for s.Scan() {
  663. if err := s.Err(); err != nil {
  664. return false, err
  665. }
  666. text = s.Text()
  667. if _, err := fmt.Sscanf(text, "%s %s %s", &symAddr, &symType, &symName); err != nil {
  668. return false, fmt.Errorf("Scanning '%s' failed: %s", text, err)
  669. }
  670. // Check for presence of symbol security_inode_copy_up.
  671. if symName == "security_inode_copy_up" {
  672. return true, nil
  673. }
  674. }
  675. return false, nil
  676. }
  677. // configureKernelSecuritySupport configures and validates security support for the kernel
  678. func configureKernelSecuritySupport(config *config.Config, driverName string) error {
  679. if config.EnableSelinuxSupport {
  680. if !selinuxEnabled() {
  681. logrus.Warn("Docker could not enable SELinux on the host system")
  682. return nil
  683. }
  684. if driverName == "overlay" || driverName == "overlay2" {
  685. // If driver is overlay or overlay2, make sure kernel
  686. // supports selinux with overlay.
  687. supported, err := overlaySupportsSelinux()
  688. if err != nil {
  689. return err
  690. }
  691. if !supported {
  692. logrus.Warnf("SELinux is not supported with the %v graph driver on this kernel", driverName)
  693. }
  694. }
  695. } else {
  696. selinuxSetDisabled()
  697. }
  698. return nil
  699. }
  700. func (daemon *Daemon) initNetworkController(config *config.Config, activeSandboxes map[string]interface{}) (libnetwork.NetworkController, error) {
  701. netOptions, err := daemon.networkOptions(config, daemon.PluginStore, activeSandboxes)
  702. if err != nil {
  703. return nil, err
  704. }
  705. controller, err := libnetwork.New(netOptions...)
  706. if err != nil {
  707. return nil, fmt.Errorf("error obtaining controller instance: %v", err)
  708. }
  709. if len(activeSandboxes) > 0 {
  710. logrus.Info("There are old running containers, the network config will not take affect")
  711. return controller, nil
  712. }
  713. // Initialize default network on "null"
  714. if n, _ := controller.NetworkByName("none"); n == nil {
  715. if _, err := controller.NewNetwork("null", "none", "", libnetwork.NetworkOptionPersist(true)); err != nil {
  716. return nil, fmt.Errorf("Error creating default \"null\" network: %v", err)
  717. }
  718. }
  719. // Initialize default network on "host"
  720. if n, _ := controller.NetworkByName("host"); n == nil {
  721. if _, err := controller.NewNetwork("host", "host", "", libnetwork.NetworkOptionPersist(true)); err != nil {
  722. return nil, fmt.Errorf("Error creating default \"host\" network: %v", err)
  723. }
  724. }
  725. // Clear stale bridge network
  726. if n, err := controller.NetworkByName("bridge"); err == nil {
  727. if err = n.Delete(); err != nil {
  728. return nil, fmt.Errorf("could not delete the default bridge network: %v", err)
  729. }
  730. if len(config.NetworkConfig.DefaultAddressPools.Value()) > 0 && !daemon.configStore.LiveRestoreEnabled {
  731. removeDefaultBridgeInterface()
  732. }
  733. }
  734. if !config.DisableBridge {
  735. // Initialize default driver "bridge"
  736. if err := initBridgeDriver(controller, config); err != nil {
  737. return nil, err
  738. }
  739. } else {
  740. removeDefaultBridgeInterface()
  741. }
  742. return controller, nil
  743. }
  744. func driverOptions(config *config.Config) []nwconfig.Option {
  745. bridgeConfig := options.Generic{
  746. "EnableIPForwarding": config.BridgeConfig.EnableIPForward,
  747. "EnableIPTables": config.BridgeConfig.EnableIPTables,
  748. "EnableUserlandProxy": config.BridgeConfig.EnableUserlandProxy,
  749. "UserlandProxyPath": config.BridgeConfig.UserlandProxyPath}
  750. bridgeOption := options.Generic{netlabel.GenericData: bridgeConfig}
  751. dOptions := []nwconfig.Option{}
  752. dOptions = append(dOptions, nwconfig.OptionDriverConfig("bridge", bridgeOption))
  753. return dOptions
  754. }
  755. func initBridgeDriver(controller libnetwork.NetworkController, config *config.Config) error {
  756. bridgeName := bridge.DefaultBridgeName
  757. if config.BridgeConfig.Iface != "" {
  758. bridgeName = config.BridgeConfig.Iface
  759. }
  760. netOption := map[string]string{
  761. bridge.BridgeName: bridgeName,
  762. bridge.DefaultBridge: strconv.FormatBool(true),
  763. netlabel.DriverMTU: strconv.Itoa(config.Mtu),
  764. bridge.EnableIPMasquerade: strconv.FormatBool(config.BridgeConfig.EnableIPMasq),
  765. bridge.EnableICC: strconv.FormatBool(config.BridgeConfig.InterContainerCommunication),
  766. }
  767. // --ip processing
  768. if config.BridgeConfig.DefaultIP != nil {
  769. netOption[bridge.DefaultBindingIP] = config.BridgeConfig.DefaultIP.String()
  770. }
  771. var (
  772. ipamV4Conf *libnetwork.IpamConf
  773. ipamV6Conf *libnetwork.IpamConf
  774. )
  775. ipamV4Conf = &libnetwork.IpamConf{AuxAddresses: make(map[string]string)}
  776. nwList, nw6List, err := netutils.ElectInterfaceAddresses(bridgeName)
  777. if err != nil {
  778. return errors.Wrap(err, "list bridge addresses failed")
  779. }
  780. nw := nwList[0]
  781. if len(nwList) > 1 && config.BridgeConfig.FixedCIDR != "" {
  782. _, fCIDR, err := net.ParseCIDR(config.BridgeConfig.FixedCIDR)
  783. if err != nil {
  784. return errors.Wrap(err, "parse CIDR failed")
  785. }
  786. // Iterate through in case there are multiple addresses for the bridge
  787. for _, entry := range nwList {
  788. if fCIDR.Contains(entry.IP) {
  789. nw = entry
  790. break
  791. }
  792. }
  793. }
  794. ipamV4Conf.PreferredPool = lntypes.GetIPNetCanonical(nw).String()
  795. hip, _ := lntypes.GetHostPartIP(nw.IP, nw.Mask)
  796. if hip.IsGlobalUnicast() {
  797. ipamV4Conf.Gateway = nw.IP.String()
  798. }
  799. if config.BridgeConfig.IP != "" {
  800. ipamV4Conf.PreferredPool = config.BridgeConfig.IP
  801. ip, _, err := net.ParseCIDR(config.BridgeConfig.IP)
  802. if err != nil {
  803. return err
  804. }
  805. ipamV4Conf.Gateway = ip.String()
  806. } else if bridgeName == bridge.DefaultBridgeName && ipamV4Conf.PreferredPool != "" {
  807. logrus.Infof("Default bridge (%s) is assigned with an IP address %s. Daemon option --bip can be used to set a preferred IP address", bridgeName, ipamV4Conf.PreferredPool)
  808. }
  809. if config.BridgeConfig.FixedCIDR != "" {
  810. _, fCIDR, err := net.ParseCIDR(config.BridgeConfig.FixedCIDR)
  811. if err != nil {
  812. return err
  813. }
  814. ipamV4Conf.SubPool = fCIDR.String()
  815. }
  816. if config.BridgeConfig.DefaultGatewayIPv4 != nil {
  817. ipamV4Conf.AuxAddresses["DefaultGatewayIPv4"] = config.BridgeConfig.DefaultGatewayIPv4.String()
  818. }
  819. var deferIPv6Alloc bool
  820. if config.BridgeConfig.FixedCIDRv6 != "" {
  821. _, fCIDRv6, err := net.ParseCIDR(config.BridgeConfig.FixedCIDRv6)
  822. if err != nil {
  823. return err
  824. }
  825. // In case user has specified the daemon flag --fixed-cidr-v6 and the passed network has
  826. // at least 48 host bits, we need to guarantee the current behavior where the containers'
  827. // IPv6 addresses will be constructed based on the containers' interface MAC address.
  828. // We do so by telling libnetwork to defer the IPv6 address allocation for the endpoints
  829. // on this network until after the driver has created the endpoint and returned the
  830. // constructed address. Libnetwork will then reserve this address with the ipam driver.
  831. ones, _ := fCIDRv6.Mask.Size()
  832. deferIPv6Alloc = ones <= 80
  833. if ipamV6Conf == nil {
  834. ipamV6Conf = &libnetwork.IpamConf{AuxAddresses: make(map[string]string)}
  835. }
  836. ipamV6Conf.PreferredPool = fCIDRv6.String()
  837. // In case the --fixed-cidr-v6 is specified and the current docker0 bridge IPv6
  838. // address belongs to the same network, we need to inform libnetwork about it, so
  839. // that it can be reserved with IPAM and it will not be given away to somebody else
  840. for _, nw6 := range nw6List {
  841. if fCIDRv6.Contains(nw6.IP) {
  842. ipamV6Conf.Gateway = nw6.IP.String()
  843. break
  844. }
  845. }
  846. }
  847. if config.BridgeConfig.DefaultGatewayIPv6 != nil {
  848. if ipamV6Conf == nil {
  849. ipamV6Conf = &libnetwork.IpamConf{AuxAddresses: make(map[string]string)}
  850. }
  851. ipamV6Conf.AuxAddresses["DefaultGatewayIPv6"] = config.BridgeConfig.DefaultGatewayIPv6.String()
  852. }
  853. v4Conf := []*libnetwork.IpamConf{ipamV4Conf}
  854. v6Conf := []*libnetwork.IpamConf{}
  855. if ipamV6Conf != nil {
  856. v6Conf = append(v6Conf, ipamV6Conf)
  857. }
  858. // Initialize default network on "bridge" with the same name
  859. _, err = controller.NewNetwork("bridge", "bridge", "",
  860. libnetwork.NetworkOptionEnableIPv6(config.BridgeConfig.EnableIPv6),
  861. libnetwork.NetworkOptionDriverOpts(netOption),
  862. libnetwork.NetworkOptionIpam("default", "", v4Conf, v6Conf, nil),
  863. libnetwork.NetworkOptionDeferIPv6Alloc(deferIPv6Alloc))
  864. if err != nil {
  865. return fmt.Errorf("Error creating default \"bridge\" network: %v", err)
  866. }
  867. return nil
  868. }
  869. // Remove default bridge interface if present (--bridge=none use case)
  870. func removeDefaultBridgeInterface() {
  871. if lnk, err := netlink.LinkByName(bridge.DefaultBridgeName); err == nil {
  872. if err := netlink.LinkDel(lnk); err != nil {
  873. logrus.Warnf("Failed to remove bridge interface (%s): %v", bridge.DefaultBridgeName, err)
  874. }
  875. }
  876. }
  877. func setupInitLayer(idMapping *idtools.IdentityMapping) func(containerfs.ContainerFS) error {
  878. return func(initPath containerfs.ContainerFS) error {
  879. return initlayer.Setup(initPath, idMapping.RootPair())
  880. }
  881. }
  882. // Parse the remapped root (user namespace) option, which can be one of:
  883. // username - valid username from /etc/passwd
  884. // username:groupname - valid username; valid groupname from /etc/group
  885. // uid - 32-bit unsigned int valid Linux UID value
  886. // uid:gid - uid value; 32-bit unsigned int Linux GID value
  887. //
  888. // If no groupname is specified, and a username is specified, an attempt
  889. // will be made to lookup a gid for that username as a groupname
  890. //
  891. // If names are used, they are verified to exist in passwd/group
  892. func parseRemappedRoot(usergrp string) (string, string, error) {
  893. var (
  894. userID, groupID int
  895. username, groupname string
  896. )
  897. idparts := strings.Split(usergrp, ":")
  898. if len(idparts) > 2 {
  899. return "", "", fmt.Errorf("Invalid user/group specification in --userns-remap: %q", usergrp)
  900. }
  901. if uid, err := strconv.ParseInt(idparts[0], 10, 32); err == nil {
  902. // must be a uid; take it as valid
  903. userID = int(uid)
  904. luser, err := idtools.LookupUID(userID)
  905. if err != nil {
  906. return "", "", fmt.Errorf("Uid %d has no entry in /etc/passwd: %v", userID, err)
  907. }
  908. username = luser.Name
  909. if len(idparts) == 1 {
  910. // if the uid was numeric and no gid was specified, take the uid as the gid
  911. groupID = userID
  912. lgrp, err := idtools.LookupGID(groupID)
  913. if err != nil {
  914. return "", "", fmt.Errorf("Gid %d has no entry in /etc/group: %v", groupID, err)
  915. }
  916. groupname = lgrp.Name
  917. }
  918. } else {
  919. lookupName := idparts[0]
  920. // special case: if the user specified "default", they want Docker to create or
  921. // use (after creation) the "dockremap" user/group for root remapping
  922. if lookupName == defaultIDSpecifier {
  923. lookupName = defaultRemappedID
  924. }
  925. luser, err := idtools.LookupUser(lookupName)
  926. if err != nil && idparts[0] != defaultIDSpecifier {
  927. // error if the name requested isn't the special "dockremap" ID
  928. return "", "", fmt.Errorf("Error during uid lookup for %q: %v", lookupName, err)
  929. } else if err != nil {
  930. // special case-- if the username == "default", then we have been asked
  931. // to create a new entry pair in /etc/{passwd,group} for which the /etc/sub{uid,gid}
  932. // ranges will be used for the user and group mappings in user namespaced containers
  933. _, _, err := idtools.AddNamespaceRangesUser(defaultRemappedID)
  934. if err == nil {
  935. return defaultRemappedID, defaultRemappedID, nil
  936. }
  937. return "", "", fmt.Errorf("Error during %q user creation: %v", defaultRemappedID, err)
  938. }
  939. username = luser.Name
  940. if len(idparts) == 1 {
  941. // we only have a string username, and no group specified; look up gid from username as group
  942. group, err := idtools.LookupGroup(lookupName)
  943. if err != nil {
  944. return "", "", fmt.Errorf("Error during gid lookup for %q: %v", lookupName, err)
  945. }
  946. groupname = group.Name
  947. }
  948. }
  949. if len(idparts) == 2 {
  950. // groupname or gid is separately specified and must be resolved
  951. // to an unsigned 32-bit gid
  952. if gid, err := strconv.ParseInt(idparts[1], 10, 32); err == nil {
  953. // must be a gid, take it as valid
  954. groupID = int(gid)
  955. lgrp, err := idtools.LookupGID(groupID)
  956. if err != nil {
  957. return "", "", fmt.Errorf("Gid %d has no entry in /etc/passwd: %v", groupID, err)
  958. }
  959. groupname = lgrp.Name
  960. } else {
  961. // not a number; attempt a lookup
  962. if _, err := idtools.LookupGroup(idparts[1]); err != nil {
  963. return "", "", fmt.Errorf("Error during groupname lookup for %q: %v", idparts[1], err)
  964. }
  965. groupname = idparts[1]
  966. }
  967. }
  968. return username, groupname, nil
  969. }
  970. func setupRemappedRoot(config *config.Config) (*idtools.IdentityMapping, error) {
  971. if runtime.GOOS != "linux" && config.RemappedRoot != "" {
  972. return nil, fmt.Errorf("User namespaces are only supported on Linux")
  973. }
  974. // if the daemon was started with remapped root option, parse
  975. // the config option to the int uid,gid values
  976. if config.RemappedRoot != "" {
  977. username, groupname, err := parseRemappedRoot(config.RemappedRoot)
  978. if err != nil {
  979. return nil, err
  980. }
  981. if username == "root" {
  982. // Cannot setup user namespaces with a 1-to-1 mapping; "--root=0:0" is a no-op
  983. // effectively
  984. logrus.Warn("User namespaces: root cannot be remapped with itself; user namespaces are OFF")
  985. return &idtools.IdentityMapping{}, nil
  986. }
  987. logrus.Infof("User namespaces: ID ranges will be mapped to subuid/subgid ranges of: %s:%s", username, groupname)
  988. // update remapped root setting now that we have resolved them to actual names
  989. config.RemappedRoot = fmt.Sprintf("%s:%s", username, groupname)
  990. mappings, err := idtools.NewIdentityMapping(username, groupname)
  991. if err != nil {
  992. return nil, errors.Wrap(err, "Can't create ID mappings")
  993. }
  994. return mappings, nil
  995. }
  996. return &idtools.IdentityMapping{}, nil
  997. }
  998. func setupDaemonRoot(config *config.Config, rootDir string, rootIdentity idtools.Identity) error {
  999. config.Root = rootDir
  1000. // the docker root metadata directory needs to have execute permissions for all users (g+x,o+x)
  1001. // so that syscalls executing as non-root, operating on subdirectories of the graph root
  1002. // (e.g. mounted layers of a container) can traverse this path.
  1003. // The user namespace support will create subdirectories for the remapped root host uid:gid
  1004. // pair owned by that same uid:gid pair for proper write access to those needed metadata and
  1005. // layer content subtrees.
  1006. if _, err := os.Stat(rootDir); err == nil {
  1007. // root current exists; verify the access bits are correct by setting them
  1008. if err = os.Chmod(rootDir, 0711); err != nil {
  1009. return err
  1010. }
  1011. } else if os.IsNotExist(err) {
  1012. // no root exists yet, create it 0711 with root:root ownership
  1013. if err := os.MkdirAll(rootDir, 0711); err != nil {
  1014. return err
  1015. }
  1016. }
  1017. // if user namespaces are enabled we will create a subtree underneath the specified root
  1018. // with any/all specified remapped root uid/gid options on the daemon creating
  1019. // a new subdirectory with ownership set to the remapped uid/gid (so as to allow
  1020. // `chdir()` to work for containers namespaced to that uid/gid)
  1021. if config.RemappedRoot != "" {
  1022. config.Root = filepath.Join(rootDir, fmt.Sprintf("%d.%d", rootIdentity.UID, rootIdentity.GID))
  1023. logrus.Debugf("Creating user namespaced daemon root: %s", config.Root)
  1024. // Create the root directory if it doesn't exist
  1025. if err := idtools.MkdirAllAndChown(config.Root, 0700, rootIdentity); err != nil {
  1026. return fmt.Errorf("Cannot create daemon root: %s: %v", config.Root, err)
  1027. }
  1028. // we also need to verify that any pre-existing directories in the path to
  1029. // the graphroot won't block access to remapped root--if any pre-existing directory
  1030. // has strict permissions that don't allow "x", container start will fail, so
  1031. // better to warn and fail now
  1032. dirPath := config.Root
  1033. for {
  1034. dirPath = filepath.Dir(dirPath)
  1035. if dirPath == "/" {
  1036. break
  1037. }
  1038. if !idtools.CanAccess(dirPath, rootIdentity) {
  1039. return fmt.Errorf("a subdirectory in your graphroot path (%s) restricts access to the remapped root uid/gid; please fix by allowing 'o+x' permissions on existing directories", config.Root)
  1040. }
  1041. }
  1042. }
  1043. if err := setupDaemonRootPropagation(config); err != nil {
  1044. logrus.WithError(err).WithField("dir", config.Root).Warn("Error while setting daemon root propagation, this is not generally critical but may cause some functionality to not work or fallback to less desirable behavior")
  1045. }
  1046. return nil
  1047. }
  1048. func setupDaemonRootPropagation(cfg *config.Config) error {
  1049. rootParentMount, options, err := getSourceMount(cfg.Root)
  1050. if err != nil {
  1051. return errors.Wrap(err, "error getting daemon root's parent mount")
  1052. }
  1053. var cleanupOldFile bool
  1054. cleanupFile := getUnmountOnShutdownPath(cfg)
  1055. defer func() {
  1056. if !cleanupOldFile {
  1057. return
  1058. }
  1059. if err := os.Remove(cleanupFile); err != nil && !os.IsNotExist(err) {
  1060. logrus.WithError(err).WithField("file", cleanupFile).Warn("could not clean up old root propagation unmount file")
  1061. }
  1062. }()
  1063. if hasMountinfoOption(options, sharedPropagationOption, slavePropagationOption) {
  1064. cleanupOldFile = true
  1065. return nil
  1066. }
  1067. if err := mount.MakeShared(cfg.Root); err != nil {
  1068. return errors.Wrap(err, "could not setup daemon root propagation to shared")
  1069. }
  1070. // check the case where this may have already been a mount to itself.
  1071. // If so then the daemon only performed a remount and should not try to unmount this later.
  1072. if rootParentMount == cfg.Root {
  1073. cleanupOldFile = true
  1074. return nil
  1075. }
  1076. if err := ioutil.WriteFile(cleanupFile, nil, 0600); err != nil {
  1077. return errors.Wrap(err, "error writing file to signal mount cleanup on shutdown")
  1078. }
  1079. return nil
  1080. }
  1081. // getUnmountOnShutdownPath generates the path to used when writing the file that signals to the daemon that on shutdown
  1082. // the daemon root should be unmounted.
  1083. func getUnmountOnShutdownPath(config *config.Config) string {
  1084. return filepath.Join(config.ExecRoot, "unmount-on-shutdown")
  1085. }
  1086. // registerLinks writes the links to a file.
  1087. func (daemon *Daemon) registerLinks(container *container.Container, hostConfig *containertypes.HostConfig) error {
  1088. if hostConfig == nil || hostConfig.NetworkMode.IsUserDefined() {
  1089. return nil
  1090. }
  1091. for _, l := range hostConfig.Links {
  1092. name, alias, err := opts.ParseLink(l)
  1093. if err != nil {
  1094. return err
  1095. }
  1096. child, err := daemon.GetContainer(name)
  1097. if err != nil {
  1098. return errors.Wrapf(err, "could not get container for %s", name)
  1099. }
  1100. for child.HostConfig.NetworkMode.IsContainer() {
  1101. parts := strings.SplitN(string(child.HostConfig.NetworkMode), ":", 2)
  1102. child, err = daemon.GetContainer(parts[1])
  1103. if err != nil {
  1104. return errors.Wrapf(err, "Could not get container for %s", parts[1])
  1105. }
  1106. }
  1107. if child.HostConfig.NetworkMode.IsHost() {
  1108. return runconfig.ErrConflictHostNetworkAndLinks
  1109. }
  1110. if err := daemon.registerLink(container, child, alias); err != nil {
  1111. return err
  1112. }
  1113. }
  1114. // After we load all the links into the daemon
  1115. // set them to nil on the hostconfig
  1116. _, err := container.WriteHostConfig()
  1117. return err
  1118. }
  1119. // conditionalMountOnStart is a platform specific helper function during the
  1120. // container start to call mount.
  1121. func (daemon *Daemon) conditionalMountOnStart(container *container.Container) error {
  1122. return daemon.Mount(container)
  1123. }
  1124. // conditionalUnmountOnCleanup is a platform specific helper function called
  1125. // during the cleanup of a container to unmount.
  1126. func (daemon *Daemon) conditionalUnmountOnCleanup(container *container.Container) error {
  1127. return daemon.Unmount(container)
  1128. }
  1129. func copyBlkioEntry(entries []*containerd_cgroups.BlkIOEntry) []types.BlkioStatEntry {
  1130. out := make([]types.BlkioStatEntry, len(entries))
  1131. for i, re := range entries {
  1132. out[i] = types.BlkioStatEntry{
  1133. Major: re.Major,
  1134. Minor: re.Minor,
  1135. Op: re.Op,
  1136. Value: re.Value,
  1137. }
  1138. }
  1139. return out
  1140. }
  1141. func (daemon *Daemon) stats(c *container.Container) (*types.StatsJSON, error) {
  1142. if !c.IsRunning() {
  1143. return nil, errNotRunning(c.ID)
  1144. }
  1145. cs, err := daemon.containerd.Stats(context.Background(), c.ID)
  1146. if err != nil {
  1147. if strings.Contains(err.Error(), "container not found") {
  1148. return nil, containerNotFound(c.ID)
  1149. }
  1150. return nil, err
  1151. }
  1152. s := &types.StatsJSON{}
  1153. s.Read = cs.Read
  1154. stats := cs.Metrics
  1155. if stats.Blkio != nil {
  1156. s.BlkioStats = types.BlkioStats{
  1157. IoServiceBytesRecursive: copyBlkioEntry(stats.Blkio.IoServiceBytesRecursive),
  1158. IoServicedRecursive: copyBlkioEntry(stats.Blkio.IoServicedRecursive),
  1159. IoQueuedRecursive: copyBlkioEntry(stats.Blkio.IoQueuedRecursive),
  1160. IoServiceTimeRecursive: copyBlkioEntry(stats.Blkio.IoServiceTimeRecursive),
  1161. IoWaitTimeRecursive: copyBlkioEntry(stats.Blkio.IoWaitTimeRecursive),
  1162. IoMergedRecursive: copyBlkioEntry(stats.Blkio.IoMergedRecursive),
  1163. IoTimeRecursive: copyBlkioEntry(stats.Blkio.IoTimeRecursive),
  1164. SectorsRecursive: copyBlkioEntry(stats.Blkio.SectorsRecursive),
  1165. }
  1166. }
  1167. if stats.CPU != nil {
  1168. s.CPUStats = types.CPUStats{
  1169. CPUUsage: types.CPUUsage{
  1170. TotalUsage: stats.CPU.Usage.Total,
  1171. PercpuUsage: stats.CPU.Usage.PerCPU,
  1172. UsageInKernelmode: stats.CPU.Usage.Kernel,
  1173. UsageInUsermode: stats.CPU.Usage.User,
  1174. },
  1175. ThrottlingData: types.ThrottlingData{
  1176. Periods: stats.CPU.Throttling.Periods,
  1177. ThrottledPeriods: stats.CPU.Throttling.ThrottledPeriods,
  1178. ThrottledTime: stats.CPU.Throttling.ThrottledTime,
  1179. },
  1180. }
  1181. }
  1182. if stats.Memory != nil {
  1183. raw := make(map[string]uint64)
  1184. raw["cache"] = stats.Memory.Cache
  1185. raw["rss"] = stats.Memory.RSS
  1186. raw["rss_huge"] = stats.Memory.RSSHuge
  1187. raw["mapped_file"] = stats.Memory.MappedFile
  1188. raw["dirty"] = stats.Memory.Dirty
  1189. raw["writeback"] = stats.Memory.Writeback
  1190. raw["pgpgin"] = stats.Memory.PgPgIn
  1191. raw["pgpgout"] = stats.Memory.PgPgOut
  1192. raw["pgfault"] = stats.Memory.PgFault
  1193. raw["pgmajfault"] = stats.Memory.PgMajFault
  1194. raw["inactive_anon"] = stats.Memory.InactiveAnon
  1195. raw["active_anon"] = stats.Memory.ActiveAnon
  1196. raw["inactive_file"] = stats.Memory.InactiveFile
  1197. raw["active_file"] = stats.Memory.ActiveFile
  1198. raw["unevictable"] = stats.Memory.Unevictable
  1199. raw["hierarchical_memory_limit"] = stats.Memory.HierarchicalMemoryLimit
  1200. raw["hierarchical_memsw_limit"] = stats.Memory.HierarchicalSwapLimit
  1201. raw["total_cache"] = stats.Memory.TotalCache
  1202. raw["total_rss"] = stats.Memory.TotalRSS
  1203. raw["total_rss_huge"] = stats.Memory.TotalRSSHuge
  1204. raw["total_mapped_file"] = stats.Memory.TotalMappedFile
  1205. raw["total_dirty"] = stats.Memory.TotalDirty
  1206. raw["total_writeback"] = stats.Memory.TotalWriteback
  1207. raw["total_pgpgin"] = stats.Memory.TotalPgPgIn
  1208. raw["total_pgpgout"] = stats.Memory.TotalPgPgOut
  1209. raw["total_pgfault"] = stats.Memory.TotalPgFault
  1210. raw["total_pgmajfault"] = stats.Memory.TotalPgMajFault
  1211. raw["total_inactive_anon"] = stats.Memory.TotalInactiveAnon
  1212. raw["total_active_anon"] = stats.Memory.TotalActiveAnon
  1213. raw["total_inactive_file"] = stats.Memory.TotalInactiveFile
  1214. raw["total_active_file"] = stats.Memory.TotalActiveFile
  1215. raw["total_unevictable"] = stats.Memory.TotalUnevictable
  1216. if stats.Memory.Usage != nil {
  1217. s.MemoryStats = types.MemoryStats{
  1218. Stats: raw,
  1219. Usage: stats.Memory.Usage.Usage,
  1220. MaxUsage: stats.Memory.Usage.Max,
  1221. Limit: stats.Memory.Usage.Limit,
  1222. Failcnt: stats.Memory.Usage.Failcnt,
  1223. }
  1224. } else {
  1225. s.MemoryStats = types.MemoryStats{
  1226. Stats: raw,
  1227. }
  1228. }
  1229. // if the container does not set memory limit, use the machineMemory
  1230. if s.MemoryStats.Limit > daemon.machineMemory && daemon.machineMemory > 0 {
  1231. s.MemoryStats.Limit = daemon.machineMemory
  1232. }
  1233. }
  1234. if stats.Pids != nil {
  1235. s.PidsStats = types.PidsStats{
  1236. Current: stats.Pids.Current,
  1237. Limit: stats.Pids.Limit,
  1238. }
  1239. }
  1240. return s, nil
  1241. }
  1242. // setDefaultIsolation determines the default isolation mode for the
  1243. // daemon to run in. This is only applicable on Windows
  1244. func (daemon *Daemon) setDefaultIsolation() error {
  1245. return nil
  1246. }
  1247. // setupDaemonProcess sets various settings for the daemon's process
  1248. func setupDaemonProcess(config *config.Config) error {
  1249. // setup the daemons oom_score_adj
  1250. if err := setupOOMScoreAdj(config.OOMScoreAdjust); err != nil {
  1251. return err
  1252. }
  1253. if err := setMayDetachMounts(); err != nil {
  1254. logrus.WithError(err).Warn("Could not set may_detach_mounts kernel parameter")
  1255. }
  1256. return nil
  1257. }
  1258. // This is used to allow removal of mountpoints that may be mounted in other
  1259. // namespaces on RHEL based kernels starting from RHEL 7.4.
  1260. // Without this setting, removals on these RHEL based kernels may fail with
  1261. // "device or resource busy".
  1262. // This setting is not available in upstream kernels as it is not configurable,
  1263. // but has been in the upstream kernels since 3.15.
  1264. func setMayDetachMounts() error {
  1265. f, err := os.OpenFile("/proc/sys/fs/may_detach_mounts", os.O_WRONLY, 0)
  1266. if err != nil {
  1267. if os.IsNotExist(err) {
  1268. return nil
  1269. }
  1270. return errors.Wrap(err, "error opening may_detach_mounts kernel config file")
  1271. }
  1272. defer f.Close()
  1273. _, err = f.WriteString("1")
  1274. if os.IsPermission(err) {
  1275. // Setting may_detach_mounts does not work in an
  1276. // unprivileged container. Ignore the error, but log
  1277. // it if we appear not to be in that situation.
  1278. if !rsystem.RunningInUserNS() {
  1279. logrus.Debugf("Permission denied writing %q to /proc/sys/fs/may_detach_mounts", "1")
  1280. }
  1281. return nil
  1282. }
  1283. return err
  1284. }
  1285. func setupOOMScoreAdj(score int) error {
  1286. f, err := os.OpenFile("/proc/self/oom_score_adj", os.O_WRONLY, 0)
  1287. if err != nil {
  1288. return err
  1289. }
  1290. defer f.Close()
  1291. stringScore := strconv.Itoa(score)
  1292. _, err = f.WriteString(stringScore)
  1293. if os.IsPermission(err) {
  1294. // Setting oom_score_adj does not work in an
  1295. // unprivileged container. Ignore the error, but log
  1296. // it if we appear not to be in that situation.
  1297. if !rsystem.RunningInUserNS() {
  1298. logrus.Debugf("Permission denied writing %q to /proc/self/oom_score_adj", stringScore)
  1299. }
  1300. return nil
  1301. }
  1302. return err
  1303. }
  1304. func (daemon *Daemon) initCgroupsPath(path string) error {
  1305. if path == "/" || path == "." {
  1306. return nil
  1307. }
  1308. if daemon.configStore.CPURealtimePeriod == 0 && daemon.configStore.CPURealtimeRuntime == 0 {
  1309. return nil
  1310. }
  1311. // Recursively create cgroup to ensure that the system and all parent cgroups have values set
  1312. // for the period and runtime as this limits what the children can be set to.
  1313. daemon.initCgroupsPath(filepath.Dir(path))
  1314. mnt, root, err := cgroups.FindCgroupMountpointAndRoot("", "cpu")
  1315. if err != nil {
  1316. return err
  1317. }
  1318. // When docker is run inside docker, the root is based of the host cgroup.
  1319. // Should this be handled in runc/libcontainer/cgroups ?
  1320. if strings.HasPrefix(root, "/docker/") {
  1321. root = "/"
  1322. }
  1323. path = filepath.Join(mnt, root, path)
  1324. sysinfo := sysinfo.New(true)
  1325. if err := maybeCreateCPURealTimeFile(sysinfo.CPURealtimePeriod, daemon.configStore.CPURealtimePeriod, "cpu.rt_period_us", path); err != nil {
  1326. return err
  1327. }
  1328. return maybeCreateCPURealTimeFile(sysinfo.CPURealtimeRuntime, daemon.configStore.CPURealtimeRuntime, "cpu.rt_runtime_us", path)
  1329. }
  1330. func maybeCreateCPURealTimeFile(sysinfoPresent bool, configValue int64, file string, path string) error {
  1331. if sysinfoPresent && configValue != 0 {
  1332. if err := os.MkdirAll(path, 0755); err != nil {
  1333. return err
  1334. }
  1335. if err := ioutil.WriteFile(filepath.Join(path, file), []byte(strconv.FormatInt(configValue, 10)), 0700); err != nil {
  1336. return err
  1337. }
  1338. }
  1339. return nil
  1340. }
  1341. func (daemon *Daemon) setupSeccompProfile() error {
  1342. if daemon.configStore.SeccompProfile != "" {
  1343. daemon.seccompProfilePath = daemon.configStore.SeccompProfile
  1344. b, err := ioutil.ReadFile(daemon.configStore.SeccompProfile)
  1345. if err != nil {
  1346. return fmt.Errorf("opening seccomp profile (%s) failed: %v", daemon.configStore.SeccompProfile, err)
  1347. }
  1348. daemon.seccompProfile = b
  1349. }
  1350. return nil
  1351. }