| // Copyright 2018 Google LLC |
| // |
| // Licensed under the Apache License, Version 2.0 (the "License"); |
| // you may not use this file except in compliance with the License. |
| // You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, software |
| // distributed under the License is distributed on an "AS IS" BASIS, |
| // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| // See the License for the specific language governing permissions and |
| // limitations under the License. |
| |
| package main |
| |
| import ( |
| "context" |
| "encoding/json" |
| "flag" |
| "fmt" |
| "log" |
| "os" |
| "path/filepath" |
| "regexp" |
| "strings" |
| |
| "cos.googlesource.com/cos/tools.git/src/pkg/config" |
| "cos.googlesource.com/cos/tools.git/src/pkg/fs" |
| "cos.googlesource.com/cos/tools.git/src/pkg/provisioner" |
| |
| "cloud.google.com/go/storage" |
| "github.com/google/subcommands" |
| "google.golang.org/api/iterator" |
| ) |
| |
| var nvidiaDriverRegex = regexp.MustCompile("[0-9]+\\.[0-9]+(\\.[0-9]+)?") |
| |
| // InstallGPU implements subcommands.Command for the "install-gpu" command. |
| // This command configures the current image build process to customize the result image |
| // with GPU drivers. |
| type InstallGPU struct { |
| NvidiaDriverVersion string |
| NvidiaDriverMd5sum string |
| NvidiaInstallDirHost string |
| gpuType string |
| getValidDrivers bool |
| gpuDataDir string |
| installerContainer string |
| } |
| |
| // Name implements subcommands.Command.Name. |
| func (*InstallGPU) Name() string { |
| return "install-gpu" |
| } |
| |
| // Synopsis implements subcommands.Command.Synopsis. |
| func (*InstallGPU) Synopsis() string { |
| return "Configure the image build with GPU drivers." |
| } |
| |
| // Usage implements subcommands.Command.Usage. |
| func (*InstallGPU) Usage() string { |
| return `install-gpu [flags] |
| ` |
| } |
| |
| // SetFlags implements subcommands.Command.SetFlags. |
| func (i *InstallGPU) SetFlags(f *flag.FlagSet) { |
| f.StringVar(&i.NvidiaDriverVersion, "version", "", "Driver version to install. Can also be the local path of an nvidia installer; e.g., NVIDIA-Linux-x86_64-450.51.06.run.") |
| f.StringVar(&i.NvidiaDriverMd5sum, "md5sum", "", "Md5sum of the driver to install. Only checked when -version is set to an Nvidia driver version and a runfile is downloaded from Nvidia's website.") |
| f.StringVar(&i.NvidiaInstallDirHost, "install-dir", "/var/lib/nvidia", |
| "This flag is deprecated. Drivers are always installed in /var/lib/nvidia.") |
| f.StringVar( |
| &i.gpuType, "gpu-type", "nvidia-tesla-p100", "This flag is deprecated, please use the same flag in step 'finish-image-build'.") |
| f.BoolVar( |
| &i.getValidDrivers, "get-valid-drivers", false, |
| "Print the list of supported GPU driver versions. If this flag is given, no other actions will be taken.") |
| f.StringVar(&i.gpuDataDir, "deps-dir", "", "If provided, the local directory to search for cos-gpu-installer data dependencies. "+ |
| "The exact data dependencies that must be present in this directory depends on the version of cos-gpu-installer "+ |
| "used by cos-customizer. Do not expect this flag to be stable; it exists for compatibility with pre-release COS images.") |
| f.StringVar(&i.installerContainer, "installer-container", "", "This flag is deprecated, cos-gpu-installer-v1 is no longer used in cos-customizer.") |
| } |
| |
| func validDriverVersions(ctx context.Context, gcsClient *storage.Client) (map[string]bool, error) { |
| // We gather the set of valid drivers from the set of drivers provided by Nvidia in their GCS bucket. |
| // Nominally, paths we care about in this bucket look like 'tesla/<version>/<binaries>'. Version 390.46 has |
| // a deprecated path structure, and since it's supported by cos-gpu-installer, we special case that here. |
| validDrivers := map[string]bool{"390.46": true} |
| query := &storage.Query{Prefix: "tesla/"} |
| it := gcsClient.Bucket("nvidia-drivers-us-public").Objects(ctx, query) |
| for { |
| objAttrs, err := it.Next() |
| if err == iterator.Done { |
| break |
| } |
| if err != nil { |
| return nil, err |
| } |
| // Example object: tesla/396.26/NVIDIA-Linux-x86_64-396.26-diagnostic.run |
| if splitPath := strings.SplitN(objAttrs.Name, "/", 3); len(splitPath) > 1 { |
| validDrivers[splitPath[1]] = true |
| } |
| } |
| return validDrivers, nil |
| } |
| |
| func (i *InstallGPU) validate(ctx context.Context, gcsClient *storage.Client, files *fs.Files, provConfig *provisioner.Config) error { |
| if i.NvidiaDriverVersion == "" { |
| return fmt.Errorf("version must be set") |
| } |
| if !nvidiaDriverRegex.MatchString(i.NvidiaDriverVersion) && filepath.Ext(i.NvidiaDriverVersion) != ".run" { |
| return fmt.Errorf("version %q does not appear to be a valid driver version or a runfile", i.NvidiaDriverVersion) |
| } |
| var gpuAlreadyConf bool |
| for _, s := range provConfig.Steps { |
| if s.Type == "InstallGPU" { |
| gpuAlreadyConf = true |
| break |
| } |
| } |
| if gpuAlreadyConf { |
| return fmt.Errorf("install-gpu can only be invoked once in an image build process. Only one driver version can be installed on the image") |
| } |
| if i.NvidiaInstallDirHost != "/var/lib/nvidia" { |
| log.Println("WARNING: --install-dir is deprecated and no longer respected") |
| } |
| if i.installerContainer != "" { |
| log.Println("WARNING: --installer-container is deprecated and no longer respected") |
| } |
| return nil |
| } |
| |
| func (i *InstallGPU) updateBuildConfig(configPath string) error { |
| buildConfig := &config.Build{} |
| configFile, err := os.OpenFile(configPath, os.O_RDWR, 0666) |
| if err != nil { |
| return err |
| } |
| defer configFile.Close() |
| if err := config.Load(configFile, buildConfig); err != nil { |
| return err |
| } |
| buildConfig.GPUType = i.gpuType |
| version := i.NvidiaDriverVersion |
| if filepath.Ext(version) == ".run" { |
| version, err = filepath.Abs(version) |
| if err != nil { |
| return err |
| } |
| if _, err := os.Stat(version); os.IsNotExist(err) { |
| return fmt.Errorf("given runfile %q does not exist", version) |
| } |
| } |
| buildConfig.GPUConfig = &config.GPUConfig{ |
| Version: version, |
| MD5Sum: i.NvidiaDriverMd5sum, |
| } |
| if i.gpuDataDir != "" { |
| buildConfig.GPUConfig.PrePackagedDriversPath = filepath.Join(i.gpuDataDir, "prepackaged-drivers.tgz") |
| buildConfig.GPUConfig.VersionsProtoPath = filepath.Join(i.gpuDataDir, "gpu_driver_versions.bin") |
| buildConfig.Toolchain = &config.Toolchain{ |
| ToolchainTarPath: filepath.Join(i.gpuDataDir, "toolchain.tar.xz"), |
| KernelHeadersPath: filepath.Join(i.gpuDataDir, "kernel-headers.tgz"), |
| } |
| } |
| if _, err := configFile.Seek(0, 0); err != nil { |
| return err |
| } |
| return config.SaveConfigToFile(configFile, buildConfig) |
| } |
| |
| func (i *InstallGPU) updateProvConfig(provConfig *provisioner.Config) error { |
| // At this point, we don't know how to configure the InstallGPU step. |
| // Compilation happens in finish-image-build, and the step configuration is |
| // done there in the preloader package. We add an empty InstallGPU step here |
| // to signal intent to compile+install GPU drivers. |
| buf, err := json.Marshal(&provisioner.InstallGPUStep{}) |
| if err != nil { |
| return err |
| } |
| provConfig.Steps = append(provConfig.Steps, provisioner.StepConfig{ |
| Type: "InstallGPU", |
| Args: json.RawMessage(buf), |
| }) |
| return nil |
| } |
| |
| // Execute implements subcommands.Command.Execute. It configures the current image build process to |
| // customize the result image with GPU drivers. |
| func (i *InstallGPU) Execute(ctx context.Context, f *flag.FlagSet, args ...interface{}) subcommands.ExitStatus { |
| if f.NArg() != 0 { |
| f.Usage() |
| return subcommands.ExitUsageError |
| } |
| if len(args) < 2 { |
| log.Panic("InstallGPU expects two arguments; *fs.Files and ServiceClients") |
| } |
| files, ok := args[0].(*fs.Files) |
| if !ok { |
| log.Panic("InstallGPU expects two arguments; *fs.Files and ServiceClients") |
| } |
| serviceClients, ok := args[1].(ServiceClients) |
| if !ok { |
| log.Panic("InstallGPU expects two arguments; *fs.Files and ServiceClients") |
| } |
| _, gcsClient, err := serviceClients(ctx, false) |
| if err != nil { |
| log.Println(err) |
| return subcommands.ExitFailure |
| } |
| defer gcsClient.Close() |
| if i.getValidDrivers { |
| validDrivers, err := validDriverVersions(ctx, gcsClient) |
| if err != nil { |
| log.Println(err) |
| return subcommands.ExitFailure |
| } |
| var drivers []string |
| for d := range validDrivers { |
| drivers = append(drivers, d) |
| } |
| log.Printf("Valid driver versions are: %v\n", drivers) |
| return subcommands.ExitSuccess |
| } |
| var provConfig provisioner.Config |
| if err := config.LoadFromFile(files.ProvConfig, &provConfig); err != nil { |
| log.Println(err) |
| return subcommands.ExitFailure |
| } |
| if err := i.validate(ctx, gcsClient, files, &provConfig); err != nil { |
| log.Println(err) |
| return subcommands.ExitFailure |
| } |
| if err := i.updateBuildConfig(files.BuildConfig); err != nil { |
| log.Println(err) |
| return subcommands.ExitFailure |
| } |
| if err := i.updateProvConfig(&provConfig); err != nil { |
| log.Println(err) |
| return subcommands.ExitFailure |
| } |
| if err := config.SaveConfigToPath(files.ProvConfig, &provConfig); err != nil { |
| log.Println(err) |
| return subcommands.ExitFailure |
| } |
| return subcommands.ExitSuccess |
| } |
