Контроль версий считается одним из ключевых инструментов в разработке программного обеспечения. Среди систем контроля версий одной из самых популярных является Git. А GitLab - это сервер управления репозиториями кода для Git, который может быть использован для размещения репозиториев и настройки инструментов для Git через простой веб-интерфейс.

Образ приложения GitLab в Vscale позволяет получить собственную систему управления репозиториями за несколько минут.

В этом руководстве рассмотрим в первом приближении GitLab и его основные возможности.

Структура образа

Сервер с предустановленным приложением GitLab версии 9.4.5 работает под управлением ОС Ubuntu 16.04. Для следования руководству дополнительного программного обеспечения не потребуется.

Создание сервера

Выберем образ с GitLab в панели управления:

Обратите внимание на то, что доступные конфигурации сервера начинаются от 2 ядер и 4 ГБ оперативной памяти. Это связано с минимально рекомендуемыми требованиями для работы Gitlab, при более слабой конфигурации возможны ошибки с кодом 500 и задержки в ответе сервера.

На финальном этапе подготовки образа сервера, рекомендуем сразу создать или добавить SSH-ключ:

После создания сервера Vscale выведет на экран учетные данные root пользователя приложения:

Вход в приложение

Перейдем в браузере по IP адресу скалета, который станет доступен в панели управления после завершения установки образа:

Используем полученные логин и пароль для учетной записи администратора и произведем вход в приложение:

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

Знакомство с основными возможностями GitLab

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

Прежде, чем мы сможем создать новую задачу, необходимо создать новый проект. Для этого выберем элемент управления New (знак плюса) и создадим новый проект:

Существует несколько вариантов создания нового проекта: импортирование из других систем (GitHub, BitBucket и другие), выбор шаблона или использование пустого проекта:

Создадим тестовый проект и познакомимся с новым меню:

Сразу доступна ссылка для доступа к репозиторию и основные функции:

раздел Issues - трекер задач;
раздел CI / CD - настройка и управление непрерывной интеграцией и доставкой;
разделы Merge Requests, Wiki и Snippets, для более удобной работы с системой контроля версий.

Рассмотрим подробнее трекер задач. Для этого откроем раздел Issues и выберем пункт Board:

Панель позволяет создать несколько тематических списков для организации задач. Добавим предлагаемые списки To Do и Doing и создадим новую задачу в списке To Do:

Перейдем по ссылке созданной задачи:

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

Теперь вернемся в раздел Board для изменения статуса задачи:

И перетащим нашу задачу в раздел Doing:

Изменение статуса задачи возможно также в окне управления задачей.

В целом, настройка и использование трекера GitLab достаточно интуитивна, также имеется значительное количество инструментов для эффективного управления задачами.

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

Добавление SSH-ключей в GitLab

Примечание. Для полноценной работы с GitLab требуется локальный Git клиент. Инструкции по его установке на основные операционные системы есть на официальном сайте.

Откроем терминал (или Git Bash для Windows) и проверим наличие уже существующих ключей в системе:

$ ls -al ~/.ssh

Если в списке есть id_rsa и id_rsa.pub, то следующий пункт можно пропустить.

Создадим приватный и публичный ключи, заменив e-mail адрес и оставив названия ключей по умолчанию (id_rsa и id_rsa.pub):

$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

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

Windows: /c/Users/username/.ssh/id_rsa.pub;
Mac OS: /Users/username/.ssh/id_rsa.pub;
Linux: /home/username/.ssh/id_rsa.pub.

Для примера получим содержимое файла в Ubuntu:

$ cat ~/.ssh/id_rsa.pub

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCpjmfj7diGruSbB0lls8YN80Om/RhxC7KuQeNeNteb2DKZCxoTkqDnRNLUiTr3XFgm5HguMGonOI8/5lI5NWdjAwTpe0eayn/Qo7s42md3KjWE2FCjfOMt94VCZV0+/v5ClMY4Vc6FuTIoQzIeflIKR1yt68R11bdeZuaaqfb8Llf2XjIBETPvgigI+rHaXHe2PFjij5dr2nIN3BAdu4pegsBt8Vyki63m7ib3PeoMzW8QyEvotbOOg5WAhs4b6fD6mM7iiV1N/GHD5jeSI1XHWZqPD8zIphIgy0wEv4oyy7Zak20TfvDnjfrQZ8xaTm3zT6Nki5Sxxdl223xRwFjX user@workstation

Создадим новый ключ в GitLab, для этого перейдем в раздел Settings:

Выберем пункт SSH Keys:

Добавим наш ключ:

Теперь мы можем публиковать и получать изменения в репозиториях через SSH с локальной машины.

Заключение

Мы рассмотрели основные возможности GitLab и начало работы с приложением. Следующим шагом рекомендуем обезопасить приложение посредством добавления SSL сертификата, что рассмотрено в статье “Настройка HTTPS в GitLab с помощью Let’s Encrypt”.

Более того, GitLab позволяет организовать непрерывную интеграцию и развертывание, что рассмотрено на примере Docker и Docker Swarm в статье “Непрерывная интеграция и развертывание на примере GitLab CI + Flask + Docker + Docker Swarm. Часть 1. Настройка среды”

Работа с образом GitLab в Vscale