nvidia-container-toolkit/DEVELOPMENT.md

NVIDIA Container Toolkit Release Tooling

This repository allows for the components of the NVIDIA container stack to be built and released as the NVIDIA Container Toolkit from a single repository. The components:

• libnvidia-container
• nvidia-container-runtime
• nvidia-docker are included as submodules in the third_party folder.

The nvidia-container-toolkit resides in this repo directly.

Building

In oder to build the packages, the following command is executed

./scripts/build-all-components.sh TARGET

where TARGET is a make target that is valid for each of the sub-components.

These include:

• ubuntu18.04-amd64
• docker-all with the later generating for all supported distribution and platform combinations.

The packages are generated in the dist folder.

Testing local changes

In oder to use the same build logic to be used to generate packages with local changes, the location of the individual components can be overridded using the: LIBNVIDIA_CONTAINER_ROOT, NVIDIA_CONTAINER_TOOLKIT_ROOT, NVIDIA_CONTAINER_RUNTIME_ROOT, and NVIDIA_DOCKER_ROOT environment variables.

Testing packages locally

Ubuntu

Launch a docker container:

docker run --rm -it \
    -v $(pwd):/work \
    -v $(pwd)/dist/ubuntu18.04/amd64:/local-repository \
    -w /work \
        ubuntu:18.04

apt-get update && apt-get install -y apt-utils

echo "deb [trusted=yes] file:/local-repository/ ./" > /etc/apt/sources.list.d/local.list

cd /local-repository && apt-ftparchive packages . > Packages

apt-get update

Centos

docker run --rm -it \
    -v $(pwd):/work \
    -v $(pwd)/dist/centos8/x86_64:/local-repository \
    -w /work \
        centos:8

yum install -y createrepo

createrepo /local-repository

cat >/etc/yum.repos.d/local.repo <<EOL
[local]
name=NVIDIA Container Toolkit Local Packages
baseurl=file:///local-repository
enabled=1
gpgcheck=0
protect=1
EOL