Docker и GitHub: пошаговая настройка на Ubuntu 24.04
Связка Docker и GitHub нужна, чтобы запускать контейнеры из репозитория одной командой. На сервере с Ubuntu 24.04 вы клонируете проект, проверяете, что Docker установлен, и поднимаете сервисы через docker compose up -d. В конце проверяете, что контейнеры запущены и приложение отвечает.
01Проверьте, что Docker установлен
На сервере уже должен быть Docker с плагином Compose v2. Проверьте это одной командой. Если команда не найдена, установите Docker по отдельной инструкции, это займёт пару минут.
docker --version && docker compose version
02Клонируйте репозиторий с GitHub
Скопируйте проект на сервер. Для публичного репозитория достаточно HTTPS. Для приватного используйте SSH-ключ или токен доступа, но не храните токен в истории команд.
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 и покажет итоговый конфиг. Если в файле ошибка отступов, вы увидите её здесь до запуска.
docker compose config
04Запустите контейнеры
Соберите образы и поднимите сервисы в фоне. Флаг -d оставляет контейнеры работать после выхода из терминала. Если порт уже занят, Docker сообщит Bind for 0.0.0.0:80 failed: port is already allocated.
docker compose up -d
05Посмотрите запущенные контейнеры
Команда docker compose ps покажет сервисы проекта, их состояние и опубликованные порты. Для отдельного контейнера вне Compose используйте docker ps. Если контейнер перезапускается, смотрите логи.
docker compose ps
docker compose logs -f app
06Проверьте, что приложение отвечает
Откройте опубликованный порт в браузере или проверьте его с сервера. Если приложение слушает 80, запрос должен вернуть код 200. Для проверки изнутри контейнера войдите в него через docker compose exec app sh.
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 docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
- Руководство · Docker Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы