Поиск по сайту:

Как использовать пользовательский интерфейс GitLab для управления проектами


Введение

GitLab — отличный способ управлять репозиториями git на централизованном сервере. Хотя такие решения, как GitHub, являются отличным вариантом для многих проектов, они подходят не для каждой команды. GitLab дает вам полный контроль над вашими репозиториями и позволяет вам бесплатно решать, являются ли они общедоступными или частными.

У DigitalOcean есть установочный образ GitLab одним щелчком мыши, который позволяет легко развернуть сервер GitLab на экземпляре VPS. Вы можете настроить GitLab на DigitalOcean здесь.

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

Как настроить свой профиль пользователя

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

Начните с нажатия кнопки «Настройки профиля» в правом верхнем углу:

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

Если вы также хотите изменить свое имя пользователя, щелкните вкладку «Учетная запись» вверху. Здесь вы можете настроить имя пользователя, под которым будут храниться ваши репозитории. У вас также будет доступ к вашему токену доступа:

Другой элемент, на который вы обязательно должны обратить внимание, — это вкладка «Ключи SSH». На этой вкладке нажмите кнопку «Добавить ключ SSH».

Здесь вы можете добавить ключ SSH, который вы будете использовать для связи с сервером через git. Для каждого пользователя можно добавить несколько ключей. Добавьте свой SSH-ключ и нажмите «Добавить ключ»:

Это также хорошая возможность изменить темы предварительного просмотра приложения и кода, если вы того пожелаете. Нажмите на вкладку «Дизайн». Вы можете выбрать одну из пяти тем приложения и четыре популярные темы предварительного просмотра кода:

Как управлять пользователями и группами

GitLab предоставляет инструменты для управления проектами, пользователями и группами с одного экрана. Получите к нему доступ, нажав кнопку \Панель администратора в правом верхнем углу:

Интерфейс разделен на шесть разделов: проекты, последние проекты, пользователи, последние пользователи, группы и статистика. Основными точками контакта, которые мы будем использовать, являются проекты, пользователи и группы.

Создать нового пользователя

В настоящее время существует только один пользователь и нет проектов групп. Давайте начнем с создания демонстрационного пользователя, которого мы сможем использовать позже. Нажмите кнопку «Новый пользователь» в средней колонке:

Нам нужно будет заполнить обычные контактные данные. Когда вы закончите, нажмите кнопку «Создать пользователя» внизу:

Вы попадете на страницу учетной записи нового пользователя. На адрес электронной почты учетной записи будет отправлено письмо с начальным паролем.

Создать новую группу

Теперь добавим новую группу. Снова нажмите кнопку «Административная область» в правом верхнем углу. Нажмите кнопку «Новая группа» в правом столбце:

Единственное, что вам нужно сделать, чтобы создать группу, это заполнить имя и описание. Нажмите кнопку «Создать группу»:

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

Найдите второе имя пользователя в поле «Добавить пользователя(ей) в группу:». Вам также нужно будет выбрать уровень доступа для пользователя. Для объяснения различных уровней разрешений, доступных в вашей GitLab, перейдите здесь:

<пред>

Это также доступно в виде ссылки в поле под \Подробнее о разрешениях проекта здесь.

На данный момент не имеет значения, какой уровень вы выберете. Нажмите «Добавить пользователей в группу», чтобы добавить их доступ:

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

Инициализировать проект

Теперь мы можем инициализировать проект. Вернитесь в панель администратора, нажав кнопку «Административная область», как и раньше. Нажмите кнопку «Новый проект» слева:

Вы также можете попасть в эту область, нажав кнопку «Новый проект» на верхней панели навигации:

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

Также возможно импортировать репозиторий с другого сайта. Вы можете щелкнуть ссылку «Импортировать существующий репозиторий», чтобы получить доступ к этой функции.

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

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

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

Управляйте проектами с GitLab

Мы добавим образец проекта в наш репозиторий GitLab, чтобы увидеть некоторые функции, доступные, когда у проекта есть история и много коммитов.

Пройдите процедуру создания нового проекта. Назовите его «Rails». На этот раз нажмите ссылку «Импортировать существующий репозиторий». Мы будем использовать учебный пример приложения Ruby on Rails Майкла Хартла.

В поле Импорт существующего репо введите:

https://github.com/mhartl/sample_app.git

Нажмите \Создать проект.

Посмотреть код проекта

Вы должны попасть на целевую страницу проекта. Нажмите на вкладку «Файлы», чтобы увидеть фактические файлы репозитория:

Нажмите на файл \Gemfile. Как видите, для распознаваемых языков включена отличная подсветка синтаксиса:

Если ваш проект имеет несколько ветвей, вы можете изменить представление ветвей, щелкнув раскрывающийся список мастеров и переключившись на другую ветвь:

Обзор коммитов

Нажмите на вкладку «Коммиты», чтобы увидеть список коммитов для текущей ветки:

Вы можете щелкнуть любую фиксацию, чтобы увидеть разницу, созданную фиксацией. Если вы хотите увидеть весь проект в любой момент фиксации, нажмите ссылку «Просмотреть код», связанную с этой фиксацией:

Чтобы увидеть разницу между двумя фиксациями, вы можете щелкнуть вкладку «Сравнить» вверху. Если мы введем имя одной из фиксаций в левом поле (в этом случае мы будем использовать e3c055dff), мы может получить полную разницу между ними:

Графическое представление вашего проекта

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

Во-первых, если вы нажмете на вкладку «Сеть», вы увидите дерево коммитов вашего проекта. Это позволяет вам видеть ветки, слияния и коммиты. Он также будет использовать изображение пользователя рядом с каждым коммитом, чтобы упростить идентификация:

Другой способ получить графическое изображение вашего проекта — использовать вкладку «Графики». Вы увидите большой график с отображением количества коммитов проекта в зависимости от времени. Под ним будет соответствующий график для каждого участника:

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

Заключение

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

Для большинства команд правильно настроенный GitLab будет более чем достаточным для работы с проектами. Он обеспечивает простое управление пользователем, а также легкое создание проектов и совместное использование. Изучите интерфейс, чтобы увидеть, может ли это быть простым решением для вашего проекта.

Джастин Эллингвуд