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

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

<span style="font-size:1.5em; font-weight: 700">Рассмотрим процесс подключения на примере публичного GitHub репозитория.</span>

* Перейдите на вкладку "Репозиторий" вашего проекта
* Выберите из списка ваш git-сервис
* Выберите ивент, в случае успешного выполнения которого, репозиторий Amvera будет делать pull. Если будут выбраны оба ивента, то репозиторий Amvera будет реагировать на CI ивент
* Придумайте и добавьте секрет (обязательное поле). После добавления его можно будет изменить, но посмотреть значение не получится
* Скопируйте предлагаемый адрес
* Нажмите "Применить"

![](../../img/webhook-add.png)

```{eval-rst}
.. admonition:: Важно
  :class: warning
  
  Ветка в git-сервисе должна иметь имя master!
  
  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"

![](../../img/webhook-github.png)

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

<span style="font-size:1.5em; font-weight: 700">Подключение приватного GitHub репозитория.</span>

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

* Перейдите в настройки вашего GitHub аккаунта
* Слева внизу выберите "Developer settings"
* Выберите Tokens (classic) -> Generate new token
* Введите название
* Установите Expiration - No expiration
* Отметьте галочкой repo
* Нажмите "Generate token"
* Скопируйте его значение

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