GitHub подключается либо через Coroid GitHub App либо через личный доступ token. Настройте его в Настройки → Подключения → Управление исходным кодом.
Приложение или токен
Рекомендуем использовать приложение. Оно предоставляет доступ к конкретным репозиториям, а не к пользователям, продолжает работать даже после ухода человека, который его настроил, и получает события вебхуков без необходимости опроса.
Используйте токен, если для установки приложения требуется одобрение администратора организации, которого у вас нет.
| GitHub App | Личный доступ token | |
|---|---|---|
| Область доступа | На уровне репозитория | Все, что видит пользователь |
| Продолжает работать после ухода установщика | Да | Нет |
| События вебхуков | Да | Опрос |
| Привязка | Приложение | Владелец токена |
Установка приложения
Выберите GitHub в Настройки → Подключения → Управление исходным кодом и следуйте инструкциям по установке. GitHub спросит, какие репозитории предоставить доступ; позже вы сможете изменить это в настройках самого GitHub.
Если при создании проекта репозиторий не отображается, скорее всего, приложению не был предоставлен доступ именно к этому репозиторию — это самая распространенная причина.
Использование токена
Создайте стандартный токен со repo областью доступа, или токен с точными правами чтения и записи для содержимого и pull-запросов, затем вставьте его в настройки системы контроля версий.
Токены шифруются при хранении, никогда не возвращаются API и не включаются в экспорт настроек.
GitHub Issues
То же самое соединение позволяет импортировать задачи как рабочие элементы. См. Импорт рабочих элементов.
События, превращающиеся в рабочие элементы
При использовании приложения автоматизация событий может отправлять pull request, новую задачу или комментарий с упоминанием Coroid в раздел Qualification. См. Триггеры и назначения.
Квалифицированные рабочие элементы из этих событий запускаются автоматически только если их автор имеет права на запись, обслуживание или администрирование репозитория. Coroid запрашивает GitHub для каждого события. Для pull request автором является человек, открывший задачу, а не тот, кто её пометил или объединил. Рабочие элементы от других пользователей создаются и ждут, пока кто-то их запустит. Комментарий с упоминанием Coroid учитывается только если у его автора есть права на запись.
Рецензирование pull-запросов
При использовании приложения Coroid проверяет и рецензирует pull-запросы, открытые людьми и другими инструментами, а не только собственные задачи Coroid. Coroid Quality Control выполняет проверки проекта и публикует проверку Coroid Quality Control. Coroid Review оставляет комментарии к строкам кода, вызывающим вопросы, и создает проверку под названием Coroid Review. Обе настройки находятся в разделе Quality Control, в блоке Pull requests. См. Pull-запросы.
Что делает Coroid в вашем репозитории
- читает код, чтобы понять и изменить его
- создает ветку для каждой задачи
- отправляет эту ветку и открывает pull request против вашей базовой ветки
Он никогда не коммитит в вашу ветку по умолчанию и не объединяет изменения самостоятельно. Объединение происходит только когда человек объединяет pull request в GitHub или нажимает Утвердить и объединить в Coroid.
Проект, настроенный на Только локально выполняет первое из этих действий и больше ничего не делает: Coroid считывает и извлекает данные, а ветки, рецензии и проверки хранит внутри Coroid. Он не отправляет данные, не открывает и не комментирует pull-запросы, не публикует результаты проверок, даже если приложение или токен позволяют это делать. См. Синхронизированный или только локальный.
Ваши правила защиты веток, обязательных проверок и рецензирования применяются без изменений. Утвердить и объединить также объединяет изменения через pull request, поэтому те же правила определяют успех операции. См. Объединение.
Безопасность
Безопасность использует приложение для публикации Coroid Security проверки и, при наличии дополнительных прав, для импорта собственных уведомлений о безопасности GitHub и проверки очередей объединения. См. Права GitHub и проверка Безопасность Coroid.