GitRiver GitRiver
EN
Навигация

Первые шаги

Создание первого репозитория, настройка SSH, запуск CI/CD - за 10 минут после установки

После установки и прохождения мастера настройки вы попадаете на главную страницу GitRiver. В этом разделе - как создать первый репозиторий, подключить SSH, настроить CI/CD и пригласить коллег.

Создание первого репозитория

Через веб-интерфейс

  1. Нажмите кнопку «+» в верхнем правом углу -> Репозиторий
  2. Заполните:
    • Имя - латиница, цифры, дефис (например, my-project)
    • Описание - краткое описание проекта (опционально)
    • Видимость - публичный (все могут читать) или приватный
  3. Опционально отметьте:
    • Инициализировать README - создаст файл README.md с описанием
    • .gitignore - выберите шаблон для вашего языка
    • Лицензия - MIT, Apache 2.0 и другие
  4. Нажмите «Создать»

Клонирование на машину

После создания скопируйте URL из интерфейса:

# HTTPS (с логином/паролем или токеном)
git clone https://git.example.com/username/my-project.git

# SSH (после настройки ключа - см. ниже)
git clone ssh://git@git.example.com/username/my-project.git

Из существующего проекта

Если у вас уже есть локальный git-репозиторий:

cd my-existing-project
git remote add origin https://git.example.com/username/my-project.git
git push -u origin main

Настройка SSH-ключей

SSH позволяет работать с git без ввода пароля при каждом push/pull.

1. Создайте ключ (если ещё нет)

ssh-keygen -t ed25519 -C "your@email.com"

2. Скопируйте публичную часть

cat ~/.ssh/id_ed25519.pub

3. Добавьте в GitRiver

  1. Нажмите на аватар в правом верхнем углу -> «Настройки»
  2. В левом меню выберите «SSH-ключи»
  3. Нажмите «Добавить SSH-ключ»
  4. Вставьте содержимое публичного ключа, укажите название
  5. Нажмите «Сохранить»

4. Проверьте

git clone ssh://git@git.example.com/username/my-project.git

Настройка GPG-ключей

GPG-ключи позволяют подписывать коммиты для подтверждения авторства.

  1. Нажмите на аватар -> «Настройки» -> «GPG-ключи»
  2. Нажмите «Добавить GPG-ключ»
  3. Вставьте публичный GPG-ключ (gpg --armor --export your@email.com)
  4. Настройте git на подпись коммитов:
git config --global user.signingkey YOUR_KEY_ID
git config --global commit.gpgsign true

Токены доступа

Токены нужны для автоматизации: скрипты, CI/CD внешних систем, docker login.

Создание персонального токена

  1. Нажмите на аватар -> «Настройки» -> «Токены»
  2. Нажмите «Создать токен»
  3. Укажите:
    • Имя - для чего этот токен (например, «CI сервер»)
    • Скоупы - что разрешено:
      • Чтение репозиториев
      • Запись в репозитории
      • Чтение реестра (docker pull)
      • Запись в реестр (docker push)
    • Срок действия - когда токен истечёт
  4. Нажмите «Создать» и сохраните токен - он показывается только один раз

Использование

# Как пароль при git clone
git clone https://username:gtr_pat_xxxxx@git.example.com/owner/repo.git

# Как заголовок Authorization
curl -H "Authorization: Bearer gtr_pat_xxxxx" https://git.example.com/api/v1/user

# Для docker login
docker login git.example.com -u username -p gtr_pat_xxxxx

Первый CI/CD пайплайн

GitRiver имеет встроенную CI/CD-систему с YAML-конфигурацией.

1. Создайте workflow-файл

В корне репозитория создайте файл .gitriver/workflows/ci.yml:

name: CI

on:
  push:
    branches: [main]
  pull_request:

jobs:
  test:
    image: node:22
    steps:
      - run: npm ci
      - run: npm test

Это значит: при каждом push в main или при создании пулл-реквеста - запускать job test в контейнере node:22.

2. Отправьте в репозиторий

git add .gitriver/workflows/ci.yml
git commit -m "Добавить CI конфигурацию"
git push

3. Посмотрите результат

  1. Откройте репозиторий в GitRiver
  2. Перейдите во вкладку «CI/CD» (иконка ракеты в меню репозитория)
  3. Вы увидите запущенный пайплайн с job test
  4. Нажмите на job - откроются логи в реальном времени

Для работы CI нужен Docker на хосте GitRiver (или Docker socket пробросить в контейнер). Подробнее - в разделе CI/CD пайплайны.

Приглашение пользователей

Открытая регистрация

По умолчанию регистрация открыта. Пользователи могут зарегистрироваться сами на странице входа. Чтобы отключить: Администрирование -> Система -> снять флажок «Разрешить регистрацию».

Создание пользователя администратором

  1. Откройте Администрирование (в верхнем меню)
  2. Перейдите в раздел «Пользователи»
  3. Нажмите «Добавить пользователя»
  4. Заполните имя, email, пароль

Группы (организации)

Группы объединяют пользователей и репозитории:

  1. Нажмите «+» -> «Группа»
  2. Укажите имя группы (например, backend-team)
  3. Добавьте участников с ролями: Owner, Maintainer, Developer, Reporter, Guest

Подробнее - в разделе Пользователи и группы.