Skip to content

Commit

Permalink
Merge pull request #529 from elezar/vulkan-location
Browse files Browse the repository at this point in the history
Support vulkan ICD files in a driver root
  • Loading branch information
elezar committed Jun 17, 2024
2 parents b5743da + 5f2be72 commit cd52be8
Show file tree
Hide file tree
Showing 4 changed files with 258 additions and 3 deletions.
22 changes: 19 additions & 3 deletions internal/discover/graphics.go
Original file line number Diff line number Diff line change
Expand Up @@ -65,9 +65,6 @@ func NewGraphicsMountsDiscoverer(logger logger.Interface, driver *root.Driver, n
driver.Root,
[]string{
"glvnd/egl_vendor.d/10_nvidia.json",
"vulkan/icd.d/nvidia_icd.json",
"vulkan/icd.d/nvidia_layers.json",
"vulkan/implicit_layer.d/nvidia_layers.json",
"egl/egl_external_platform.d/15_nvidia_gbm.json",
"egl/egl_external_platform.d/10_nvidia_wayland.json",
"nvidia/nvoptix.bin",
Expand All @@ -79,12 +76,31 @@ func NewGraphicsMountsDiscoverer(logger logger.Interface, driver *root.Driver, n
discover := Merge(
libraries,
jsonMounts,
newVulkanMountsDiscoverer(logger, driver),
xorg,
)

return discover, nil
}

// newVulkanMountsDiscoverer creates a discoverer for vulkan ICD files.
// For these files we search the standard driver config paths as well as the
// driver root itself. This allows us to support GKE installations where the
// vulkan ICD files are at {{ .driverRoot }}/vulkan instead of in /etc/vulkan.
func newVulkanMountsDiscoverer(logger logger.Interface, driver *root.Driver) Discover {
locator := lookup.First(driver.Configs(), driver.Files())
return &mountsToContainerPath{
logger: logger,
locator: locator,
required: []string{
"vulkan/icd.d/nvidia_icd.json",
"vulkan/icd.d/nvidia_layers.json",
"vulkan/implicit_layer.d/nvidia_layers.json",
},
containerRoot: "/etc",
}
}

type drmDevicesByPath struct {
None
logger logger.Interface
Expand Down
81 changes: 81 additions & 0 deletions internal/discover/mounts-to-container-path.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
/**
# Copyright 2024 NVIDIA CORPORATION
#
# 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 discover

import (
"fmt"
"path/filepath"
"strings"

"github.com/NVIDIA/nvidia-container-toolkit/internal/logger"
"github.com/NVIDIA/nvidia-container-toolkit/internal/lookup"
)

// mountsToContainerPath defines a Discoverer for a required set of mounts.
// When these are discovered by a locator the specified container root is used
// to construct the container path for the mount returned.
type mountsToContainerPath struct {
None
logger logger.Interface
locator lookup.Locator
required []string
containerRoot string
}

func (d *mountsToContainerPath) Mounts() ([]Mount, error) {
seen := make(map[string]bool)
var mounts []Mount
for _, target := range d.required {
if strings.Contains(target, "*") {
// TODO: We could relax this condition.
return nil, fmt.Errorf("wildcard patterns are not supported: %s", target)
}
candidates, err := d.locator.Locate(target)
if err != nil {
d.logger.Warningf("Could not locate %v: %v", target, err)
continue
}
if len(candidates) == 0 {
d.logger.Warningf("Missing %v", target)
continue
}
hostPath := candidates[0]
if seen[hostPath] {
d.logger.Debugf("Skipping duplicate mount %v", hostPath)
continue
}
seen[hostPath] = true
d.logger.Debugf("Located %v as %v", target, hostPath)

containerPath := filepath.Join(d.containerRoot, target)
d.logger.Infof("Selecting %v as %v", hostPath, containerPath)

mount := Mount{
HostPath: hostPath,
Path: containerPath,
Options: []string{
"ro",
"nosuid",
"nodev",
"bind",
},
}
mounts = append(mounts, mount)
}

return mounts, nil
}
148 changes: 148 additions & 0 deletions internal/discover/mounts-to-container-path_test.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,148 @@
/**
# Copyright 2024 NVIDIA CORPORATION
#
# 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 discover

import (
"errors"
"testing"

testlog "github.com/sirupsen/logrus/hooks/test"
"github.com/stretchr/testify/require"

"github.com/NVIDIA/nvidia-container-toolkit/internal/lookup"
)

func TestMountsToContainerPath(t *testing.T) {
logger, _ := testlog.NewNullLogger()
mountOptions := []string{
"ro",
"nosuid",
"nodev",
"bind",
}

testCases := []struct {
description string
required []string
locator lookup.Locator
containerRoot string
expectedMounts []Mount
expectedError error
}{
{
description: "containerRoot is prepended",
required: []string{"a/path/exists.txt", "another/path/exists.txt"},
locator: &lookup.LocatorMock{
LocateFunc: func(s string) ([]string, error) {
return []string{"/located/root/" + s}, nil
},
},
containerRoot: "/container",
expectedMounts: []Mount{
{
HostPath: "/located/root/a/path/exists.txt",
Path: "/container/a/path/exists.txt",
Options: mountOptions,
},
{
HostPath: "/located/root/another/path/exists.txt",
Path: "/container/another/path/exists.txt",
Options: mountOptions,
},
},
},
{
description: "duplicate mounts are skipped",
required: []string{"a/path/exists.txt", "another/path/exists.txt"},
locator: &lookup.LocatorMock{
LocateFunc: func(s string) ([]string, error) {
return []string{"/located/root/single.txt"}, nil
},
},
containerRoot: "/container",
expectedMounts: []Mount{
{
HostPath: "/located/root/single.txt",
Path: "/container/a/path/exists.txt",
Options: mountOptions,
},
},
},
{
description: "locator errors are ignored",
required: []string{"a/path/exists.txt"},
locator: &lookup.LocatorMock{
LocateFunc: func(s string) ([]string, error) {
return nil, errors.New("not found")
},
},
containerRoot: "/container",
expectedMounts: []Mount{},
},
{
description: "not located are ignored",
required: []string{"a/path/exists.txt"},
locator: &lookup.LocatorMock{
LocateFunc: func(s string) ([]string, error) {
return nil, nil
},
},
containerRoot: "/container",
expectedMounts: []Mount{},
},
{
description: "second candidate is ignored",
required: []string{"a/path/exists.txt"},
locator: &lookup.LocatorMock{
LocateFunc: func(s string) ([]string, error) {
return []string{"/located/root/" + s, "/located2/root/" + s}, nil
},
},
containerRoot: "/container",
expectedMounts: []Mount{
{
HostPath: "/located/root/a/path/exists.txt",
Path: "/container/a/path/exists.txt",
Options: mountOptions,
},
},
},
}

for _, tc := range testCases {
t.Run(tc.description, func(t *testing.T) {
d := mountsToContainerPath{
logger: logger,
locator: tc.locator,
required: tc.required,
containerRoot: tc.containerRoot,
}

devices, err := d.Devices()
require.NoError(t, err)
require.Empty(t, devices)

hooks, err := d.Hooks()
require.NoError(t, err)
require.Empty(t, hooks)

mounts, err := d.Mounts()
require.ErrorIs(t, err, tc.expectedError)
require.ElementsMatch(t, tc.expectedMounts, mounts)
})
}
}
10 changes: 10 additions & 0 deletions internal/lookup/root/root.go
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,16 @@ func New(opts ...Option) *Driver {
return d
}

// Files returns a Locator for arbitrary driver files.
func (r *Driver) Files(opts ...lookup.Option) lookup.Locator {
return lookup.NewFileLocator(
append(opts,
lookup.WithLogger(r.logger),
lookup.WithRoot(r.Root),
)...,
)
}

// Libraries returns a Locator for driver libraries.
func (r *Driver) Libraries() lookup.Locator {
return lookup.NewLibraryLocator(
Expand Down

0 comments on commit cd52be8

Please sign in to comment.