github.com/metacubex/gvisor@v0.0.0-20240320004321-933faba989ec/runsc/cmd/install.go (about) 1 // Copyright 2019 The gVisor Authors. 2 // 3 // Licensed under the Apache License, Version 2.0 (the "License"); 4 // you may not use this file except in compliance with the License. 5 // You may obtain a copy of the License at 6 // 7 // http://www.apache.org/licenses/LICENSE-2.0 8 // 9 // Unless required by applicable law or agreed to in writing, software 10 // distributed under the License is distributed on an "AS IS" BASIS, 11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 // See the License for the specific language governing permissions and 13 // limitations under the License. 14 15 package cmd 16 17 import ( 18 "context" 19 "encoding/json" 20 "fmt" 21 "io/ioutil" 22 "log" 23 "os" 24 "path" 25 "regexp" 26 27 "github.com/google/subcommands" 28 "github.com/metacubex/gvisor/pkg/sentry/platform" 29 "github.com/metacubex/gvisor/runsc/config" 30 "github.com/metacubex/gvisor/runsc/flag" 31 ) 32 33 // Install implements subcommands.Command. 34 type Install struct { 35 ConfigFile string 36 Runtime string 37 Experimental bool 38 Clobber bool 39 CgroupDriver string 40 executablePath string 41 runtimeArgs []string 42 } 43 44 // Name implements subcommands.Command.Name. 45 func (*Install) Name() string { 46 return "install" 47 } 48 49 // Synopsis implements subcommands.Command.Synopsis. 50 func (*Install) Synopsis() string { 51 return "adds a runtime to docker daemon configuration" 52 } 53 54 // Usage implements subcommands.Command.Usage. 55 func (*Install) Usage() string { 56 return `install [flags] <name> [-- [args...]] -- if provided, args are passed to the runtime 57 ` 58 } 59 60 // SetFlags implements subcommands.Command.SetFlags. 61 func (i *Install) SetFlags(fs *flag.FlagSet) { 62 fs.StringVar(&i.ConfigFile, "config_file", "/etc/docker/daemon.json", "path to Docker daemon config file") 63 fs.StringVar(&i.Runtime, "runtime", "runsc", "runtime name") 64 fs.BoolVar(&i.Experimental, "experimental", false, "enable/disable experimental features") 65 fs.BoolVar(&i.Clobber, "clobber", true, "clobber existing runtime configuration") 66 fs.StringVar(&i.CgroupDriver, "cgroupdriver", "", "docker cgroup driver") 67 } 68 69 // Execute implements subcommands.Command.Execute. 70 func (i *Install) Execute(_ context.Context, f *flag.FlagSet, _ ...any) subcommands.ExitStatus { 71 // Grab the name and arguments. 72 i.runtimeArgs = f.Args() 73 testFlags := flag.NewFlagSet("test", flag.ContinueOnError) 74 config.RegisterFlags(testFlags) 75 testFlags.Parse(i.runtimeArgs) 76 conf, err := config.NewFromFlags(testFlags) 77 if err != nil { 78 log.Fatalf("invalid runtime arguments: %v", err) 79 } 80 81 // Check the platform. 82 p, err := platform.Lookup(conf.Platform) 83 if err != nil { 84 log.Fatalf("invalid platform: %v", err) 85 } 86 deviceFile, err := p.OpenDevice(conf.PlatformDevicePath) 87 if err != nil { 88 log.Printf("WARNING: unable to open platform, runsc may fail to start: %v", err) 89 } 90 if deviceFile != nil { 91 deviceFile.Close() 92 } 93 94 // Extract the executable. 95 path, err := os.Executable() 96 if err != nil { 97 log.Fatalf("Error reading current exectuable: %v", err) 98 } 99 100 i.executablePath = path 101 102 installRW := configReaderWriter{ 103 read: defaultReadConfig, 104 write: defaultWriteConfig, 105 } 106 107 if err := doInstallConfig(i, installRW); err != nil { 108 log.Fatalf("Install failed: %v", err) 109 } 110 111 // Success. 112 log.Print("Successfully updated config.") 113 return subcommands.ExitSuccess 114 } 115 116 func doInstallConfig(i *Install, rw configReaderWriter) error { 117 // Load the configuration file. 118 configBytes, err := rw.read(i.ConfigFile) 119 if err != nil { 120 return fmt.Errorf("error reading config file %q: %v", i.ConfigFile, err) 121 } 122 // Unmarshal the configuration. 123 c := make(map[string]any) 124 if len(configBytes) > 0 { 125 if err := json.Unmarshal(configBytes, &c); err != nil { 126 return err 127 } 128 } 129 130 // Add the given runtime. 131 var rts map[string]any 132 if i, ok := c["runtimes"]; ok { 133 rts = i.(map[string]any) 134 } else { 135 rts = make(map[string]any) 136 c["runtimes"] = rts 137 } 138 updateRuntime := func() { 139 rts[i.Runtime] = struct { 140 Path string `json:"path,omitempty"` 141 RuntimeArgs []string `json:"runtimeArgs,omitempty"` 142 }{ 143 Path: i.executablePath, 144 RuntimeArgs: i.runtimeArgs, 145 } 146 } 147 _, ok := rts[i.Runtime] 148 switch { 149 case !ok: 150 log.Printf("Runtime %s not found: adding\n", i.Runtime) 151 updateRuntime() 152 case i.Clobber: 153 log.Printf("Clobber is set. Overwriting runtime %s not found: adding\n", i.Runtime) 154 updateRuntime() 155 default: 156 log.Printf("Not overwriting runtime %s\n", i.Runtime) 157 } 158 159 // Set experimental if required. 160 if i.Experimental { 161 c["experimental"] = true 162 } 163 164 re := regexp.MustCompile(`^native.cgroupdriver=`) 165 // Set the cgroupdriver if required. 166 if i.CgroupDriver != "" { 167 v, ok := c["exec-opts"] 168 if !ok { 169 c["exec-opts"] = []string{fmt.Sprintf("native.cgroupdriver=%s", i.CgroupDriver)} 170 } else { 171 opts := v.([]any) 172 newOpts := []any{} 173 for _, opt := range opts { 174 if !i.Clobber { 175 newOpts = opts 176 break 177 } 178 o, ok := opt.(string) 179 if !ok { 180 continue 181 } 182 183 if !re.MatchString(o) { 184 newOpts = append(newOpts, o) 185 } 186 } 187 c["exec-opts"] = append(newOpts, fmt.Sprintf("native.cgroupdriver=%s", i.CgroupDriver)) 188 } 189 } 190 191 // Write out the runtime. 192 if err := rw.write(c, i.ConfigFile); err != nil { 193 return fmt.Errorf("error writing config file %q: %v", i.ConfigFile, err) 194 } 195 return nil 196 } 197 198 // Uninstall implements subcommands.Command. 199 type Uninstall struct { 200 ConfigFile string 201 Runtime string 202 } 203 204 // Name implements subcommands.Command.Name. 205 func (*Uninstall) Name() string { 206 return "uninstall" 207 } 208 209 // Synopsis implements subcommands.Command.Synopsis. 210 func (*Uninstall) Synopsis() string { 211 return "removes a runtime from docker daemon configuration" 212 } 213 214 // Usage implements subcommands.Command.Usage. 215 func (*Uninstall) Usage() string { 216 return `uninstall [flags] <name> 217 ` 218 } 219 220 // SetFlags implements subcommands.Command.SetFlags. 221 func (u *Uninstall) SetFlags(fs *flag.FlagSet) { 222 fs.StringVar(&u.ConfigFile, "config_file", "/etc/docker/daemon.json", "path to Docker daemon config file") 223 fs.StringVar(&u.Runtime, "runtime", "runsc", "runtime name") 224 } 225 226 // Execute implements subcommands.Command.Execute. 227 func (u *Uninstall) Execute(context.Context, *flag.FlagSet, ...any) subcommands.ExitStatus { 228 log.Printf("Removing runtime %q from %q.", u.Runtime, u.ConfigFile) 229 if err := doUninstallConfig(u, configReaderWriter{ 230 read: defaultReadConfig, 231 write: defaultWriteConfig, 232 }); err != nil { 233 log.Fatalf("Uninstall failed: %v", err) 234 } 235 return subcommands.ExitSuccess 236 } 237 238 func doUninstallConfig(u *Uninstall, rw configReaderWriter) error { 239 configBytes, err := rw.read(u.ConfigFile) 240 if err != nil { 241 return fmt.Errorf("error reading config file %q: %v", u.ConfigFile, err) 242 } 243 244 // Unmarshal the configuration. 245 c := make(map[string]any) 246 if len(configBytes) > 0 { 247 if err := json.Unmarshal(configBytes, &c); err != nil { 248 return err 249 } 250 } 251 252 var rts map[string]any 253 if i, ok := c["runtimes"]; ok { 254 rts = i.(map[string]any) 255 } else { 256 return fmt.Errorf("runtime %q not found", u.Runtime) 257 } 258 if _, ok := rts[u.Runtime]; !ok { 259 return fmt.Errorf("runtime %q not found", u.Runtime) 260 } 261 delete(rts, u.Runtime) 262 263 if err := rw.write(c, u.ConfigFile); err != nil { 264 return fmt.Errorf("error writing config file %q: %v", u.ConfigFile, err) 265 } 266 return nil 267 } 268 269 type configReaderWriter struct { 270 read func(string) ([]byte, error) 271 write func(map[string]any, string) error 272 } 273 274 func defaultReadConfig(path string) ([]byte, error) { 275 // Read the configuration data. 276 configBytes, err := ioutil.ReadFile(path) 277 if err != nil && !os.IsNotExist(err) { 278 return nil, err 279 } 280 return configBytes, nil 281 } 282 283 func defaultWriteConfig(c map[string]any, filename string) error { 284 // Marshal the configuration. 285 b, err := json.MarshalIndent(c, "", " ") 286 if err != nil { 287 return err 288 } 289 290 // Copy the old configuration. 291 old, err := ioutil.ReadFile(filename) 292 if err != nil { 293 if !os.IsNotExist(err) { 294 return fmt.Errorf("error reading config file %q: %v", filename, err) 295 } 296 } else { 297 if err := ioutil.WriteFile(filename+"~", old, 0644); err != nil { 298 return fmt.Errorf("error backing up config file %q: %v", filename, err) 299 } 300 } 301 302 // Make the necessary directories. 303 if err := os.MkdirAll(path.Dir(filename), 0755); err != nil { 304 return fmt.Errorf("error creating config directory for %q: %v", filename, err) 305 } 306 307 // Write the new configuration. 308 if err := ioutil.WriteFile(filename, b, 0644); err != nil { 309 return fmt.Errorf("error writing config file %q: %v", filename, err) 310 } 311 312 return nil 313 }