Скачать GitRiver
Один бинарник, одна база данных, одна команда запуска.
Docker (быстрый старт)
Скачайте образ и запустите одной командой.
docker pull gitriver/gitriver:1.1.0
Архитектуры в Docker Hub: x86-64, arm64.
Docker Composeрекомендуется
PostgreSQL + GitRiver в двух контейнерах. Создайте два файла:
.env
DB_USER=gitriver DB_PASS=changeme DB_NAME=gitriver
docker-compose.yml
services:
postgres:
image: postgres:17-alpine
restart: unless-stopped
environment:
POSTGRES_USER: ${DB_USER}
POSTGRES_PASSWORD: ${DB_PASS}
POSTGRES_DB: ${DB_NAME}
volumes:
- ./data/postgres:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${DB_USER}"]
interval: 5s
retries: 5
gitriver:
image: gitriver/gitriver:1.1.0
restart: unless-stopped
depends_on:
postgres:
condition: service_healthy
ports:
- "3000:3000"
environment:
GITRIVER_DB_HOST: postgres
GITRIVER_DB_PORT: 5432
GITRIVER_DB_USER: ${DB_USER}
GITRIVER_DB_PASS: ${DB_PASS}
GITRIVER_DB_NAME: ${DB_NAME}
volumes:
- ./data/gitriver:/var/lib/gitriver
- /var/run/docker.sock:/var/run/docker.sockdocker compose up -d:
docker compose up -d
Откройте http://localhost:3000 - мастер настройки создаст администратора.
Замените changeme на надёжный пароль в файле .env.
Пакеты и чарт Helm
К каждому выпуску приложены файлами: пакет deb, пакет rpm, чарт Helm архивом, суммы SHA256 и подпись к ним.
sudo apt install ./gitriver_1.1.0-1_amd64.deb sudo dnf install ./gitriver-1.1.0-1.x86_64.rpm helm install gitriver gitriver-1.1.0.tgz -f values.yaml
Пакеты собраны на glibc 2.34 - подходят RHEL, Rocky и AlmaLinux 9+, Debian 12+, Ubuntu 22.04+, Astra Linux 1.8+ и новее. Для систем постарше - образ.
Внешний исполнитель заданий
Отдельная машина, которая берёт задания CI у сервера. Ставится там, где должны выполняться сборки, — не обязательно рядом с GitRiver.
Образ исполнителя для Kubernetes
docker pull gitriver/gitriver:1.1.0-runner
Архитектуры в Docker Hub: x86-64, arm64.
Тот же репозиторий, что у образа сервера, отдельным тегом. Этот полный адрес указывают в поле runner_image исполнителя для Kubernetes.
Проверка подлинности
Контрольные суммы подписаны ключом издателя. Проверьте подпись и суммы перед установкой: это единственный способ убедиться, что файл не подменён по дороге.
Отпечаток ключа издателя
1E6F BBE8 8538 ED05 0C08 B9CE 284B 244C A43D 3621
Это объявление издателя: значение напечатано здесь, а не взято из набора. Сверьте с ним отпечаток ключа, которым подписан перечень сумм: файл с отпечатком, лежащий рядом с самим ключом, подтверждает только их взаимное соответствие — печать, удостоверяющая сама себя.
Порядок проверки
gpg --import gitriver-release-key.asc gpg --show-keys --fingerprint gitriver-release-key.asc gpg --verify SHA256SUMS.asc SHA256SUMS sha256sum --check --ignore-missing SHA256SUMS
Docker Hub
Образы сервера. Сейчас там опубликована версия 1.1.0.
Документация
Подробная инструкция по установке, настройке, CI/CD и обновлению.
Архив — та же документация для установок без выхода в сеть. Он входит в подписанный перечень сумм набора.
Системные требования
GitRiver: 1 vCPU, 256 МБ памяти, PostgreSQL 15+
Со встроенным исполнителем: 2+ CPU, 4+ ГБ памяти, Docker 20.10+