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

Docker и GitHub: пошаговая настройка на Ubuntu 24.04

Связка Docker и GitHub нужна, чтобы запускать контейнеры из репозитория одной командой. На сервере с Ubuntu 24.04 вы клонируете проект, проверяете, что Docker установлен, и поднимаете сервисы через docker compose up -d. В конце проверяете, что контейнеры запущены и приложение отвечает.

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

01Проверьте, что Docker установлен

На сервере уже должен быть Docker с плагином Compose v2. Проверьте это одной командой. Если команда не найдена, установите Docker по отдельной инструкции, это займёт пару минут.

bash
docker --version && docker compose version

02Клонируйте репозиторий с GitHub

Скопируйте проект на сервер. Для публичного репозитория достаточно HTTPS. Для приватного используйте SSH-ключ или токен доступа, но не храните токен в истории команд.

bash
sudo apt install -y git
cd /var/www
git clone https://github.com/example/project.git example.com
cd /var/www/example.com

03Проверьте compose-файл

В каталоге проекта должен лежать compose.yaml или старый docker-compose.yml. Команда docker compose config проверит YAML и покажет итоговый конфиг. Если в файле ошибка отступов, вы увидите её здесь до запуска.

bash
docker compose config

04Запустите контейнеры

Соберите образы и поднимите сервисы в фоне. Флаг -d оставляет контейнеры работать после выхода из терминала. Если порт уже занят, Docker сообщит Bind for 0.0.0.0:80 failed: port is already allocated.

bash
docker compose up -d

05Посмотрите запущенные контейнеры

Команда docker compose ps покажет сервисы проекта, их состояние и опубликованные порты. Для отдельного контейнера вне Compose используйте docker ps. Если контейнер перезапускается, смотрите логи.

bash
docker compose ps
docker compose logs -f app

06Проверьте, что приложение отвечает

Откройте опубликованный порт в браузере или проверьте его с сервера. Если приложение слушает 80, запрос должен вернуть код 200. Для проверки изнутри контейнера войдите в него через docker compose exec app sh.

bash
curl -I http://203.0.113.10
sudo ss -ltnp | grep :80

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

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

    Добавьте пользователя в группу docker командой sudo usermod -aG docker $USER и войдите заново. Без повторного входа группа не применится.

  • Команда docker compose up -d пишет no configuration file provided: not found.

    Вы находитесь не в каталоге проекта или файл называется иначе. Перейдите в каталог с compose.yaml или укажите путь через -f.

  • Порт 80 занят, Docker пишет Bind for 0.0.0.0:80 failed: port is already allocated.

    Найдите процесс, который держит порт: sudo ss -ltnp. Остановите nginx на хосте или смените опубликованный порт в compose-файле.

  • В логах yaml: line 12: did not find expected key.

    Проверьте отступы и кавычки в compose.yaml около указанной строки. Отступы делайте пробелами, табуляция в YAML недопустима.

Deploykin

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

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

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

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

Как запустить проект с GitHub в Docker на Ubuntu 24.04?

Клонируйте репозиторий через git clone, перейдите в каталог проекта и выполните docker compose up -d. Предварительно проверьте, что установлены Docker и плагин Compose v2.

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

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

Как посмотреть запущенные контейнеры?

В каталоге проекта выполните docker compose ps, команда покажет сервисы и их состояние. Для всех контейнеров на сервере используйте docker ps.

Где Docker хранит данные контейнеров?

Именованные тома и слои образов лежат в /var/lib/docker. Тома переживают docker compose down, удаляет их только docker compose down -v.

Ещё по теме

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

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