Руководство оператора#
Доступ к приложению#
Для получения учетных данных и адреса для входа необходимо обратиться к куратору вашей организации или администратору. При переходе по полученной ссылке измените свой пароль, после чего отобразится страница авторизации:
Возможны два варианта входа в приложение:
С помощью логина и пароля в SourceControl. Для этого введите свои данные в соответствующие поля в основной форме входа.
С помощью логина и пароля Openid Connect (Keyсloak). Для этого нажмите на кнопку Openid Connect под формой ввода УЗ и в открывшемся окне введите данные из Keycloak.
Для работы с сервисом можно использовать следующие браузеры:
Яндекс (19.10+) – рекомендовано
Google Chrome (79.0+) – опционально
Safari (10.12+) – опционально
Рекомендации для пользователей по выбору паролей:
Не используйте такие же пароли, как на других сайтах, или аналогичные им.
Не используйте в качестве пароля одно слово, например, password, или частые фразы, например, qwerty.
Используйте пароли, которые будет сложно угадать даже тем, кто хорошо вас знает. Не включайте в них имена и дни рождения своих родных и друзей, названия любимых групп или фразы, которые вы часто произносите.
Рекомендуется выполнять процедуру периодической смены своего пароля.
Приведенные рекомендации не должны противоречить требованиям внутренних документов Заказчика, отраслевых и национальных стандартов, требований уполномоченных регуляторов и законодательства РФ.
Использование приложения оператором#
Все сценарии ниже доступны пользователям с ролями Reporter, Developer, Maintainer, Owner, если не указано иное.
Подробная ролевая модель описана в разделе Авторизация Руководства по безопасности.
Запросы на слияние#
Запросы на слияние — это основной метод внесения изменений в файлы в проекте GitLab. При проверке кода команда оставляет комментарии к вашему запросу на слияние и предлагает варианты реализации.
Когда ваш запрос проверяется, члены вашей команды могут принять или отклонить его.
Назначение рецензентов#
Чтобы назначить рецензентов кода, выполните следующие действия:
Авторизуйтесь и создайте запрос на слияние.
Заполните необходимые поля и в поле Reviewers выберите рецензентов из выпадающего списка или через поиск в строке:
При назначении рецензентов отправляются соответствующие уведомления в виде почтовой рассылки. Из письма можно перейти по ссылке на страницу просмотра запроса на слияние и провести проверку кода, а затем принять или отклонить эти изменения.
Просмотр и редактирование списка рецензентов#
На странице просмотра запроса на слияние можно увидеть и отредактировать список рецензентов в правой боковой панели в блоке Reviewers. Для этого нажмите кнопку Edit и внесите изменения:
Настройка правил согласования запросов на слияние#
Установить правило согласований в настройках проекта могут пользователи с ролью Owner.
Правило согласований (Approval rule) определяет, какое количество пользователей должны согласовать запрос на слияние, прежде чем он будет объединен.
Чтобы установить минимальное количество согласований запроса на слияние, выполните следующие действия:
Авторизуйтесь и перейдите в настройки проекта Settings > General.
В разделе Merge request approvals в строке Eligible users установите нужное число согласований:
Если задано число 0, то правило опционально, если больше 0 — правило является обязательным.
Настройте Approval settings: Prevent approval by author и Remove all approvals when commits are added to the source branch. Эти флаги при включении и выключении обеспечивают следующий функционал:
Флаг |
Включена |
Выключена |
|---|---|---|
Prevent approval by author |
Автор запроса на слияние не может согласовывать свой запрос |
Автор запроса на слияние может согласовывать свой запрос |
Remove all approvals when commits are added to the source branch |
Процесс согласования сбрасывается при изменении запроса на слияние |
Процесс согласования не сбрасывается при изменении запроса на слияние |
Отображение правил согласований на странице создания запроса на слияние#
Созданное правило Eligible users отображается на странице создания запроса на слияние. Чтобы увидеть правило, выполните следующие действия:
Перейдите в раздел Merge requests.
Создайте новый запрос на слияние и выберите необходимую ветку.
На странице создания запроса под полем Reviewers отображается правило и необходимое количество согласований для запроса:
Если задано обязательное правило:
Если задано опциональное правило:
Заполните необходимые поля и создайте запрос на слияние.
После того как запрос на слияние создан, действующее в проекте правило согласований отображается на странице просмотра запроса. Чтобы увидеть правило, выполните действия:
Перейдите на страницу просмотра запроса на слияние.
Отобразится информация о запросе и строка с необходимым количеством согласований для слияния запроса:
Если задано обязательное правило:
Если задано опциональное правило:
Часто встречающиеся проблемы и пути их устранения#
В текущем релизе проблемы при работе оператора не были выявлены. В случае выявления проблем обратитесь к вашему системному администратору.
Параметры настройки#
У оператора нет доступа к настройкам сервиса в среде окружения. Перечень возможных настроек доступен при установке и первичной конфигурации и описан в Руководстве по установке.
Правила эксплуатации#
Эксплуатация механизмов безопасности должна осуществляться в соответствии с их документацией. Специальных требований к эксплуатации не предъявляется.