Установка GitLab в Docker на Ubuntu 24.04
GitLab можно запустить в контейнере Docker на одном сервере.
01Установите Docker и Docker Compose
На Ubuntu 24.04 Docker ставят из официального репозитория. Пакет docker-compose-plugin даёт команду docker compose через пробел, старый docker-compose не нужен. После установки добавьте пользователя в группу docker, чтобы работать без sudo.
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 $(. /etc/os-release && echo $VERSION_CODENAME) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo usermod -aG docker $USER
02Создайте каталог и compose-файл
Создайте каталог /var/www/example.com и файл compose.yaml. В нём опишите сервис gitlab с образом gitlab/gitlab-ce:latest и публикацией портов. Ключ version: не нужен, в Compose v2 он устарел. Для доступа по SSH опубликуйте порт 22 на нестандартный порт хоста, например 2222, чтобы не конфликтовать с SSH сервера.
services:
gitlab:
image: gitlab/gitlab-ce:latest
container_name: gitlab
restart: always
hostname: gitlab.example.com
ports:
- "80:80"
- "443:443"
- "2222:22"
volumes:
- gitlab_config:/etc/gitlab
- gitlab_logs:/var/log/gitlab
- gitlab_data:/var/opt/gitlab
shm_size: "256m"
volumes:
gitlab_config:
gitlab_logs:
gitlab_data:
03Проверьте compose-файл
Перед запуском проверьте файл командой docker compose config. Она читает compose.yaml из текущего каталога, проверяет YAML и печатает итоговую конфигурацию. Ошибки отступов и кавычек видны сразу, например yaml: line 12: did not find expected key.
cd /var/www/example.com
docker compose config
04Запустите GitLab
Запустите контейнер в фоне командой docker compose up -d. Docker скачает образ и создаст именованные тома для конфигурации, логов и данных. Первый запуск GitLab занимает несколько минут, пока не создадутся база и файлы конфигурации.
cd /var/www/example.com
docker compose up -d
docker compose ps
05Проверьте работу GitLab
Откройте http://203.0.113.10 в браузере. GitLab попросит задать пароль администратора root. Если страница не открывается, посмотрите логи контейнера командой docker compose logs -f gitlab и проверьте, что порт 80 слушается.
docker compose ps
docker compose logs -f gitlab
sudo ss -ltnp
Частые ошибки
-
При запуске появляется
Bind for 0.0.0.0:80 failed: port is already allocated.Порт 80 на хосте уже занят nginx или другим контейнером. Найдите процесс командой
sudo ss -ltnpи остановите его или измените публикацию порта в compose-файле. -
Команда
docker composeвыдаёт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пишетno configuration file provided: not found.В текущем каталоге нет
compose.yamlилиdocker-compose.yml. Перейдите в каталог с файлом или укажите путь через-f. -
Контейнер завершается с кодом 137.
Процесс убит сигналом SIGKILL, чаще всего из-за нехватки памяти. Увеличьте память сервера или ограничьте потребление GitLab в
gitlab.rb.
Deploykin
Как это делается в Deploykin
В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Можно ли использовать docker-compose вместо docker compose?
Нет, Compose v1 не поддерживается с 2023 года. Используйте плагин docker-compose-plugin и команду docker compose через пробел.
Какой порт указать для SSH GitLab?
В compose-файле опубликуйте порт 22 контейнера на свободный порт хоста, например 2222:22. Тогда SSH сервера на порту 22 продолжит работать.
Где хранятся данные GitLab при использовании Docker?
В именованных томах gitlab_config, gitlab_logs и gitlab_data. Они переживают docker compose down, но удаляются командой docker compose down -v.
Как обновить GitLab в Docker?
Скачайте новый образ командой docker compose pull, затем перезапустите контейнер командой docker compose up -d. Перед обновлением сделайте резервную копию томов.
Ещё по теме
- Руководство · 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 Установка Docker Engine на Ubuntu 24.04 Установите Docker Engine и Compose v2 на Ubuntu 24.04 из официального репозитория: команды, настройка без sudo, проверка контейнером hello-world.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы