Установка и запуск

Бот ReviewGate поставляется одним Docker-образом. Рядом поднимается Redis (очередь ревью); PostgreSQL — опционален, только для метрик ревью. Всё — в вашем контуре. Вторая поверхность — CLI для машины разработчика — поставляется отдельным исполняемым файлом, без Docker и Node: CLI, хук и MCP.

Запуск

Скачайте готовый клиентский docker-compose.yml (бот + Redis, опционально Postgres), заполните рядом .env (см. справочник ниже) и поднимите контур:

curl -O https://reviewgate.dev/docker-compose.yml
docker compose up -d
docker compose ps        # every service healthy
docker compose logs -f app

Проверьте, что бот отвечает:

curl http://localhost:3000/api/health
# {"status":"ok","ts":...,"version":"0.1.x",
#  "capacity":{"total":3,"cli":1,"mrReserve":2,
#              "inFlight":{"mr":0,"cli":0},"waiting":0}}

capacity — как настроена пропускная способность ревью; её видно снаружи, без захода на машину за стартовым логом: total — сколько ревью воркер ведёт параллельно (REVIEW_CONCURRENCY), cli — сколько из этих слотов могут занять локальные прогоны через сервер ревью, mrReserve — слоты, которые они занять не могут никогда (гарантия, что ревью MR/PR стартует сразу), а inFlight/waiting — что происходит прямо сейчас. Обратите внимание, чего ответ не говорит: он собирается без обращения к Redis и к базе, поэтому зелёный ответ означает, что процесс жив, а не что очередь доступна.

Переменные: GitLab

Вендор считается настроенным, если задан GITLAB_TOKEN. Бот работает с одним вендором или с обоими сразу — но хотя бы один должен быть настроен, иначе он не стартует.

Переменные: GitHub

Второй вендор хостинга: ревью Pull Request'ов на github.com. Настраивать его не обязательно — блок целиком опционален. Подключение к вендору описано отдельно: Подключение к GitHub.

Переменные: Redis и очередь

Переменные: LLM

Подробности и локальная LLM — в разделе «LLM и свой ключ».

Переменные: Postgres (опционально)

Postgres нужен только для метрик ревью — по умолчанию выключен, без него бот полностью работает. Чтобы включить: раскомментируйте сервис postgres и строку DATABASE_URL в docker-compose.yml и задайте пароль в .env. В метриках — только счётчики и метаданные (сколько находок сгенерировано, оставлено, дропнуто судьёй; модели, токены) в вашей же БД, автоочистка через 90 дней — по ним удобно смотреть пользу бота и что дропает судья.

Переменные: лицензия

Переменные: логи (опционально)

Рецепт подключения к Graylog/ELK/Loki — на странице «Логи и мониторинг».

Откуда берётся образ

При docker compose up -d образ скачивается сам — отдельные команды нужны только если вы забираете его вручную: в закрытый контур, во внутренний реестр или для проверки перед установкой.

Какие версии опубликованы — спросите у самого реестра:

curl -s https://registry.reviewgate.dev/v2/reviewgate-bot/tags/list

Скачать вручную и проверить, что получили именно тот образ (digest должен совпасть с зеркалом — образ собирается один раз и публикуется в оба реестра):

docker pull registry.reviewgate.dev/reviewgate-bot:latest

# the digest must match the mirror:
docker buildx imagetools inspect registry.reviewgate.dev/reviewgate-bot:latest | grep Digest
docker buildx imagetools inspect novohudonossor/reviewgate-bot:latest | grep Digest

Закрытый контур (без интернета)

На машине с доступом в интернет сохраните образ в файл, перенесите его любым разрешённым у вас способом и загрузите на целевом сервере. Образ собран под linux/amd64 — указывайте платформу явно, если качаете с ARM-машины (например с Mac):

VERSION=latest   # or a specific tag from the list above

# 1) on a machine with internet access
docker pull --platform linux/amd64 registry.reviewgate.dev/reviewgate-bot:$VERSION
docker save registry.reviewgate.dev/reviewgate-bot:$VERSION | gzip > reviewgate-bot-$VERSION.tar.gz

# 2) move the file to the target server, then there:
gunzip -c reviewgate-bot-$VERSION.tar.gz | docker load
docker image ls | grep reviewgate-bot

После docker load пропишите в docker-compose.yml тот же тег, который загрузили, — тогда up -d возьмёт локальный образ и в сеть не пойдёт.

Обновление

Бот распространяется публичным образом с реестра registry.reviewgate.dev (зеркало — Docker Hub, см. «Образ не скачивается») — рекомендуем закрепить конкретный тег версии. Обновление — обычный pull и перезапуск:

docker compose pull app
docker compose up -d app

Если тег закреплён (не latest), сначала укажите в docker-compose.yml новый — иначе pull перетянет тот же образ и up -d ничего не пересоздаст. Список опубликованных версий — командой из раздела «Откуда берётся образ».

Какая версия у вас работает

Версия сборки вшита в образ и видна в ответе /api/health, в строке 🚀 ReviewGate bot … стартового лога и в выводе diagnose.sh.

curl -s http://localhost:3000/api/health
# {"status":"ok","ts":...,"version":"0.1.x","capacity":{...}}
#                                     ↑ the version of the running image

docker compose logs app | grep 🚀
# 🚀 ReviewGate bot 0.1.x listening on http://0.0.0.0:3000/api

Если бот вообще не стартует (например, из-за ошибки в .env), версия всё равно читается — она вшита в образ, а не выдаётся приложением:

docker compose run --rm --no-deps app printenv REVIEWGATE_VERSION
# 0.1.x

Версию стоит прикладывать к любому обращению в поддержку — с неё начинается разбор.