В репозиторий проекта FISYCO доставляет pull request для своих библиотек. Его же код FISYCO читает, чтобы находить расхождения и обходы. На этой странице описано, как подключить репозиторий. Поддерживаются GitHub, GitLab (gitlab.com) и Bitbucket Cloud.
Перед началом
- Вы мейнтейнер проекта, владелец или администратор пространства.
- Для GitHub: вы можете установить GitHub App в организации или аккаунте, которому принадлежит репозиторий, или попросить того, кто может.
Подключите репозиторий
- Откройте проект, затем Настройки → Интеграции.
- В блоке Репозиторий выберите провайдера.
- Дайте доступ:
- GitHub: нажмите Установить GitHub App и выберите репозитории, с которыми FISYCO может работать. Когда установка завершится, вы вернётесь в проект.
- GitLab и Bitbucket: нажмите Авторизоваться и войдите. FISYCO использует ваш личный доступ, чтобы показать репозитории, которые вы можете привязать.
- Выберите репозиторий и нажмите Сохранить.
- При желании заполните поле Целевая ветка. В эту ветку открываются pull request. Оставьте поле пустым, чтобы использовать ветку репозитория по умолчанию. Ветки появятся после сохранения репозитория.
Репозиторий можно подключить и при создании проекта. Этот шаг можно пропустить и подключить репозиторий позже.
Чей доступ используется
Блок Репозиторий всегда показывает, с каким доступом работает проект:
Подключение принадлежит пространству, поэтому несколько проектов могут пользоваться одним доступом. Если личный доступ истёк или отозван, проект покажет, что не так и как это исправить: войти заново или дать администратору перехватить подключение.
Вебхуки
После сохранения репозитория FISYCO регистрирует вебхук, чтобы узнавать о push и pull request. Так статус доставленного pull request остаётся актуальным, а индекс кода обновляется после push. Текущее состояние каждого вебхука показано в блоке Зарегистрированные вебхуки. Если вебхук перестал работать, FISYCO проверяет изменения по таймеру, пока вебхук не починят.
Изменение и отключение
- Чтобы сменить репозиторий или ветку, измените их в той же форме и сохраните один раз. При смене ветки вебхук заново не регистрируется.
- Отключить сначала удаляет вебхуки, затем отвязывает репозиторий от проекта. Подключение пространства остаётся, потому что им могут пользоваться другие проекты.
Если подключить репозиторий к проекту, где уже есть библиотеки, следующая синхронизация сочтёт всё новым. Поэтому первый pull request будет содержать библиотеку целиком.