Установка Gitlab на Ubuntu 22.04: пошаговая инструкция

Материал подготовлен командой Simple-Server для администраторов VPS и выделенных серверов. Команды и пути проверяйте на тестовой машине перед production.

Предварительные требования

Ниже приведен список требований, достаточных для**** установки GitLab на сервер.

Во-первых, понадобится сервер, расположенный либо на личном компьютере, либо в облаке. Исходя из документационных требований к GitLab, сервер должен быть снабжен:

1. Четырехъядерным процессором (нагрузка до 500 пользователей);
2. 4 ГБ оперативной памяти (нагрузка до 500 пользователей);
3. ОС Ubuntu 22.04.

Во-вторых, понадобится доменное имя, которое будет указывать на соответствующий сервер. В данной инструкции в качестве примера будет использоваться бесплатный домен от Simple-Server.

Шаг 1. Добавление необходимых зависимостей

Первым этапом будет установка необходимого для GitLab ПО. Скачать его можно из репозиториев Ubuntu.

Выполняем базовое обновление пакетов:

А после устанавливаем необходимые зависимости:

Есть вероятность, что часть ПО из списка уже была установлена на сервер ранее. Лучшим решением будет продублировать всю строку, указанную выше, и убедиться, что все успешно установлено.

Следующее, что нужно установить на сервер — это Postfix (или Sendmail), который служит механизмом отправки уведомлений на email:

Во время инсталляции программы в открывшемся окне необходимо выбрать «Интернет-сайт», как показано на рисунке ниже.

Далее указываем домен сервера — в нашем случае testgitlab.tw1.su.

Теперь можно начинать устанавливать GitLab. Загрузим необходимый скрипт:

Чтобы посмотреть и изучить работу данного скрипта, вводим команду:

Если вас всё устраивает, можно переходить непосредственно к запуску скрипта:

Как только скрипт завершит работу можно начинать установку GitLab:

Шаг 3. Настройка брандмауэра

Для начала необходимо проверить по каким протоколам разрешен трафик. Чтобы посмотреть статут брандмауэра, вводим команду:

Как видно по рисунку, в данный момент разрешен трафик только по протоколу SSH. Вдобавок к SSH, нужно разрешить трафик по протоколам HTTP и HTTPS из-за того, что приложение GitLab взаимодействует с интернетом.

После внесенных изменений снова посмотрим статут брандмауэра. Как видно по рисунку ниже, все изменения вступили в силу.

Шаг 4. Настройка файла конфигурации

Перед запуском GitLab важно отредактировать конфигурацию в файле gitlab.rb с помощью редактора nano:

В открывшемся файле находим строку продемонстрированную на картинке ниже и изменяем имя домена на testgitlab.tw1.su. У вас будет другое имя. Также сразу перейдем на более безопасный протокол шифрования — HTTPS.

После этого найдем следующую строку, также продемонстрированную на картинке ниже, и вставим в пустые скобки после знака равенства актуальный email. Это необходимо для отправки сообщения в случае возникновения проблем с доменом. Также не забываем, что нужно убрать комментирование перед этой строкой, чтобы все заработало.

Выполняем сохранение (CTRL+O) и выходим из файла (CTRL+X). Чтобы система внесла все изменения, запускаем реконфигурацию:

Запущенный процесс не только передаст всю необходимую информацию приложению о сервере, но и перенастроит Let’s Encrypt для указанного домена.

Шаг 5. Знакомство с GitLab в браузере

Вводим в строке браузера указанное ранее доменное имя. В нашем случае оно будет выглядеть так:

При первом входе открывается приветственная страница с возможностью указать пароль для учётной записи. После указания надежного пароля и его подтверждения произойдет перенаправление на окно аутентификации.

• Имя пользователя — root;
• Пароль — пароль, указанный ранее.

После входа в аккаунт откроется начальная страница, где пользователь может создать первый проект и приступить к работе.

У нового пользователя GitLab будут применены стандартные настройки пользователя. Чтобы их изменить, нужно перейти во вкладку «Settings», расположенном в правом верхнем углу окна в выпадающем меню.

В открывшимся разделе «Профиль» пользователь может изменить данные на актуальные.

Важными изменениями на этом этапе будут имя и адрес электронной почты. Первое будет отображаться для других участников проекта, а второе необходимо для получения уведомлений от сервиса. Чтобы новая почта привязалась, ее нужно подтвердить в полученном от сервиса письме.

Чтобы изменения вступили в силу, нужно нажать кнопку в самом низу экрана, как показано на картинке ниже.

Изменение имени пользователя

Переходим в раздел в меню настроек слева «Account». Здесь нужно изменить автоматически присвоенное имя на более уникальное, как показано на рисунке ниже. Это даст дополнительную безопасность аккаунту в случае попыток его взлома.

Также в этом разделе пользователь может добавить двухфакторную аутентификацию.

Для взаимодействия Git с GitLab необходимо сгенерировать и привязать публичный ключ в настройках.

Запускаем генерацию ключей:

Во время генерации система предложить указать адрес хранения пары ключей и пароль, чтобы обеспечить дополнительную защиту. Чтобы пропустить данные этапы, нужно нажать Enter.

По завершении генерации ключей, нужно скопировать публичный ключ и вставить его в соответствующем разделе, добавив краткое описание, как показано на рисунке ниже.

Открываем публичный ключ:

После копирования его в нужный раздел нажимаем кнопку «Add key».

Чтобы создать первый проект в GitLab, достаточно зайти на главную страницу и нажать на область, выделенную на картинке ниже.

Далее откроется форма создания проекта. Заполним такие данные, как название и тип репозитория. Репозиторий может быть публичным (Public), приватным (Private) или внутренним (Internal).

Если планируется добавлять файлы из уже существующего репозитория, то не нужно ставить галочку в поле «Initialize repository with a README». В ином случае сделать это нужно обязательно.

Далее нажимаем кнопку «Create repo» и создаем первый проект.

Теперь можно загрузить файлы проекта, добавить пользователей для совместной работы или удалить проект, если это необходимо.

Нужен сервер для практики? Закажите VPS на Simple-Server — root-доступ, NVMe, DDoS-защита и поддержка 24/7.