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

Установка GitLab в Docker на Ubuntu 24.04

GitLab можно запустить в контейнере Docker на одном сервере.

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

01Установите Docker и Docker Compose

На Ubuntu 24.04 Docker ставят из официального репозитория. Пакет docker-compose-plugin даёт команду docker compose через пробел, старый docker-compose не нужен. После установки добавьте пользователя в группу docker, чтобы работать без sudo.

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 $(. /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 сервера.

yaml
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.

bash
cd /var/www/example.com
docker compose config

04Запустите GitLab

Запустите контейнер в фоне командой docker compose up -d. Docker скачает образ и создаст именованные тома для конфигурации, логов и данных. Первый запуск GitLab занимает несколько минут, пока не создадутся база и файлы конфигурации.

bash
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 слушается.

bash
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 Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

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