Установка

Агент — один самодостаточный исполняемый файл. Ставьте его на любую машину в вашей сети, у которой есть доступ к вашему git-серверу и исходящий доступ в интернет.

Вариант 1. Бинарный файл

Скачайте файл для вашей ОС и архитектуры со страницы загрузок Buff:

• Linux — connector-linux-amd64 / connector-linux-arm64
• macOS — connector-darwin-amd64 / connector-darwin-arm64
• Windows — connector-windows-amd64.exe / connector-windows-arm64.exe

Проверьте контрольную сумму и подпись (артефакты подписаны cosign):

sha256sum -c SHA256SUMS --ignore-missing
cosign verify-blob --signature connector-linux-amd64.sig \
  --certificate connector-linux-amd64.pem connector-linux-amd64
chmod +x connector-linux-amd64 && sudo mv connector-linux-amd64 /usr/local/bin/connector

Для бинаря нужен установленный git (агент вызывает его для работы с репозиториями).

Вариант 2. Docker

Образ уже содержит git:

docker run -d --name buff-connector \
  -v /srv/connector:/etc/connector \
  -v buff-connector-state:/var/lib/connector \
  registry.buff.systems/buff/connector:latest \
  run --config /etc/connector/connector.yaml

Смонтируйте том для состояния (/var/lib/connector) — там хранится ключ агента и токены сессии, чтобы они пережили перезапуск контейнера.

Дальше — настройка

• Веб-интерфейс — формы в браузере (рекомендуется).
• Терминал — для серверов без графики.
• YAML вручную — для автоматизации (Ansible/CI).