К содержимому

Установка Docker и Docker Compose на Ubuntu 24.04

Docker ставится из официального репозитория Docker пакетами docker-ce и docker-compose-plugin. Compose v2 работает как плагин, команда пишется через пробел: docker compose. После установки вы запустите тестовый проект и проверите, что контейнеры видят друг друга по имени сервиса.

Руководство Docker 2 мин чтения

01Установите Docker из репозитория Docker

Удалите старые пакеты, если они есть, и поставьте зависимости для подключения репозитория по HTTPS. Затем добавьте ключ и репозиторий Docker для Ubuntu 24.04 (кодовое имя noble).

bash
sudo apt update
sudo apt install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu noble stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

02Установите пакеты Docker и плагин Compose

Пакет docker-compose-plugin даёт команду docker compose. Отдельный бинарник docker-compose из версии v1 не нужен и с 2023 года не поддерживается. Проверьте версии после установки.

bash
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version
docker compose version

03Разрешите запуск docker без sudo

Добавьте пользователя в группу docker и войдите заново, чтобы группа применилась. Членство в группе docker даёт права root на сервере, поэтому добавляйте только доверенных пользователей.

bash
sudo usermod -aG docker $USER
newgrp docker

04Создайте compose.yaml для тестового проекта

Создайте каталог проекта и файл compose.yaml. В Compose v2 ключ version: устарел и вызывает предупреждение, поэтому его не пишут. Сервис app обращается к базе по имени сервиса db, а не по localhost.

yaml
services:
  app:
    image: nginx:1.24
    ports:
      - "127.0.0.1:8080:80"
    depends_on:
      - db
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: example
      MYSQL_DATABASE: app
    volumes:
      - db_data:/var/lib/mysql
volumes:
  db_data:

05Проверьте конфигурацию и запустите проект

Команда docker compose config проверяет YAML и печатает итоговый конфиг, ошибки отступов видны сразу. Затем запустите сервисы в фоне и посмотрите их состояние.

bash
docker compose config
docker compose up -d
docker compose ps

06Проверьте работу контейнеров

Откройте опубликованный порт и загляните в логи. Из контейнера app база доступна как db:3306. Если порт 8080 занят, docker compose up -d завершится ошибкой Bind for 0.0.0.0:8080 failed: port is already allocated.

bash
curl -I http://127.0.0.1:8080
docker compose logs -f app
docker compose exec app sh -c 'getent hosts db'

Частые ошибки

  • При запуске docker появляется permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.

    Пользователь не в группе docker или не перелогинился после usermod. Выполните sudo usermod -aG docker $USER и войдите в систему заново.

  • docker compose up -d падает с ошибкой Bind for 0.0.0.0:80 failed: port is already allocated.

    Порт на хосте занят nginx самого сервера или другим контейнером. Найдите процесс командой sudo ss -ltnp и освободите порт или измените публикацию в compose.yaml.

  • docker compose пишет no configuration file provided: not found.

    В текущем каталоге нет compose.yaml или docker-compose.yml. Перейдите в каталог проекта или укажите путь через docker compose -f /path/to/compose.yaml up -d.

  • В контейнере не удаётся записать в смонтированный каталог: Permission denied.

    UID пользователя в контейнере не совпадает с владельцем каталога на хосте. Подберите владельца каталога под пользователя в образе, например для php на Debian это UID 33.

Deploykin

Как это делается в Deploykin

В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Чем отличается docker compose от docker-compose?

Docker Compose v2 это плагин, команда пишется через пробел: docker compose. Старый бинарник docker-compose версии v1 не поддерживается с 2023 года.

Нужно ли указывать version в compose.yaml?

Нет. В Compose v2 ключ version: устарел и вызывает только предупреждение. Файл по умолчанию называется compose.yaml, старое имя docker-compose.yml тоже читается.

Как обратиться к базе из другого контейнера?

По имени сервиса в сети проекта. Из контейнера app база db доступна как db:3306, а не как localhost.

Сохранятся ли данные после docker compose down?

Именованные тома переживают docker compose down. Удаляет их только docker compose down -v.

Что значит код выхода 137?

Процесс убит сигналом SIGKILL, чаще всего из-за нехватки памяти. Проверьте потребление памяти контейнером и лимиты на сервере.

Ещё по теме

Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.