Перейти к содержимому
GitRiverGitRiver
EN

Скачать 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.sock

docker 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.

Docker Hub

Документация

Подробная инструкция по установке, настройке, CI/CD и обновлению.

Архив — та же документация для установок без выхода в сеть. Он входит в подписанный перечень сумм набора.

Системные требования

GitRiver: 1 vCPU, 256 МБ памяти, PostgreSQL 15+

Со встроенным исполнителем: 2+ CPU, 4+ ГБ памяти, Docker 20.10+