Подключить GitHub, GitLab, Bitbucket

Сервис Amvera предоставляет возможность использовать сторонний git-сервис как основной. Для этого вам потребуется настроить вебхук и подключить git-сервис на вкладке «Репозиторий» вашего проекта.

Для настройки вебхука вам потребуется токен вне зависимости от того, какой у вас репозиторий - приватный или публичный:

GitHub

Раздел создания токена находится User settings -> Developer settings (в самом низу списка) -> Personal access tokens -> Fine-grained tokens

Для токена потребуются следующие разрешения:

Дополнительно можете установить следующие настройки:

В конечном результате вы должны получить токен с следующими правами:

GitLab

Раздел создания токена находится User settings -> Access tokens

Для токена потребуются следующие разрешения:

Bitbucket

Раздел создания токена находится User settings -> Access tokens

Для токена потребуются следующие разрешения:

Вам потребуется скопировать и вставить первую строчку:

Созданный токен вам нужно вставить в соответсвующее поле и выбрать репозиторий и актуальную ветку.

После создания вебхука сделайте пуш в удаленный репозиторий, ваши изменения применятся в репозитории Амвера и сборка начнется автоматически.

В случае необходимости вы можете обновить токен, вбырать другой репозиторий и ветку.

Важно

  • вебхуки реагируют только на push ивент

  • репозиторий Амвера может быть связан только с одним хуком

  • при возникновении ошибок, первым делом проверьте актуальность токена

Ручная настройка

Видеоинструкция по подключению

Рассмотрим процесс подключения на примере публичного GitHub репозитория.

  • Перейдите на вкладку «Репозиторий» вашего проекта

  • Выберите из списка ваш git-сервис

  • Выберите ивент, в случае успешного выполнения которого, репозиторий Amvera будет делать pull. Если будут выбраны оба ивента, то репозиторий Amvera будет реагировать на CI ивент

  • Придумайте и добавьте секрет (обязательное поле). После добавления его можно будет изменить, но посмотреть значение не получится

  • Укажите целевую ветку удаленного репозитория

  • Скопируйте предлагаемый адрес

  • Нажмите «Применить»

Важно

CI для GitHub - Worflow runs, для GitLab - Pipeline events.

Во время git pull используется merge strategy their.

После потребуется настроить вебхук в GitHub.

  • Добавьте новый вебхук

  • Вставьте скопированный адрес

  • Выберите Content-type: application/json

  • Добавьте секрет, который добавили в Amvera

  • Выберите ивент, на который вы хотите начать сборку проекта (Push / Workflow runs). На остальные ивенты Amvera будет отвечать статусом 400

  • Нажмите «Add webhook»

Теперь можете делать git push в удаленный GitHub репозиторий, после все изменения будут применяться в Amvera репозитории. Сборка начнется автоматически.

Подключение приватного GitHub репозитория.

Процесс полностью идентичен, за исключением необходимости сгенерировать и добавить access token.

  • Перейдите в настройки вашего GitHub аккаунта

  • Слева внизу выберите «Developer settings»

  • Выберите Tokens (classic) -> Generate new token

  • Введите название

  • Установите Expiration - No expiration

  • Отметьте галочкой repo

  • Нажмите «Generate token»

  • Скопируйте его значение

Перейдите на вкладку «Репозиторий» вашего проекта в Amvera и добавьте скопированный токен. После того как изменения успешно применились, вы можете делать git push в приватный репозиторий, и все изменения будут применяться в репозитории Amvera.