/** # Copyright (c) NVIDIA CORPORATION. All rights reserved. # # 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 image import ( "fmt" "strings" "github.com/opencontainers/runtime-spec/specs-go" ) type builder struct { CUDA disableRequire bool } // Option is a functional option for creating a CUDA image. type Option func(*builder) error // New creates a new CUDA image from the input options. func New(opt ...Option) (CUDA, error) { b := &builder{} for _, o := range opt { if err := o(b); err != nil { return CUDA{}, err } } if b.env == nil { b.env = make(map[string]string) } return b.build() } // build creates a CUDA image from the builder. func (b builder) build() (CUDA, error) { if b.disableRequire { b.env[EnvVarNvidiaDisableRequire] = "true" } return b.CUDA, nil } func WithAnnotationPrefixes(annotationPrefixes []string) Option { return func(b *builder) error { b.annotationPrefixes = annotationPrefixes return nil } } func WithAnnotations(annotations map[string]string) Option { return func(b *builder) error { b.annotations = annotations return nil } } func WithAcceptDeviceListAsVolumeMounts(acceptDeviceListAsVolumeMounts bool) Option { return func(b *builder) error { b.acceptDeviceListAsVolumeMounts = acceptDeviceListAsVolumeMounts return nil } } func WithAcceptEnvvarUnprivileged(acceptEnvvarUnprivileged bool) Option { return func(b *builder) error { b.acceptEnvvarUnprivileged = acceptEnvvarUnprivileged return nil } } // WithDisableRequire sets the disable require option. func WithDisableRequire(disableRequire bool) Option { return func(b *builder) error { b.disableRequire = disableRequire return nil } } // WithEnv sets the environment variables to use when creating the CUDA image. // Note that this also overwrites the values set with WithEnvMap. func WithEnv(env []string) Option { return func(b *builder) error { envmap := make(map[string]string) for _, e := range env { parts := strings.SplitN(e, "=", 2) if len(parts) != 2 { return fmt.Errorf("invalid environment variable: %v", e) } envmap[parts[0]] = parts[1] } return WithEnvMap(envmap)(b) } } // WithEnvMap sets the environment variable map to use when creating the CUDA image. // Note that this also overwrites the values set with WithEnv. func WithEnvMap(env map[string]string) Option { return func(b *builder) error { b.env = env return nil } } // WithMounts sets the mounts associated with the CUDA image. func WithMounts(mounts []specs.Mount) Option { return func(b *builder) error { b.mounts = mounts return nil } } // WithPrivileged sets whether an image is privileged or not. func WithPrivileged(isPrivileged bool) Option { return func(b *builder) error { b.isPrivileged = isPrivileged return nil } } // WithVisibleDevicesEnvVars sets the swarm resource for the CUDA image. func WithVisibleDevicesEnvVars(visibleDevicesEnvVars ...string) Option { return func(b *builder) error { if len(visibleDevicesEnvVars) == 0 { return fmt.Errorf("visible devices env vars cannot be empty") } b.visibleDevicesEnvVars = []string{} // if resource is a single string, split it by comma if len(visibleDevicesEnvVars) == 1 && strings.Contains(visibleDevicesEnvVars[0], ",") { candidates := strings.Split(visibleDevicesEnvVars[0], ",") for _, c := range candidates { trimmed := strings.TrimSpace(c) if len(trimmed) > 0 { b.visibleDevicesEnvVars = append(b.visibleDevicesEnvVars, trimmed) } } return nil } b.visibleDevicesEnvVars = append(b.visibleDevicesEnvVars, visibleDevicesEnvVars...) return nil } }