Коннектор
Настройка через веб-интерфейс
Настройте провайдера, токен и репозитории через локальные формы в браузере.
Самый простой способ. Агент поднимает небольшую страницу настройки только на
локальном адресе (127.0.0.1) — она не видна из сети, и токен с неё никуда не уходит.
Запуск
connector setup --config /etc/connector/connector.yamlОткройте в браузере http://127.0.0.1:8765. Если настраиваете на удалённом сервере,
пробросьте порт по SSH:
ssh -L 8765:127.0.0.1:8765 user@ваш-сервер
Шаги
- Подключение. Адрес relay уже задан в агенте — менять его нужно только для собственной (self-hosted) инсталляции. Укажите каталог состояния.
- Провайдер. Выберите тип (GitLab, GitHub Enterprise, Gitea, Bitbucket Server, …), укажите Base URL и токен доступа. Нажмите «Проверить доступ» — агент сходит к вашему провайдеру и покажет, есть ли доступ.
- Репозитории. Из полученного списка отметьте нужные репозитории галочками — ничего не нужно вводить руками, опечатки исключены. Нажмите «Добавить провайдера».
- Привязка. Вставьте одноразовый код из приложения Buff и нажмите «Привязать».
Готово — агент подключён. Запустите его в постоянном режиме:
connector run --config /etc/connector/connector.yamlИзменения на лету
Чтобы менять настройки, не останавливая агент, запускайте его с админкой:
connector run --config /etc/connector/connector.yaml --admin 127.0.0.1:8765Добавить репозиторий или сменить токен через ту же страницу — изменения применяются сразу, без перезапуска.
Токен доступа записывается в файл с правами 600 в каталоге состояния и никогда не
попадает в конфиг и к нам.