Виджет отображает запросы на слияние (PR) репозитория на GitHub и позволяет просматривать изменения, создавать, сливать и закрывать PR.
Учётная запись и автор действий
Запросы к GitHub выполняются с токеном из учётных данных того пользователя платформы, от имени которого вызывается действие. Если в настройках виджета включено «Выбрать учётную запись для виджета», используются учётные данные выбранного пользователя платформы, а не текущего.
При создании, слиянии и закрытии запроса на слияние в GitHub автором PR и исполнителем действий считается учётная запись GitHub, которой принадлежит этот токен. Логин и имя в интерфейсе GitHub могут не совпадать с именем в профиле Deckhouse Development Platform (DDP).
Конфигурация
| Название | Обязательность | Описание | Пример |
|---|---|---|---|
| Владелец репозитория | Да | Владелец репозитория (организация или пользователь) | Для https://github.com/example/my-repo укажите example |
| Репозиторий | Да | Название репозитория без .git | Для https://github.com/example/my-repo укажите my-repo |
Статус
В настройках запроса виджета можно фильтровать PR по статусу:
- «Открыт» — только открытые PR (не черновики).
- «Черновик» — только черновики.
- «Закрыт» — только закрытые PR.
- «Все» — любые PR.
По умолчанию отображаются открытые PR. В таблице отображаются номер, название, описание, статус, лейблы, автор, дата создания и дата обновления. Для каждого PR доступны действия через меню.
Действия
- «Изменения» — просмотр списка изменённых файлов и сравнение изменений по каждому файлу.
- «Слить» — слияние открытого PR (доступно только для открытых PR, не черновиков).
- «Закрыть» — закрытие PR без слияния.
- «Создать PR» — создание нового запроса на слияние. В диалоге укажите название, исходную ветку, целевую ветку и описание.
Для выполнения действий с PR требуются соответствующие права доступа в репозитории GitHub.
Авторизация
Конфигурация авторизации описана в разделе «Внешние сервисы».
В настройках внешнего сервиса или в конфигурации виджета в поле «URL» укажите https://api.github.com.