Коннектор
Конфиг вручную (YAML)
Справочник конфигурации для автоматизации — Ansible, CI, образы.
Для автоматизированных установок конфиг можно задать напрямую. Это опциональный путь — большинству удобнее веб-интерфейс или терминал.
Пример
# middleware_url можно не указывать — адрес relay уже вшит в агент.
# Задавайте его только для собственной (self-hosted) инсталляции.
state_dir: /var/lib/connector
providers:
- kind: gitlab
base_url: https://gitlab.corp.local
token_env: GITLAB_TOKEN # токен берётся из переменной окружения
repos:
- group/app
- group/lib
- kind: bitbucket-server
base_url: https://bitbucket.corp.local
token_file: /run/secrets/bb.token # …или из файла
repos:
- PROJ/serviceПоля
| Поле | Описание |
|---|---|
middleware_url | Опционально. Адрес relay Buff — вшит в агент по умолчанию; задавайте только для self-hosted (nats://…, ws://… или wss://…). |
state_dir | Каталог для ключа агента и токенов сессии. Должен переживать перезапуски. |
providers[].kind | github, ghe, gitlab, gitea, bitbucket, bitbucket-server. |
providers[].base_url | Адрес вашего git-сервера (или облачного провайдера). |
providers[].repos | Список репозиториев (owner/name, у Bitbucket Server — PROJECT/slug). |
providers[].token_env / token_file | Откуда взять токен: переменная окружения или файл. Ровно одно из двух. |
Токен в самом YAML не хранится — только ссылка на переменную окружения или файл. Так секрет не попадает в конфиг и в систему контроля версий.
Плюс plug-and-play
Агент следит за файлом конфига: отредактировали repos или сменили токен — изменения
применяются на лету, без перезапуска.
Привязка
connector pair --config /etc/connector/connector.yaml --code bufc_…
connector run --config /etc/connector/connector.yaml