¶ Разница между группой и проектом
- Группы GitLab — это коллекция проектов с указанием того, как пользователи получают к ним доступ.
Каждая группа связана с пользователями, каждый из которых имеет уровень доступа к проектам группы и к самой группе. Он разнится от “Гостя” (“Guest”, только проблемы и чат) до “Владельца” (“Owner”, полный контроль над группой, её членами и проектами).
- Проект GitLab примерно соответствует одному git-репозиторию. Каждый проект принадлежит одному пространству имён, групповому или пользовательскому. Если проект принадлежит пользователю, владелец контролирует, кто имеет доступ к проекту; если проект принадлежит группе, действуют групповые уровни доступа для пользователей.
Каждый проект также имеет уровень видимости, который контролирует, кто имеет доступ на чтение страниц проекта или репозитория. Если проект Приватный (Private), владелец должен явно дать доступ на чтение отдельным пользователям. Внутренний (Internal) проект виден любому вошедшему пользователю GitLab, а Публичный (Public) проект видим всем.
¶ Участники
¶ Добавление участника
- Все участники проекта добавлены в группу автоматически. Если кого-то из участников не хватает, это значит, что он еще не заходил под своим аккаунтом в Git. После того, как он это сделает, спустя какое-то время, участник будет добавлен автоматически.
Актуальный список участников группы можно посмотреть на странице группы во вкладке "Members".
Для этого нажимаем на "Groups", далее на "Your groups":
Выбираем нужную вам группу:
В боковой панеле находим "Members":
Вот ваш список участников группы:
- Также участника можно добавить вручную через форму "Invite member" на странице группы. Для этого необходимо указать почту или имя участника и его роль, а затем нажать на кнопку "Invite".
Добавить участника в проект может человек только с ролью
"Maintainer".
¶ Как дать права "Maintainer" студенту
Создавать репозитории, добавлять участников и пушить в мастер ветку может только участник с правами "Maintainer".
Maintainer'ом по умолчанию назначается - руководитель проекта или направления.
Если есть необходимость в том, чтобы студент был назначен Maintainer'oм , то можно сделать это следующим образом:
Руководителю нужно зайти в список участников группы, расположенный на странице группы во вкладке "Members". Справа от имени каждого участника есть селектор с выбором роли. Руководитель проекта может самостоятельно дать кому-то из студентов права "Maintainer".
¶ Импортировать пользователей из другого проекта
Вы можете импортировать пользователей другого проекта в свой собственный проект, нажав кнопку «Import members» в правом верхнем углу меню «Members» .
В раскрывающемся меню вы можете увидеть только те проекты, в которых вы являетесь Maintainer .
Выберите тот, который вам нужен, и нажмите «Import project members» . Появится флэш-сообщение, уведомляющее вас об успешном импорте, и новые участники теперь находятся в списке участников проекта. Обратите внимание, что их разрешения на проект, из которого вы импортировали, сохраняются.
¶ Участие в проекте и запрос доступа
Владельцы проектов могут:
- Разрешить лицам, не являющимся участниками, запрашивать доступ к проекту.
- Запретить лицам, не являющимся участниками, запрашивать доступ.
Чтобы настроить это, перейдите в настройки проекта и нажмите "Allow users to request access".
Пользователи GitLab могут запросить членство в проекте. Перейдите к проекту, участником которого вы хотите стать, и нажмите кнопку "Request Access" в правой части экрана.
После запроса доступа:
- Maintainer проекта получают уведомление о запросе по электронной почте. Электронное письмо отправляется последним активным сопровождающим проекта.
- Любой Maintainer проекта может утвердить или отклонить запрос на странице участников.
Если у проекта нет Maintainer, уведомление отправляется последним активным владельцам группы проекта.
Управление запросами на доступ
Если вы передумаете до того, как ваш запрос будет одобрен, просто нажмите кнопку «Withdraw Access Request».
¶ Удалить участника из проекта
Только пользователи с разрешениями Owner могут управлять участниками проекта.
Вы можете удалить пользователя из проекта, если данный участник имеет прямое членство в проекте. Если членство унаследовано от родительской группы, то член может быть удален только из самой родительской группы.
При удалении участника вы можете решить, отменить ли пользователю все задачи и запросы на слияние, которые ему назначены в настоящее время, или оставить назначения без изменений.
-
Отмена назначения удаленного участника из всех задач и запросов на слияние может быть полезна, когда пользователь покидает частный проект (Private, владелец должен явно дать доступ на чтение отдельным пользователям) и вы хотите отозвать его доступ к любым задачам и запросам на слияние, которые им назначены.
-
Сохранение назначенных задач и запросов на слияние может быть полезно для проектов, которые принимают публичные(Public, проект видим всем) вклады, где пользователь не должен быть участником, чтобы иметь возможность вносить свой вклад в проблемы и запросы на слияние.
Чтобы удалить участника из проекта:
- В проекте перейдите к "Members" .
- Нажмите кнопку "Delete" рядом с участником проекта, которого хотите удалить.
- (Необязательно) Установите флажок "также отменить назначение этого пользователя для связанных проблем и запросов на слияние".
- Щелкните "Remove member".
¶ Различия прав доступа
Пользователи имеют разные возможности в зависимости от уровня доступа, который они имеют в конкретной группе или проекте. Если пользователь входит и в группу проекта, и в сам проект, используется самый высокий уровень разрешений.
В публичных(Public, проект видим всем) и внутренних(Internal, проект виден любому вошедшему пользователю GitLab), проектах роль гостя не применяется.
Все пользователи могут:
- Создавать задачи.
- Оставлять комментарии.
- Клонировать или скачивать код проекта.
Когда участник покидает проект группы, все назначенные задачи и запросы на слияние (подробней про слияние - основные понятия) автоматически отменяются.
¶ Роли
Существуют следующие роли в проекте/группе:
- Guest - Гость
- Reporter - Репортер
- Developer - Разработчик
- Maintainer - Сопровождающий
- Owner - Владелец
Перейдя по следующим ссылкам можно узнать про:
- различные уровни разрешений пользователей в проекте
- различные уровни разрешений пользователей в группе
¶ Внешние пользователи
В случаях, когда желательно, чтобы пользователь имел доступ только к некоторым внутренним или частным проектам, существует возможность создания внешних пользователей .
Внешние пользователи:
- Невозможно создавать группы, проекты или личные фрагменты.
- Может получать доступ только к публичным проектам и проектам, к которым им явно предоставлен доступ, таким образом скрывая от них все остальные внутренние или частные (например, выход из системы).
Доступ может быть предоставлен путем добавления пользователя в качестве участника проекта или группы. Как и обычные пользователи, они получают роль в проекте или группе со всеми возможностями, указанными в таблице разрешений. Например, если внешний пользователь добавлен в качестве гостя, а ваш проект является внутренним или частным, у них нет доступа к коду; вам необходимо предоставить внешним пользователям доступ на уровне Reporter или выше, если вы хотите, чтобы они имели доступ к коду. Вы всегда должны учитывать настройки видимости и разрешений проекта, а также уровень разрешений пользователя.
Администратор может пометить пользователя как внешнего любым из следующих способов:
- Либо через API.
- Или перейдя в Admin Area -> Overview -> Users, чтобы создать нового пользователя или отредактировать существующего. Там вы можете найти возможность пометить пользователя как внешнего.
Грубо говоря, внешние пользователи = гости, которые имеют доступ к определённым проектам, который им кто-то выдал. Другие внутренние проекты они не видят, создавать проекты не могут и т.д.
Кроме внутренних, к которым им дали доступ, видят ещё полностью публичные проекты, которые также видят гости.
¶ Отслеживание активности
С помощью Contribution Analytics у вас есть обзор вкладов (push-уведомлений , запросов на слияние и проблем), выполненных членами вашей группы.
Вы можете получить обзор следующих действий в вашей группе:
- Задачи
- Запросы на слияние
- Push-события
Чтобы просмотреть Contribution Analytics, перейдите на страницу вашей группы Analytics -> Contribution Analytics.
¶ Случаи применения
- Проанализируйте вклад вашей команды за определенный период времени и предложите бонус лучшим участникам.
- Определите возможности для улучшения работы с членами группы, которым может быть полезна дополнительная поддержка.
¶ Использование Contribution Analytics
Есть три основных столбчатых диаграммы, которые показывают количество вкладов на одного члена группы для следующего:
- Push-события
- Запросы на слияние
- Закрытые задачи
Наведите указатель мыши на каждую полосу, чтобы отобразить количество событий для определенного члена группы.
¶ Изменение периода времени
Вы можете выбрать один из следующих трех периодов:
- Прошлая неделя (по умолчанию)
- Прошлый месяц
- Последние три месяца
Выберите желаемый период из выпадающего списка календаря.
¶ Сортировка по разным факторам
Взносы каждого члена группы также представлены в табличном формате. Щелкните заголовок столбца, чтобы отсортировать таблицу по этому столбцу:
- Name
- Pushed
- Opened issues
- Closed issues
- Opended MRs
- Merged MRs
- Nonal Contributions
¶ Статистика конкретного пользователя
Для того, чтобы посмотреть статистику определенного пользователя нужно сделать следующие действия:
- Зайти на профиль нужного вам пользователя.
- Далее нажать на "Activity":
Перед вами список активности участника. Теперь вы можете увидеть, какое было сделано действе, когда и в каком проекте оно было сделано.