Соединения Git
Соединения Git (pda_git_connection) позволяют подключить ваш экземпляр SDLC к серверам в системе Git-провайдера.
Доступ к cоединениям Git
| Операция | admin | pda_admin | pda_user | Остальные роли |
|---|---|---|---|---|
| Создание | + | - | - | |
| Чтение | + | + | - | |
| Редактирование | + | - | - | |
| Удаление | + | Разрешено создателю записи | - | - |
Создание cоединения Git
Чтобы создать новое cоединение Git, выполните следующие действия:
- В навигаторе перейдите в SDLC → Интеграция с Git → Соединения.
- Нажмите Создать и заполните поля.
- Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.
Для того, чтобы в системе не создавались дубликаты записей, рекомендуется создать одно соединение на экземпляр, токен которого дает все необходимые доступы.
Поля формы Соединения Git
| Поле | Обязательно | Описание |
|---|---|---|
| URL Git-провайдера | Да | Укажите ссылку на домен, на котором зарегистрирована ваша учетная запись в GitLab. Например, После сохранения записи поле доступно только для чтения. |
| Токен доступа | Да | Введите уникальный идентификатор для авторизации в системе GitLab. Процесс создания и управления токенами доступа описан в документации GitLab. Убедитесь, что при создании токена доступа включена опция Чтение и изменение данного поля доступно только создателю записи с ролью pda_admin и пользователям с ролью admin. Для пользователя с ролью pda_admin, не являющегося создателем записи, поле отображается на форме, но его значение скрывается, в том числе в Ленте активности. Для остальных пользователей оно скрыто с форм и списков. |
| Статус получения данных | Нет | Поле хранит состояние получения данных о группах и репозиториях из GitLab. Возможные значения:
Поле не отображается на форме и недоступно для изменения пользователем. Статус получения данных можно отслеживать в Ленте активности. |
| Состояние | Нет | Поле хранит состояние соединения. Возможные значения:
Поле скрыто с формы, его значения отображаются на форме в виде бейджа. Поле недоступно для изменения пользователем. |
Связанные списки
- Группы Git – все группы Git, связанные с текущим соединением.
- Git-репозитории – все репозитории из групп, которые связаны с текущим соединением.
Получение данных
После сохранения записи соединения Git, приложение осуществляет попытку подключения к серверу Git-провайдера с использованием указанных URL и токена доступа. После этого на форме отображается лейбл "Соединение установлено" при успешной попытке подключения и "Соединение не установлено", если подключение было неудачным.
После успешной установки соединения с сервера GitLab на ваш экземпляр загружаются данные о группах и проектах, которые входят в эти группы.
- Если вы используете собственный сервер GitLab, выгружаются частные (private) и внутренние (internal) группы и проекты. Если вы используете сервер Gitlab.com, выгружаются только частные.
- Проекты выгружаются только если они входят в одну из групп в системе GitLab.
После загрузки данных, в таблицах Группы Git (pda_git_group) и Git-репозитории (pda_git_repository) создаются записи для групп и проектов, полученных от Git-провайдера.
По результатам получения данных заполняется поле Статус получения данных (pda_sync_state). Подробная информация о процессе и результатах получения данных записывается в Основной журнал (sys_log).
Проверка соединения и обновление данных
Для того, чтобы проверить состояние соединения Git, нажмите Проверить соединение в правом верхнем углу его формы. Приложение SDLC выполняет запрос к серверу Git-провайдера, создает новые и обновляет существующие записи групп и репозиториев в соответствии с полученными данными. Если группы или репозитории были удалены на стороне провайдера, при синхронизации они удаляются и в системе SimpleOne. Репозитории, связанные с проектами, которые были перемещены в архив в системе GitLab, деактивируются в системе SimpleOne, но не удаляются.
По результатам проверки соединения обновляются поля Состояние (pda_status) и Статус получения данных (pda_sync_state). Подробная информация о процессе и результатах проверки соединения записывается в Основной журнал (sys_log).
Удаление соединения Git
Вы можете удалять соединения единично на форме или массово в представлении списка, если у вас есть права на эту операцию с выбранными записями.
Чтобы удалить соединения, выполните следующие действия:
-
В навигаторе перейдите в SDLC → Интеграция с Git → Соединения.
-
Выберите способ удаления:
- На форме: в списке найдите соединение, которое нужно удалить, и перейдите на его форму. В бургер-меню нажмите Удалить.
- В представлении списка: в списке установите флажки рядом с соединениями, которые нужно удалить. Нажмите Удалить в верхнем правом углу страницы.
-
(опционально) Если репозитории выбранных соединений используются в активных проектах, вы можете ознакомиться с их списком перед удалением, нажав Открыть список проектов в открывшемся модальном окне.
-
Нажмите Удалить в модальном окне. Вы можете удалить только те соединения, к которым у вас есть доступ. Если у вас есть доступ к удалению только части выбранных соединений, операция будет проведена только с ними. Если у вас нет доступа ни к одной записи, операция проведена не будет. При удалении соединения:
- Информация из системы Git становится недоступна в панели разработчика.
- Автоматически удаляются связанные с соединением записи Групп Git и Git-репозиториев.
