// Package generate implements functions generating container config files. package generate import ( "encoding/json" "fmt" "io" "os" "runtime" "strconv" "strings" rspec "github.com/opencontainers/runtime-spec/specs-go" "github.com/syndtr/gocapability/capability" ) var ( // Namespaces include the names of supported namespaces. Namespaces = []string{"network", "pid", "mount", "ipc", "uts", "user", "cgroup"} ) // Generator represents a generator for a container spec. type Generator struct { spec *rspec.Spec HostSpecific bool } // New creates a spec Generator with the default spec. func New() Generator { spec := rspec.Spec{ Version: rspec.Version, Platform: rspec.Platform{ OS: runtime.GOOS, Arch: runtime.GOARCH, }, Root: rspec.Root{ Path: "", Readonly: false, }, Process: rspec.Process{ Terminal: false, User: rspec.User{}, Args: []string{ "sh", }, Env: []string{ "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", "TERM=xterm", }, Cwd: "/", Capabilities: []string{ "CAP_CHOWN", "CAP_DAC_OVERRIDE", "CAP_FSETID", "CAP_FOWNER", "CAP_MKNOD", "CAP_NET_RAW", "CAP_SETGID", "CAP_SETUID", "CAP_SETFCAP", "CAP_SETPCAP", "CAP_NET_BIND_SERVICE", "CAP_SYS_CHROOT", "CAP_KILL", "CAP_AUDIT_WRITE", }, Rlimits: []rspec.Rlimit{ { Type: "RLIMIT_NOFILE", Hard: uint64(1024), Soft: uint64(1024), }, }, }, Hostname: "mrsdalloway", Mounts: []rspec.Mount{ { Destination: "/proc", Type: "proc", Source: "proc", Options: nil, }, { Destination: "/dev", Type: "tmpfs", Source: "tmpfs", Options: []string{"nosuid", "strictatime", "mode=755", "size=65536k"}, }, { Destination: "/dev/pts", Type: "devpts", Source: "devpts", Options: []string{"nosuid", "noexec", "newinstance", "ptmxmode=0666", "mode=0620", "gid=5"}, }, { Destination: "/dev/shm", Type: "tmpfs", Source: "shm", Options: []string{"nosuid", "noexec", "nodev", "mode=1777", "size=65536k"}, }, { Destination: "/dev/mqueue", Type: "mqueue", Source: "mqueue", Options: []string{"nosuid", "noexec", "nodev"}, }, { Destination: "/sys", Type: "sysfs", Source: "sysfs", Options: []string{"nosuid", "noexec", "nodev", "ro"}, }, }, Linux: &rspec.Linux{ Resources: &rspec.Resources{ Devices: []rspec.DeviceCgroup{ { Allow: false, Access: strPtr("rwm"), }, }, }, Namespaces: []rspec.Namespace{ { Type: "pid", }, { Type: "network", }, { Type: "ipc", }, { Type: "uts", }, { Type: "mount", }, }, Devices: []rspec.Device{}, }, } return Generator{ spec: &spec, } } // NewFromSpec creates a spec Generator from a given spec. func NewFromSpec(spec *rspec.Spec) Generator { return Generator{ spec: spec, } } // NewFromFile loads the template specifed in a file into a spec Generator. func NewFromFile(path string) (Generator, error) { cf, err := os.Open(path) if err != nil { if os.IsNotExist(err) { return Generator{}, fmt.Errorf("template configuration at %s not found", path) } } defer cf.Close() return NewFromTemplate(cf) } // NewFromTemplate loads the template from io.Reader into a spec Generator. func NewFromTemplate(r io.Reader) (Generator, error) { var spec rspec.Spec if err := json.NewDecoder(r).Decode(&spec); err != nil { return Generator{}, err } return Generator{ spec: &spec, }, nil } // SetSpec sets the spec in the Generator g. func (g *Generator) SetSpec(spec *rspec.Spec) { g.spec = spec } // Spec gets the spec in the Generator g. func (g *Generator) Spec() *rspec.Spec { return g.spec } // Save writes the spec into w. func (g *Generator) Save(w io.Writer) error { data, err := json.MarshalIndent(g.spec, "", "\t") if err != nil { return err } _, err = w.Write(data) if err != nil { return err } return nil } // SaveToFile writes the spec into a file. func (g *Generator) SaveToFile(path string) error { f, err := os.Create(path) if err != nil { return err } defer f.Close() return g.Save(f) } // SetVersion sets g.spec.Version. func (g *Generator) SetVersion(version string) { g.initSpec() g.spec.Version = version } // SetRootPath sets g.spec.Root.Path. func (g *Generator) SetRootPath(path string) { g.initSpec() g.spec.Root.Path = path } // SetRootReadonly sets g.spec.Root.Readonly. func (g *Generator) SetRootReadonly(b bool) { g.initSpec() g.spec.Root.Readonly = b } // SetHostname sets g.spec.Hostname. func (g *Generator) SetHostname(s string) { g.initSpec() g.spec.Hostname = s } // ClearAnnotations clears g.spec.Annotations. func (g *Generator) ClearAnnotations() { if g.spec == nil { return } g.spec.Annotations = make(map[string]string) } // AddAnnotation adds an annotation into g.spec.Annotations. func (g *Generator) AddAnnotation(key, value string) { g.initSpecAnnotations() g.spec.Annotations[key] = value } // RemoveAnnotation remove an annotation from g.spec.Annotations. func (g *Generator) RemoveAnnotation(key string) { if g.spec == nil || g.spec.Annotations == nil { return } delete(g.spec.Annotations, key) } // SetPlatformOS sets g.spec.Process.OS. func (g *Generator) SetPlatformOS(os string) { g.initSpec() g.spec.Platform.OS = os } // SetPlatformArch sets g.spec.Platform.Arch. func (g *Generator) SetPlatformArch(arch string) { g.initSpec() g.spec.Platform.Arch = arch } // SetProcessUID sets g.spec.Process.User.UID. func (g *Generator) SetProcessUID(uid uint32) { g.initSpec() g.spec.Process.User.UID = uid } // SetProcessGID sets g.spec.Process.User.GID. func (g *Generator) SetProcessGID(gid uint32) { g.initSpec() g.spec.Process.User.GID = gid } // SetProcessCwd sets g.spec.Process.Cwd. func (g *Generator) SetProcessCwd(cwd string) { g.initSpec() g.spec.Process.Cwd = cwd } // SetProcessNoNewPrivileges sets g.spec.Process.NoNewPrivileges. func (g *Generator) SetProcessNoNewPrivileges(b bool) { g.initSpec() g.spec.Process.NoNewPrivileges = b } // SetProcessTerminal sets g.spec.Process.Terminal. func (g *Generator) SetProcessTerminal(b bool) { g.initSpec() g.spec.Process.Terminal = b } // SetProcessApparmorProfile sets g.spec.Process.ApparmorProfile. func (g *Generator) SetProcessApparmorProfile(prof string) { g.initSpec() g.spec.Process.ApparmorProfile = prof } // SetProcessArgs sets g.spec.Process.Args. func (g *Generator) SetProcessArgs(args []string) { g.initSpec() g.spec.Process.Args = args } // ClearProcessEnv clears g.spec.Process.Env. func (g *Generator) ClearProcessEnv() { if g.spec == nil { return } g.spec.Process.Env = []string{} } // AddProcessEnv adds env into g.spec.Process.Env. func (g *Generator) AddProcessEnv(env string) { g.initSpec() g.spec.Process.Env = append(g.spec.Process.Env, env) } // ClearProcessAdditionalGids clear g.spec.Process.AdditionalGids. func (g *Generator) ClearProcessAdditionalGids() { if g.spec == nil { return } g.spec.Process.User.AdditionalGids = []uint32{} } // AddProcessAdditionalGid adds an additional gid into g.spec.Process.AdditionalGids. func (g *Generator) AddProcessAdditionalGid(gid uint32) { g.initSpec() for _, group := range g.spec.Process.User.AdditionalGids { if group == gid { return } } g.spec.Process.User.AdditionalGids = append(g.spec.Process.User.AdditionalGids, gid) } // SetProcessSelinuxLabel sets g.spec.Process.SelinuxLabel. func (g *Generator) SetProcessSelinuxLabel(label string) { g.initSpec() g.spec.Process.SelinuxLabel = label } // SetLinuxCgroupsPath sets g.spec.Linux.CgroupsPath. func (g *Generator) SetLinuxCgroupsPath(path string) { g.initSpecLinux() g.spec.Linux.CgroupsPath = strPtr(path) } // SetLinuxMountLabel sets g.spec.Linux.MountLabel. func (g *Generator) SetLinuxMountLabel(label string) { g.initSpecLinux() g.spec.Linux.MountLabel = label } // SetLinuxResourcesOOMScoreAdj sets g.spec.Linux.Resources.OOMScoreAdj. func (g *Generator) SetLinuxResourcesOOMScoreAdj(adj int) { g.initSpecLinuxResources() g.spec.Linux.Resources.OOMScoreAdj = &adj } // SetLinuxResourcesCPUShares sets g.spec.Linux.Resources.CPU.Shares. func (g *Generator) SetLinuxResourcesCPUShares(shares uint64) { g.initSpecLinuxResourcesCPU() g.spec.Linux.Resources.CPU.Shares = &shares } // SetLinuxResourcesCPUQuota sets g.spec.Linux.Resources.CPU.Quota. func (g *Generator) SetLinuxResourcesCPUQuota(quota uint64) { g.initSpecLinuxResourcesCPU() g.spec.Linux.Resources.CPU.Quota = "a } // SetLinuxResourcesCPUPeriod sets g.spec.Linux.Resources.CPU.Period. func (g *Generator) SetLinuxResourcesCPUPeriod(period uint64) { g.initSpecLinuxResourcesCPU() g.spec.Linux.Resources.CPU.Period = &period } // SetLinuxResourcesCPURealtimeRuntime sets g.spec.Linux.Resources.CPU.RealtimeRuntime. func (g *Generator) SetLinuxResourcesCPURealtimeRuntime(time uint64) { g.initSpecLinuxResourcesCPU() g.spec.Linux.Resources.CPU.RealtimeRuntime = &time } // SetLinuxResourcesCPURealtimePeriod sets g.spec.Linux.Resources.CPU.RealtimePeriod. func (g *Generator) SetLinuxResourcesCPURealtimePeriod(period uint64) { g.initSpecLinuxResourcesCPU() g.spec.Linux.Resources.CPU.RealtimePeriod = &period } // SetLinuxResourcesCPUCpus sets g.spec.Linux.Resources.CPU.Cpus. func (g *Generator) SetLinuxResourcesCPUCpus(cpus string) { g.initSpecLinuxResourcesCPU() g.spec.Linux.Resources.CPU.Cpus = &cpus } // SetLinuxResourcesCPUMems sets g.spec.Linux.Resources.CPU.Mems. func (g *Generator) SetLinuxResourcesCPUMems(mems string) { g.initSpecLinuxResourcesCPU() g.spec.Linux.Resources.CPU.Mems = &mems } // SetLinuxResourcesMemoryLimit sets g.spec.Linux.Resources.Memory.Limit. func (g *Generator) SetLinuxResourcesMemoryLimit(limit uint64) { g.initSpecLinuxResourcesMemory() g.spec.Linux.Resources.Memory.Limit = &limit } // SetLinuxResourcesMemoryReservation sets g.spec.Linux.Resources.Memory.Reservation. func (g *Generator) SetLinuxResourcesMemoryReservation(reservation uint64) { g.initSpecLinuxResourcesMemory() g.spec.Linux.Resources.Memory.Reservation = &reservation } // SetLinuxResourcesMemorySwap sets g.spec.Linux.Resources.Memory.Swap. func (g *Generator) SetLinuxResourcesMemorySwap(swap uint64) { g.initSpecLinuxResourcesMemory() g.spec.Linux.Resources.Memory.Swap = &swap } // SetLinuxResourcesMemoryKernel sets g.spec.Linux.Resources.Memory.Kernel. func (g *Generator) SetLinuxResourcesMemoryKernel(kernel uint64) { g.initSpecLinuxResourcesMemory() g.spec.Linux.Resources.Memory.Kernel = &kernel } // SetLinuxResourcesMemoryKernelTCP sets g.spec.Linux.Resources.Memory.KernelTCP. func (g *Generator) SetLinuxResourcesMemoryKernelTCP(kernelTCP uint64) { g.initSpecLinuxResourcesMemory() g.spec.Linux.Resources.Memory.KernelTCP = &kernelTCP } // SetLinuxResourcesMemorySwappiness sets g.spec.Linux.Resources.Memory.Swappiness. func (g *Generator) SetLinuxResourcesMemorySwappiness(swappiness uint64) { g.initSpecLinuxResourcesMemory() g.spec.Linux.Resources.Memory.Swappiness = &swappiness } // ClearLinuxSysctl clears g.spec.Linux.Sysctl. func (g *Generator) ClearLinuxSysctl() { if g.spec == nil || g.spec.Linux == nil { return } g.spec.Linux.Sysctl = make(map[string]string) } // AddLinuxSysctl adds a new sysctl config into g.spec.Linux.Sysctl. func (g *Generator) AddLinuxSysctl(key, value string) { g.initSpecLinuxSysctl() g.spec.Linux.Sysctl[key] = value } // RemoveLinuxSysctl removes a sysctl config from g.spec.Linux.Sysctl. func (g *Generator) RemoveLinuxSysctl(key string) { if g.spec == nil || g.spec.Linux == nil || g.spec.Linux.Sysctl == nil { return } delete(g.spec.Linux.Sysctl, key) } // SetLinuxSeccompDefault sets g.spec.Linux.Seccomp.DefaultAction. func (g *Generator) SetLinuxSeccompDefault(sdefault string) error { switch sdefault { case "": case "SCMP_ACT_KILL": case "SCMP_ACT_TRAP": case "SCMP_ACT_ERRNO": case "SCMP_ACT_TRACE": case "SCMP_ACT_ALLOW": default: return fmt.Errorf("seccomp-default must be empty or one of " + "SCMP_ACT_KILL|SCMP_ACT_TRAP|SCMP_ACT_ERRNO|SCMP_ACT_TRACE|" + "SCMP_ACT_ALLOW") } g.initSpecLinuxSeccomp() g.spec.Linux.Seccomp.DefaultAction = rspec.Action(sdefault) return nil } func checkSeccompArch(arch string) error { switch arch { case "": case "SCMP_ARCH_X86": case "SCMP_ARCH_X86_64": case "SCMP_ARCH_X32": case "SCMP_ARCH_ARM": case "SCMP_ARCH_AARCH64": case "SCMP_ARCH_MIPS": case "SCMP_ARCH_MIPS64": case "SCMP_ARCH_MIPS64N32": case "SCMP_ARCH_MIPSEL": case "SCMP_ARCH_MIPSEL64": case "SCMP_ARCH_MIPSEL64N32": default: return fmt.Errorf("seccomp-arch must be empty or one of " + "SCMP_ARCH_X86|SCMP_ARCH_X86_64|SCMP_ARCH_X32|SCMP_ARCH_ARM|" + "SCMP_ARCH_AARCH64SCMP_ARCH_MIPS|SCMP_ARCH_MIPS64|" + "SCMP_ARCH_MIPS64N32|SCMP_ARCH_MIPSEL|SCMP_ARCH_MIPSEL64|" + "SCMP_ARCH_MIPSEL64N32") } return nil } // ClearLinuxSeccompArch clears g.spec.Linux.Seccomp.Architectures. func (g *Generator) ClearLinuxSeccompArch() { if g.spec == nil || g.spec.Linux == nil || g.spec.Linux.Seccomp == nil { return } g.spec.Linux.Seccomp.Architectures = []rspec.Arch{} } // AddLinuxSeccompArch adds sArch into g.spec.Linux.Seccomp.Architectures. func (g *Generator) AddLinuxSeccompArch(sArch string) error { if err := checkSeccompArch(sArch); err != nil { return err } g.initSpecLinuxSeccomp() g.spec.Linux.Seccomp.Architectures = append(g.spec.Linux.Seccomp.Architectures, rspec.Arch(sArch)) return nil } // RemoveSeccompArch removes sArch from g.spec.Linux.Seccomp.Architectures. func (g *Generator) RemoveSeccompArch(sArch string) error { if err := checkSeccompArch(sArch); err != nil { return err } if g.spec == nil || g.spec.Linux == nil || g.spec.Linux.Seccomp == nil { return nil } for i, arch := range g.spec.Linux.Seccomp.Architectures { if string(arch) == sArch { g.spec.Linux.Seccomp.Architectures = append(g.spec.Linux.Seccomp.Architectures[:i], g.spec.Linux.Seccomp.Architectures[i+1:]...) return nil } } return nil } func checkSeccompSyscallAction(syscall string) error { switch syscall { case "": case "SCMP_ACT_KILL": case "SCMP_ACT_TRAP": case "SCMP_ACT_ERRNO": case "SCMP_ACT_TRACE": case "SCMP_ACT_ALLOW": default: return fmt.Errorf("seccomp-syscall action must be empty or " + "one of SCMP_ACT_KILL|SCMP_ACT_TRAP|SCMP_ACT_ERRNO|" + "SCMP_ACT_TRACE|SCMP_ACT_ALLOW") } return nil } func checkSeccompSyscallArg(arg string) error { switch arg { case "": case "SCMP_CMP_NE": case "SCMP_CMP_LT": case "SCMP_CMP_LE": case "SCMP_CMP_EQ": case "SCMP_CMP_GE": case "SCMP_CMP_GT": case "SCMP_CMP_MASKED_EQ": default: return fmt.Errorf("seccomp-syscall args must be " + "empty or one of SCMP_CMP_NE|SCMP_CMP_LT|" + "SCMP_CMP_LE|SCMP_CMP_EQ|SCMP_CMP_GE|" + "SCMP_CMP_GT|SCMP_CMP_MASKED_EQ") } return nil } func parseSeccompSyscall(s string) (rspec.Syscall, error) { syscall := strings.Split(s, ":") if len(syscall) != 3 { return rspec.Syscall{}, fmt.Errorf("seccomp sysctl must consist of 3 parameters") } name := syscall[0] if err := checkSeccompSyscallAction(syscall[1]); err != nil { return rspec.Syscall{}, err } action := rspec.Action(syscall[1]) var Args []rspec.Arg if strings.EqualFold(syscall[2], "") { Args = nil } else { argsslice := strings.Split(syscall[2], ",") for _, argsstru := range argsslice { args := strings.Split(argsstru, "/") if len(args) == 4 { index, err := strconv.Atoi(args[0]) value, err := strconv.Atoi(args[1]) value2, err := strconv.Atoi(args[2]) if err != nil { return rspec.Syscall{}, err } if err := checkSeccompSyscallArg(args[3]); err != nil { return rspec.Syscall{}, err } op := rspec.Operator(args[3]) Arg := rspec.Arg{ Index: uint(index), Value: uint64(value), ValueTwo: uint64(value2), Op: op, } Args = append(Args, Arg) } else { return rspec.Syscall{}, fmt.Errorf("seccomp-sysctl args error: %s", argsstru) } } } return rspec.Syscall{ Name: name, Action: action, Args: Args, }, nil } // ClearLinuxSeccompSyscall clears g.spec.Linux.Seccomp.Syscalls. func (g *Generator) ClearLinuxSeccompSyscall() { if g.spec == nil || g.spec.Linux == nil || g.spec.Linux.Seccomp == nil { return } g.spec.Linux.Seccomp.Syscalls = []rspec.Syscall{} } // AddLinuxSeccompSyscall adds sSyscall into g.spec.Linux.Seccomp.Syscalls. func (g *Generator) AddLinuxSeccompSyscall(sSyscall string) error { f, err := parseSeccompSyscall(sSyscall) if err != nil { return err } g.initSpecLinuxSeccomp() g.spec.Linux.Seccomp.Syscalls = append(g.spec.Linux.Seccomp.Syscalls, f) return nil } // AddLinuxSeccompSyscallAllow adds seccompAllow into g.spec.Linux.Seccomp.Syscalls. func (g *Generator) AddLinuxSeccompSyscallAllow(seccompAllow string) { syscall := rspec.Syscall{ Name: seccompAllow, Action: "SCMP_ACT_ALLOW", } g.initSpecLinuxSeccomp() g.spec.Linux.Seccomp.Syscalls = append(g.spec.Linux.Seccomp.Syscalls, syscall) } // AddLinuxSeccompSyscallErrno adds seccompErrno into g.spec.Linux.Seccomp.Syscalls. func (g *Generator) AddLinuxSeccompSyscallErrno(seccompErrno string) { syscall := rspec.Syscall{ Name: seccompErrno, Action: "SCMP_ACT_ERRNO", } g.initSpecLinuxSeccomp() g.spec.Linux.Seccomp.Syscalls = append(g.spec.Linux.Seccomp.Syscalls, syscall) } // RemoveSeccompSyscallByName removes all the seccomp syscalls with the given // name from g.spec.Linux.Seccomp.Syscalls. func (g *Generator) RemoveSeccompSyscallByName(name string) error { if g.spec == nil || g.spec.Linux == nil || g.spec.Linux.Seccomp == nil { return nil } var r []rspec.Syscall for _, syscall := range g.spec.Linux.Seccomp.Syscalls { if strings.Compare(name, syscall.Name) != 0 { r = append(r, syscall) } } g.spec.Linux.Seccomp.Syscalls = r return nil } // RemoveSeccompSyscallByAction removes all the seccomp syscalls with the given // action from g.spec.Linux.Seccomp.Syscalls. func (g *Generator) RemoveSeccompSyscallByAction(action string) error { if g.spec == nil || g.spec.Linux == nil || g.spec.Linux.Seccomp == nil { return nil } if err := checkSeccompSyscallAction(action); err != nil { return err } var r []rspec.Syscall for _, syscall := range g.spec.Linux.Seccomp.Syscalls { if strings.Compare(action, string(syscall.Action)) != 0 { r = append(r, syscall) } } g.spec.Linux.Seccomp.Syscalls = r return nil } // RemoveSeccompSyscall removes all the seccomp syscalls with the given // name and action from g.spec.Linux.Seccomp.Syscalls. func (g *Generator) RemoveSeccompSyscall(name string, action string) error { if g.spec == nil || g.spec.Linux == nil || g.spec.Linux.Seccomp == nil { return nil } if err := checkSeccompSyscallAction(action); err != nil { return err } var r []rspec.Syscall for _, syscall := range g.spec.Linux.Seccomp.Syscalls { if !(strings.Compare(name, syscall.Name) == 0 && strings.Compare(action, string(syscall.Action)) == 0) { r = append(r, syscall) } } g.spec.Linux.Seccomp.Syscalls = r return nil } // ClearLinuxUIDMappings clear g.spec.Linux.UIDMappings. func (g *Generator) ClearLinuxUIDMappings() { if g.spec == nil || g.spec.Linux == nil { return } g.spec.Linux.UIDMappings = []rspec.IDMapping{} } // AddLinuxUIDMapping adds uidMap into g.spec.Linux.UIDMappings. func (g *Generator) AddLinuxUIDMapping(hid, cid, size uint32) { idMapping := rspec.IDMapping{ HostID: hid, ContainerID: cid, Size: size, } g.initSpecLinux() g.spec.Linux.UIDMappings = append(g.spec.Linux.UIDMappings, idMapping) } // ClearLinuxGIDMappings clear g.spec.Linux.GIDMappings. func (g *Generator) ClearLinuxGIDMappings() { if g.spec == nil || g.spec.Linux == nil { return } g.spec.Linux.GIDMappings = []rspec.IDMapping{} } // AddLinuxGIDMapping adds gidMap into g.spec.Linux.GIDMappings. func (g *Generator) AddLinuxGIDMapping(hid, cid, size uint32) { idMapping := rspec.IDMapping{ HostID: hid, ContainerID: cid, Size: size, } g.initSpecLinux() g.spec.Linux.GIDMappings = append(g.spec.Linux.GIDMappings, idMapping) } // SetLinuxRootPropagation sets g.spec.Linux.RootfsPropagation. func (g *Generator) SetLinuxRootPropagation(rp string) error { switch rp { case "": case "private": case "rprivate": case "slave": case "rslave": case "shared": case "rshared": default: return fmt.Errorf("rootfs-propagation must be empty or one of private|rprivate|slave|rslave|shared|rshared") } g.initSpecLinux() g.spec.Linux.RootfsPropagation = rp return nil } // ClearPreStartHooks clear g.spec.Hooks.Prestart. func (g *Generator) ClearPreStartHooks() { if g.spec == nil { return } g.spec.Hooks.Prestart = []rspec.Hook{} } // AddPreStartHook add a prestart hook into g.spec.Hooks.Prestart. func (g *Generator) AddPreStartHook(path string, args []string) { g.initSpec() hook := rspec.Hook{Path: path, Args: args} g.spec.Hooks.Prestart = append(g.spec.Hooks.Prestart, hook) } // ClearPostStopHooks clear g.spec.Hooks.Poststop. func (g *Generator) ClearPostStopHooks() { if g.spec == nil { return } g.spec.Hooks.Poststop = []rspec.Hook{} } // AddPostStopHook adds a poststop hook into g.spec.Hooks.Poststop. func (g *Generator) AddPostStopHook(path string, args []string) { g.initSpec() hook := rspec.Hook{Path: path, Args: args} g.spec.Hooks.Poststop = append(g.spec.Hooks.Poststop, hook) } // ClearPostStartHooks clear g.spec.Hooks.Poststart. func (g *Generator) ClearPostStartHooks() { if g.spec == nil { return } g.spec.Hooks.Poststart = []rspec.Hook{} } // AddPostStartHook adds a poststart hook into g.spec.Hooks.Poststart. func (g *Generator) AddPostStartHook(path string, args []string) { g.initSpec() hook := rspec.Hook{Path: path, Args: args} g.spec.Hooks.Poststart = append(g.spec.Hooks.Poststart, hook) } // AddTmpfsMount adds a tmpfs mount into g.spec.Mounts. func (g *Generator) AddTmpfsMount(dest string, options []string) { mnt := rspec.Mount{ Destination: dest, Type: "tmpfs", Source: "tmpfs", Options: options, } g.initSpec() g.spec.Mounts = append(g.spec.Mounts, mnt) } // AddCgroupsMount adds a cgroup mount into g.spec.Mounts. func (g *Generator) AddCgroupsMount(mountCgroupOption string) error { switch mountCgroupOption { case "ro": case "rw": break case "no": return nil default: return fmt.Errorf("--mount-cgroups should be one of (ro,rw,no)") } mnt := rspec.Mount{ Destination: "/sys/fs/cgroup", Type: "cgroup", Source: "cgroup", Options: []string{"nosuid", "noexec", "nodev", "relatime", mountCgroupOption}, } g.initSpec() g.spec.Mounts = append(g.spec.Mounts, mnt) return nil } // AddBindMount adds a bind mount into g.spec.Mounts. func (g *Generator) AddBindMount(source, dest, options string) { if options == "" { options = "ro" } defaultOptions := []string{"bind"} mnt := rspec.Mount{ Destination: dest, Type: "bind", Source: source, Options: append(defaultOptions, options), } g.initSpec() g.spec.Mounts = append(g.spec.Mounts, mnt) } // SetupPrivileged sets up the priviledge-related fields inside g.spec. func (g *Generator) SetupPrivileged(privileged bool) { if privileged { // Add all capabilities in privileged mode. var finalCapList []string for _, cap := range capability.List() { if g.HostSpecific && cap > lastCap() { continue } finalCapList = append(finalCapList, fmt.Sprintf("CAP_%s", strings.ToUpper(cap.String()))) } g.initSpecLinux() g.spec.Process.Capabilities = finalCapList g.spec.Process.SelinuxLabel = "" g.spec.Process.ApparmorProfile = "" g.spec.Linux.Seccomp = nil } } func lastCap() capability.Cap { last := capability.CAP_LAST_CAP // hack for RHEL6 which has no /proc/sys/kernel/cap_last_cap if last == capability.Cap(63) { last = capability.CAP_BLOCK_SUSPEND } return last } func checkCap(c string, hostSpecific bool) error { isValid := false cp := strings.ToUpper(c) for _, cap := range capability.List() { if cp == strings.ToUpper(cap.String()) { if hostSpecific && cap > lastCap() { return fmt.Errorf("CAP_%s is not supported on the current host", cp) } isValid = true break } } if !isValid { return fmt.Errorf("Invalid value passed for adding capability") } return nil } // ClearProcessCapabilities clear g.spec.Process.Capabilities. func (g *Generator) ClearProcessCapabilities() { if g.spec == nil { return } g.spec.Process.Capabilities = []string{} } // AddProcessCapability adds a process capability into g.spec.Process.Capabilities. func (g *Generator) AddProcessCapability(c string) error { if err := checkCap(c, g.HostSpecific); err != nil { return err } cp := fmt.Sprintf("CAP_%s", strings.ToUpper(c)) g.initSpec() for _, cap := range g.spec.Process.Capabilities { if strings.ToUpper(cap) == cp { return nil } } g.spec.Process.Capabilities = append(g.spec.Process.Capabilities, cp) return nil } // DropProcessCapability drops a process capability from g.spec.Process.Capabilities. func (g *Generator) DropProcessCapability(c string) error { if err := checkCap(c, g.HostSpecific); err != nil { return err } cp := fmt.Sprintf("CAP_%s", strings.ToUpper(c)) g.initSpec() for i, cap := range g.spec.Process.Capabilities { if strings.ToUpper(cap) == cp { g.spec.Process.Capabilities = append(g.spec.Process.Capabilities[:i], g.spec.Process.Capabilities[i+1:]...) return nil } } return nil } func mapStrToNamespace(ns string, path string) (rspec.Namespace, error) { switch ns { case "network": return rspec.Namespace{Type: rspec.NetworkNamespace, Path: path}, nil case "pid": return rspec.Namespace{Type: rspec.PIDNamespace, Path: path}, nil case "mount": return rspec.Namespace{Type: rspec.MountNamespace, Path: path}, nil case "ipc": return rspec.Namespace{Type: rspec.IPCNamespace, Path: path}, nil case "uts": return rspec.Namespace{Type: rspec.UTSNamespace, Path: path}, nil case "user": return rspec.Namespace{Type: rspec.UserNamespace, Path: path}, nil case "cgroup": return rspec.Namespace{Type: rspec.CgroupNamespace, Path: path}, nil default: return rspec.Namespace{}, fmt.Errorf("Should not reach here!") } } // ClearLinuxNamespaces clear g.spec.Linux.Namespaces. func (g *Generator) ClearLinuxNamespaces() { if g.spec == nil || g.spec.Linux == nil { return } g.spec.Linux.Namespaces = []rspec.Namespace{} } // AddOrReplaceLinuxNamespace adds or replaces a namespace inside // g.spec.Linux.Namespaces. func (g *Generator) AddOrReplaceLinuxNamespace(ns string, path string) error { namespace, err := mapStrToNamespace(ns, path) if err != nil { return err } g.initSpecLinux() for i, ns := range g.spec.Linux.Namespaces { if ns.Type == namespace.Type { g.spec.Linux.Namespaces[i] = namespace return nil } } g.spec.Linux.Namespaces = append(g.spec.Linux.Namespaces, namespace) return nil } // RemoveLinuxNamespace removes a namespace from g.spec.Linux.Namespaces. func (g *Generator) RemoveLinuxNamespace(ns string) error { namespace, err := mapStrToNamespace(ns, "") if err != nil { return err } if g.spec == nil || g.spec.Linux == nil { return nil } for i, ns := range g.spec.Linux.Namespaces { if ns.Type == namespace.Type { g.spec.Linux.Namespaces = append(g.spec.Linux.Namespaces[:i], g.spec.Linux.Namespaces[i+1:]...) return nil } } return nil } // strPtr returns the pointer pointing to the string s. func strPtr(s string) *string { return &s } // FIXME: this function is not used. func parseArgs(args2parse string) ([]*rspec.Arg, error) { var Args []*rspec.Arg argstrslice := strings.Split(args2parse, ",") for _, argstr := range argstrslice { args := strings.Split(argstr, "/") if len(args) == 4 { index, err := strconv.Atoi(args[0]) value, err := strconv.Atoi(args[1]) value2, err := strconv.Atoi(args[2]) if err != nil { return nil, err } switch args[3] { case "": case "SCMP_CMP_NE": case "SCMP_CMP_LT": case "SCMP_CMP_LE": case "SCMP_CMP_EQ": case "SCMP_CMP_GE": case "SCMP_CMP_GT": case "SCMP_CMP_MASKED_EQ": default: return nil, fmt.Errorf("seccomp-sysctl args must be empty or one of SCMP_CMP_NE|SCMP_CMP_LT|SCMP_CMP_LE|SCMP_CMP_EQ|SCMP_CMP_GE|SCMP_CMP_GT|SCMP_CMP_MASKED_EQ") } op := rspec.Operator(args[3]) Arg := rspec.Arg{ Index: uint(index), Value: uint64(value), ValueTwo: uint64(value2), Op: op, } Args = append(Args, &Arg) } else { return nil, fmt.Errorf("seccomp-sysctl args error: %s", argstr) } } return Args, nil }