Введение
Вы можете быстро настроить свой собственный экземпляр GitLab, управлять своими репозиториями и пользоваться преимуществами его мощных функций, установив GitLab CE с помощью Docker. Мы проведем вас по шагам установки GitLab CE с Docker в Ubuntu 23.04, обеспечивая плавную установку и настройку. Мы также расскажем, как создать ваш первый проект в GitLab. GitLab — это хорошо известный веб-менеджер репозиториев Git, который предлагает полноценную платформу DevOps.
Необходимые требования
Прежде чем начать, убедитесь, что у вас есть следующее:
- Сервер Ubuntu 23.04.
- Системных ресурсов, включая дисковое пространство, оперативную память и центральный процессор, достаточно для запуска контейнеров GitLab CE и Docker.
Место на диске:
- GitLab CE: Выделите 10-20 ГБ дискового пространства для данных приложений и репозиториев GitLab. Эта область может варьироваться в зависимости от количества и размера проектов, которые вы собираетесь размещать.
- Docker: Убедитесь, что на диске достаточно места для образов и контейнеров Docker. Выделите для Docker не менее 20 ГБ свободного места.
ОЗУ:
- GitLab CE: для оптимальной производительности выделите не менее 4 ГБ оперативной памяти. Однако, если вы ожидаете интенсивного использования или большого количества одновременных пользователей, рассмотрите возможность выделения большего объема оперативной памяти для эффективной обработки нагрузки.
- Docker сам по себе не требует много памяти. Однако рекомендуется, чтобы у вас было доступно не менее 2 ГБ оперативной памяти для бесперебойной работы Docker. Имейте в виду, что чем больше контейнеров вы запускаете одновременно, тем больше памяти вам может потребоваться.
Процессор:
- Для GitLab CE требуется многоядерный процессор с тактовой частотой не менее 2 ГГц. Количество требуемых ядер процессора определяется ожидаемой нагрузкой и количеством одновременно работающих пользователей. GitLab может более эффективно обрабатывать параллельные запросы, поскольку у него несколько ядер.
- Docker разработан для эффективного использования доступных ресурсов ЦП. ЦП с несколькими ядрами или потоками выгоден, особенно если вы собираетесь запускать ресурсоемкие контейнеры или одновременно запускать большое количество контейнеров.
Шаг 1: Обновите индекс пакета
Для начала выполните следующие команды, чтобы обновить вашу систему Ubuntu:
sudo apt update
sudo apt upgrade -y
Важно отметить, что выполнение этих команд с правами администратора (sudo) обязательно, поскольку это позволяет системе выполнять необходимые операции для обновления пакетов.
Шаг 2: Установите Docker в Ubuntu 23.04
Если на вашем сервере еще не установлен Docker, выполните следующие действия:
a. Установить зависимости Docker:
sudo apt install apt-transport-https ca-certificates curl software-properties-common
б. Измените системный SSH-порт:
Gitlab использует SSH-порт по умолчанию, который конфликтует с SSH-портом системы. Для достижения наилучших результатов измените системный порт по умолчанию.
Чтобы изменить SSH-порт в вашей системе Ubuntu, вам необходимо изменить файл конфигурации SSH-сервера:
Используя текстовый редактор, измените файл конфигурации SSH-сервера. Вы можете использовать редактор nano, например, выполнив следующую команду:
sudo nano /etc/ssh/sshd_config
Найдите строку, указывающую SSH-порт в файле sshd_config. Обычно по умолчанию она закомментирована символом #, указывающим, что используется порт по умолчанию (port 22). Удалите символ # в начале строки, чтобы раскомментировать его, и измените номер порта по умолчанию (22) на желаемый номер порта. Выберите номер порта, который обычно не используется или не назначен другой службе. Например, вы можете использовать 2233.
Сохраните изменения и выйдите из текстового редактора. В nano вы можете сделать это, нажавCtrl + X
, затем Y
для подтверждения сохранения и Enter
для выхода. Перезапустите службу SSH, чтобы изменения вступили в силу. Используйте следующую команду:
sudo service ssh restart
c. Добавьте официальный GPG-ключ Docker:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
d. Добавьте репозиторий Docker:
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
e. Установить Docker:
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io
f. Проверьте установку Docker, выполнив:
sudo docker run hello-world

Шаг 3: Установите GitLab CE с помощью Docker:
Теперь давайте используем контейнеры Docker для установки GitLab CE:
a. Извлеките последний образ GitLab CE Docker:
sudo docker pull gitlab/gitlab-ce:latest

b. Создайте каталог для хранения конфигурации и данных GitLab:
sudo mkdir -p /srv/gitlab/config /srv/gitlab/logs /srv/gitlab/data
c. Запустите контейнер GitLab CE Docker:
sudo docker run --detach \
--hostname YOUR_SERVER_IP \
--publish 443:443 --publish 80:80 --publish 22:22 \
--name gitlab \
--restart always \
--volume /srv/gitlab/config:/etc/gitlab \
--volume /srv/gitlab/logs:/var/log/gitlab \
--volume /srv/gitlab/data:/var/opt/gitlab \
gitlab/gitlab-ce:latest

Замените YOUR_SERVER_IP
на IP-адрес вашего сервера или доменное имя.
Шаг 4: Настройте GitLab CE с помощью Docker
a. Установите новый пароль для вашего GitLab CE с помощью панели Docker
- Выполните следующую команду, чтобы получить доступ к оболочке контейнера GitLab:
sudo docker exec -it gitlab /bin/bash
- Оказавшись внутри оболочки контейнера, выполните следующую команду, чтобы сбросить пароль пользователя root:
gitlab-rake "gitlab:password:reset"
- Вам будет предложено ввести имя пользователя, для которого вы хотите сбросить пароль. Введите root в качестве имени пользователя и нажмите клавишу Enter.
- После этого вы должны получить подтверждение того, что сброс пароля прошел успешно.
- Введите exit и нажмите Enter, чтобы выйти из оболочки контейнера.

- Перезапустите Docker
sudo systemctl restart docker
b. Получите доступ к GitLab CE с помощью веб-интерфейса Docker
Откройте свой браузер и введите http://YOUR_SERVER_IP
или http://YOUR_DOMAIN_NAME
.
Шаг 5: Создание вашего первого проекта
Теперь, когда GitLab CE с docker установлен и настроен, давайте начнем работать над вашим первым проектом:
На домашней странице GitLab нажмите на кнопку “Создать проект”.

Выберите желаемый шаблон проекта

Заполните сведения о проекте, такие как название, описание и уровень видимости.

Вы будете перенаправлены на ваш новый проект, как только процесс импорта будет завершен.
