Как настроить персональный сервер Gitlab

Если вам нужен контроль версий для ваших проектов, вы хотите разместить его самостоятельно, но не хотите использовать базовый git, вы можете настроить сервер Gitlab для хранения всего вашего кода, предоставляя легкий доступ через веб-интерфейс.

Gitlab похож на ваш собственный хостинг Github

Gitlab — это размещенный сервис git, который работает так же, как Github, с интерактивной веб-панелью для управления вашими проектами и просмотра кода. Если вам просто нужна альтернатива Github, вы можете использовать их бесплатный онлайн-сервис, ничего не настраивая самостоятельно.

Однако, в отличие от Github, версия Gitlab для сообщества имеет открытый исходный код, и вы можете бесплатно разместить ее на собственном частном сервере. Нет ограничений по размеру проекта или количеству проектов, что делает это решение отличным для людей с большими двоичными файлами, которые слишком велики для ограничения файла Github в 100 МБ.

Очевидно, что это требует от вас оплаты сервера и места для хранения ваших файлов. Если у вас уже есть сервер, вы можете установить Gitlab вместе с другими процессами, но это довольно ресурсоемко — Gitlab рекомендует 4 ГБ ОЗУ, а в нашем тестировании использовалось около 2,8 ГБ. Меньше можно обойтись, но вы можете столкнуться с замедлением при отправке кода. Что касается использования ЦП, Gitlab оставался ниже примерно 10% в нашем тестировании при отправке и извлечении больших проектов.

Следует отметить, что если вы запускаете его самостоятельно, это не 100% резервная копия. Если ваш экземпляр будет закрыт, ваши данные могут быть потеряны. На самом деле git не следует использовать в качестве инструмента резервного копирования, хотя его можно использовать как таковой с такими сервисами, как Github.

Как установить Гитлаб

Во-первых, вам нужно убедиться, что установлены зависимости для HTTPS — openssh-server и ca-certificates. Скорее всего, они уже есть, но если это не так, вам нужно получить их из менеджера пакетов вашего дистрибутива. Для систем на основе Debian, таких как Ubuntu, это будет:

sudo apt-get install -y curl openssh-server ca-certificates

Вам также потребуется установить и настроить Postfix, чтобы Gitlab мог отправлять вам электронные письма:

sudo apt-get install -y postfix

Это необязательно, но приятно иметь.

Далее вам нужно добавить репозиторий Gitlab:

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash

Если у вас другой менеджер пакетов, чем apt, вам понадобится другой скрипт.

Затем вы можете установить Gitlab. Вам нужно будет передать свой внешний URL-адрес в качестве аргумента при запуске apt-get install. Рекомендуется поместить это в поддомен, такой как git.example.com, чтобы Gitlab не мешал ничему другому, что у вас запущено.

sudo EXTERNAL_URL="https://git.example.com" apt-get install gitlab-ee

Обязательно пометьте этот домен как HTTPS; Gitlab автоматически установит сертификаты LetsEncrypt и будет управлять ими бесплатно.

Установка займет несколько минут, но как только это будет сделано, вы вернетесь к стандартной подсказке с сообщением о том, что Gitlab установлен.

На этом этапе вы можете отключиться от SSH, так как остальная часть настройки будет в браузере. Перейдите по настроенному URL-адресу, и вы должны увидеть следующий экран приветствия. Эта страница должна обслуживаться через HTTPS с новым сертификатом для субдомена.

Введите новый мастер-пароль для корневой учетной записи Gitlab; обратите внимание, что это не пароль вашей учетной записи, вы создадите учетную запись после этого.

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

Вы захотите войти в учетную запись root и предоставить доступ администратора своей личной учетной записи. Имя пользователя будет root, а паролем будет мастер-пароль, который вы установили несколько секунд назад. Теперь вы должны увидеть значок гаечного ключа, ведущий к настройкам экземпляра Gitlab:

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

Отсюда у вас должен быть полный доступ к Gitlab. Если вы совместно работаете над кодом, вы можете создать новую группу и создать проект в этой группе (а не под своим именем пользователя).

Как только ваш проект создан, вы можете подключить его к своему локальному Git, как обычно. Обязательно добавьте свои SSH-ключи в настройки своей учетной записи, чтобы вы могли отправлять запросы без ввода пароля каждый раз.