Docker Installation

This installs the official Docker distrubution from the community edition repository.

CentOS

( originally from https://docs.docker.com/engine/installation/linux/centos/ )

Prerequisites

• Basic CentOS 7 Installation or Basic CentOS 8 Installation
• CUDA + NVIDIA drivers (if GPU is present)

Set up Docker-CE Repository

sudo yum install -y yum-utils device-mapper-persistent-data lvm2
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

Install containerd.io (CentOS 8 only)

RHEL/CentOS 8 replace the normal docker wiht podman/buildah, so we have to manually install the containerd.io runtime. Choose the latest version of the RPM from the CentOS 7 repo.

dnf install https://download.docker.com/linux/centos/7/x86_64/stable/Packages/containerd.io-1.2.10-3.2.el7.x86_64.rpm

Install Docker

sudo yum install -y docker-ce

Debian

( originally from https://docs.docker.com/engine/installation/linux/debian/ )

Prerequisites

• Basic Debian 10 Installation

Set up Docker-CE Repository

sudo apt-get install -y apt-transport-https ca-certificates curl gnupg2 software-properties-common
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
sudo apt-get update

Install Docker

sudo apt-get install -y docker-ce docker-ce-cli containerd.io

Finishing the Install

Make sure the docker daemon is running and set up to start automatically (should already be done by the package install):

sudo systemctl enable --now docker

Test installation

sudo docker run --rm hello-world
sudo docker image rm -f hello-world

Enable standard user access to docker commands (requires $USER to log out and back in to activate)

sudo groupadd docker
sudo usermod -aG docker $USER

In order to access the local repositories, we need to copy the certs into the local docker config

sudo scp -r aslan:/etc/docker/certs.d /etc/docker

Copy over the .docker directory from aslan for both root and user(s) to get login credentials

sudo scp -r aslan:.docker /root
scp -r aslan:.docker ~ 

GPU Nodes

On GPU-enabled nodes, install the nvidia runtime.

(originally from https://github.com/NVIDIA/nvidia-docker)

sudo yum-config-manager --add-repo https://nvidia.github.io/nvidia-docker/centos7/x86_64/nvidia-docker.repo
sudo yum install -y nvidia-docker2
sudo systemctl restart docker 

Test nvidia-smi with the latest official CUDA image

docker run --runtime=nvidia --rm nvidia/cuda nvidia-smi

Make the nvidia runtime default

• add entry to /etc/docker/daemon.json
• note that this gets reset when docker updates
• resulting daemon.json file looks like this:

{
    "runtimes": {
        "nvidia": {
            "path": "/usr/bin/nvidia-container-runtime",
            "runtimeArgs": []
        }
    },
    "default-runtime": "nvidia"
} 

... or copy from aslan

scp aslan:/etc/docker/daemon.json /etc/docker

Reload the configuration to enable the change

sudo systemctl restart docker

Test the GPU performance using a simple NVIDIA GPU Cloud container with the CUDA nbody sample program

docker run -it --rm nvcr.io/nvidia/k8s/cuda-sample:nbody nbody -benchmark -fp64