Соединения Git
Соединения Git позволяют подключить ваш экземпляр 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-провайдера и создает новые и обновляет существующие записи групп и репозиториев в соответствии с полученными данными.
При проверке соединения не удаляются записи таблиц Группы Git (pda_git_group) и Git-репозитории (pda_git_repository), относящиеся к группам и проектам, которые были удалены или перемещены в архив в системе GitLab.
По результатам проверки соединения обновляются поля Состояние (pda_status) и Статус получения данных (pda_sync_state). Подробная информация о процессе и результатах проверки соединения записывается в Основной журнал (sys_log).
Удаление соединения Git
При удалении соединения Git, автоматически удаляются связанные с ним записи Групп Git и Git-репозиториев.