Подготовка к установке на Ubuntu

Важно

При работе с GPU обязательно установите драйвера и container runtime Nvidia

Совет

Для подготовки сервера на других платформах обратитесь к следующим ресурсам:

• Docker Engine
• Docker Compose

Установка Docker

Продукты Docker должны быть установлены как на CPU-, так и на GPU-серверах. Следуйте шагам ниже для установки:

1. Обновите индекс пакетов apt и установите пакеты, чтобы разрешить apt использовать репозиторий через HTTPS:

sudo apt-get update

sudo apt-get install \
  ca-certificates \
  curl \
  gnupg \
  lsb-release

Совет

При выполнении группы команд sudo apt-get install возможны следующие ошибки:

E: Could not get lock /var/lib/dpkg/lock-frontend - open (11: Resource temporarily unavailable)
E: Unable to acquire the dpkg frontend lock (/var/lib/dpkg/lock-frontend), is another process using it?

Существуют два способа их устранить:

1. Принудительно завершите все процессы apt-get, запущенные в данный момент в системе:
   

   sudo killall apt apt-get
   

2. Если предыдущая команда не помогла, выполните приведенный ниже набор команд. Если некоторые из подлежащих удалению каталогов не существуют, просто переходите к следующей команде:

   sudo rm /var/lib/apt/lists/lock
   sudo rm /var/cache/apt/archives/lock
   sudo rm /var/lib/dpkg/lock
   sudo rm /var/lib/dpkg/lock-frontend
   sudo dpkg --configure -a
   

2. Добавьте на сервер официальный ключ GPG для Docker (ключ GNU Privacy Guard):

sudo mkdir -m 0755 -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

3. Настройте репозиторий Docker:

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

4. Повторно обновите индекс пакетов apt:

sudo apt-get update

Совет

Если при выполнении этой команды возникает ошибка GPG, попробуйте предоставить разрешение на чтение для файла открытого ключа Docker перед обновлением индекса пакетов:

sudo chmod a+r /etc/apt/keyrings/docker.gpg
sudo apt-get update

5. Установите последние версии продуктов Docker:

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin

Примечание

Последними протестированными версиями docker-ce и docker-ce-cli являются версии 26.*. Использование более поздних версий пакетов Docker, при их наличии, остается на ваше усмотрение.

6. Проверьте успешность установки Docker. Следующая команда загружает тестовый образ и запускает его в контейнере:

sudo docker run hello-world

Когда контейнер запускается, он выводит подтверждающее сообщение и завершает работу:

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
2db29710123e: Pull complete
Digest: sha256:aa0cc8055b82dc2509bed2e19b275c8f463506616377219d9642221ab53cf9fe
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
   (amd64)
3. The Docker daemon created a new container from that image which runs the
   executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
   to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
$ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/

7. Установите docker-compose:

sudo curl -SL https://github.com/docker/compose/releases/download/v2.15.1/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

8. Выполните процедуры после установки Docker Engine, чтобы упростить дальнейшую работу с контейнерами Docker и NTechCity. После выполнения указанных команд вы сможете управлять Docker как обычный пользователь без прав администратора (root), и использование sudo в Docker-командах больше не потребуется:

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

9. Настройка container runtime. Выполняется только при работе с GPU.

sudo vi /etc/docker/daemon.json

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

10. Перезапустите Docker:

sudo systemctl restart docker

Известные проблемы

Если вы сталкиваетесь с проблемами извлечения Docker-образов, попробуйте использовать зеркала реестра (registry mirrors) для большей стабильности.

При установке продуктов Docker добавьте registry mirrors и настройте сеть Docker, как описано ниже.

Добавление registry mirrors

Чтобы добавить registry mirrors, выполните следующие действия:

1. После первого шага создайте файл /etc/docker/daemon.json и добавьте в конфигурацию параметр registry-mirrors:

sudo vi /etc/docker/daemon.json

{
  "registry-mirrors": [
    "https://mirror.gcr.io",
    "https://registry.docker-cn.com"
  ]
}

2. Перезапустите Docker:

sudo systemctl restart docker

Настройка сети Docker

Настраивается, если есть конфликт сети Docker с другой сетью на сервере. Пример настройки сети Docker:

BIP=10.$((RANDOM % 256)).$((RANDOM % 256))
sudo tee /etc/docker/daemon.json <<EOF
{
  "default-address-pools": [
    {"base":"$BIP.0/16","size":24}
  ],
  "bip": "$BIP.1/24",
  "fixed-cidr": "$BIP.0/24"
}
EOF

После того как вы внесли изменения в конфигурационный файл сервиса Docker для настройки сети, перезапустите Docker:

sudo systemctl restart docker

Пример конфигурации Docker

{
  "default-address-pools": [  // (1)!
    {"base":"10.170.67.0/16","size":24}
  ],
  "bip": "10.170.67.1/24",
  "fixed-cidr": "10.170.67.0/24",
  "runtimes": {  // (2)!
    "nvidia": {
      "path": "nvidia-container-runtime",
      "runtimeArgs": []
    }
  },
  "default-runtime": "nvidia",  // (3)!
  "registry-mirrors": [
    "https://mirror.gcr.io",
    "https://registry.docker-cn.com"
  ]
}

1. Настройки сети. Переопределяется, если на сервере есть конфликтующая по адресам сеть.
2. Настройки runtime. Необходимо указать при работе с GPU.
3. Runtime по умолчанию. Необходимо указать при работе с GPU.