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

GitRelax: свой Git платформы, проект без GitHub

GitRelax — свой Git платформы: репозиторий проекта хранится на git.relaxdev.ru. Создаёте проект с вкладкой «GitRelax», загружаете архив или папку либо делаете git push — сайт собирается и выкладывается. GitHub, токены и вебхуки не нужны.

Ниже: создание проекта, код из архива, логин и пароль Git, перенос кода с GitHub, доступ команды и работа через MCP.

Как это работает

  • Вместе с проектом создаётся приватный репозиторий команды: https://git.relaxdev.ru/команда/проект.git, ветка main.
  • Пока репозиторий пустой, проект ждёт первый push — карточка на странице проекта подскажет команды.
  • Каждый push в main запускает сборку тем же сборщиком, что и у проектов из GitHub: свой Dockerfile или любой стек платформы.
  • Писать в репозиторий могут владельцы и редакторы команды. Логин и пароль Git у каждого свои.

Где хранится код

У проекта в GitRelax всё лежит в одном месте: исходный код, собранный образ, работающее приложение, базы данных, Redis и кэш — на серверах платформы в России. Внешний Git-сервис не участвует.

ЧтоГде
Репозиторийgit.relaxdev.ru — сервер платформы в России: ветки, история, теги
КопияКаждую ночь, на серверах платформы
Сборка и кэшСерверы платформы: код клонируется прямо из GitRelax
ОбразРеестр образов платформы
ПриложениеКонтейнер на серверах платформы в России — или на вашей VM и вашем сервере, если подключены
Базы и RedisТам же, рядом с приложением
Студия и MCPПравки уходят коммитами в тот же репозиторий

ИИ-ассистент через MCP

Агент читает код с платформы, но то, что он прочитал, видит и сервис самого ассистента. Подключайте его к тем проектам, код которых готовы ему показать.

Создать проект

  1. 1

    «Новый проект» → вкладка «GitRelax»

    Список репозиториев GitHub не нужен — вместо него появится описание GitRelax и поле «Загрузить код».
  2. 2

    Имя и стек

    Имя — латинские буквы, цифры и дефис, с буквы. Стек — как обычно: Docker для своего Dockerfile или готовый сборщик (Next.js, Vite, Node.js, Python и другие).
  3. 3

    Создать

    Платформа заведёт проект и репозиторий. Если приложили архив или папку — код попадёт в репозиторий одним коммитом и сборка начнётся сразу; иначе — после первого push.

Залить код

На странице проекта — карточка «GitRelax». Нажмите «Получить логин и пароль Git»: логин вида u… и пароль покажутся один раз — сохраните пароль. Затем в папке с кодом:

bash
git init -b main
git remote add relaxdev https://git.relaxdev.ru/my-team/my-site.git
git add . && git commit -m "first"
git push -u relaxdev main

Git спросит логин и пароль — те, что выдала карточка. Дальше достаточно git push.

Чтобы не вводить пароль каждый раз

Включите хранилище паролей Git: git config --global credential.helper store (или менеджер паролей системы). Новый пароль из карточки отменяет прежний.

Код из архива или папки

Без git и терминала: в «Новом проекте» на вкладке «GitRelax» приложите архив или папку, а у готового проекта — кнопка «Загрузить архив/папку» в карточке GitRelax и в студии кода. Можно перетащить мышью.

  • Форматы: zip, tar, tar.gz / tgz, папка или набор файлов. 7z и RAR — пересохраните в zip.
  • До 150 МБ (после распаковки — до 100 МБ) и 5000 файлов; общий корневой каталог архива срезается. node_modules, .git, .next и файлы больше 20 МБ пропускаются.
  • .env в репозиторий не попадает: новые переменные из него добавляются в переменные проекта.
  • Всё ложится одним коммитом «Импорт: …»: файлы добавляются и перезаписываются, ничего не удаляется. Сборку запускает автодеплой.
  • Проект, созданный из архива, работает на изолированной площадке — так безопаснее для незнакомого кода.

Студия кода

Кнопка «Открыть студию кода» на странице проекта открывает редактор прямо в панели: дерево файлов ветки, подсветка кода, новые файлы и удаление. Git и терминал не нужны.

  • «Сохранить» или Ctrl+S — все изменения одним коммитом в main; сборка запускается сама. Описание изменений можно написать рядом с кнопкой.
  • Если файл изменили через git push или веб-интерфейс, пока он был открыт, студия не затрёт чужую правку: предложит взять версию из репозитория или записать свою поверх.
  • Двоичные файлы (картинки, архивы) и файлы больше 1 МБ в студии не редактируются — их меняют через git push.
  • Просмотрщик команды открывает студию только для чтения.

Перенос из GitHub и обратно

В GitRelax — в один клик. В «Новом проекте» на вкладке «GitRelax» выберите «Перенести репозиторий»: список репозиториев подключённого в профиле GitHub, GitLab, GitVerse или GitFlic — или ссылка на любой https-Git (для приватного — токен). У готового проекта из GitHub и других — кнопка «Перенести в GitRelax» в настройках источника: проект начнёт собираться из GitRelax, автодеплой из прежнего репозитория выключится. Переносятся все ветки и история, исходный репозиторий не меняется.

Из GitRelax — в любой Git. В карточке GitRelax — «Отправить в другой Git»: в подключённом аккаунте создастся новый приватный репозиторий с именем проекта, и код уйдёт туда; либо укажите адрес пустого репозитория и токен. Галочка «Держать в синхроне» оставляет зеркало — каждый коммит в GitRelax уходит туда же; без неё код отправится один раз. Токен хранится только в зеркале Git, в панели его нет.

Вручную тоже можно — история коммитов переносится целиком. В папке с уже существующим репозиторием:

bash
git remote add relaxdev https://git.relaxdev.ru/my-team/my-site.git
git push -u relaxdev main

Удалённый репозиторий origin на GitHub остаётся — можно пушить в оба. Сборку на платформе запускает только push в relaxdev.

Автодеплой

СобытиеЧто происходит
push в mainСборка и выкладка нового коммита
push в другую веткуКод сохраняется, сборки нет
тег, удаление веткиНичего
автодеплой выключенКод сохраняется, собирать — кнопкой «Редеплой»

В истории деплоев видно коммит, его сообщение и кто запустил сборку.

Доступ команды

  • Владельцы и редакторы команды пишут во все репозитории команды; просмотрщики доступа к коду не получают.
  • Логин и пароль Git у каждого участника свои: выдаются на странице любого проекта команды.
  • Понизили роль или убрали человека из команды — доступ к коду закрывается сразу.

Веб-интерфейс

Ссылка «Файлы в веб-интерфейсе» на странице проекта открывает репозиторий на git.relaxdev.ru: файлы, история коммитов, ветки. Вход — тем же логином и паролем Git. Правка файла в браузере — тоже коммит, и он так же запускает сборку.

ИИ-агенты и MCP

MCP-сервер платформы работает с GitRelax целиком: агент читает и правит код прямо в репозитории на платформе — ему не нужен ни GitHub, ни git в терминале:

  • create_project с own_git: true — проект с новым репозиторием; с git_import_url — перенос репозитория из другого Git, с archive_base64 — код из архива;
  • list_files, read_file — файлы ветки проекта;
  • write_files — изменения одним коммитом, сборка запускается сама; дальше get_deployment и get_build_logs.

Подключение MCP — в разделе про ИИ-агентов.

Частые вопросы

Git просит пароль, а я его не помню+

Пароль не хранится и показывается один раз. На странице проекта нажмите «Новый пароль Git» — прежний перестанет работать, новый появится на экране.

Push прошёл, а сборка не запустилась+

Сборку запускает только push в ветку проекта (main) при включённом автодеплое. Push в другие ветки и теги сохраняется в репозитории, но не собирается. Проверьте ветку командой git branch и настройку автодеплоя в проекте.

Можно ли подключить к проекту из GitRelax ещё и GitHub?+

Источник у проекта один. Если нужен GitHub — создайте проект из GitHub-репозитория; код из GitRelax можно отправить туда обычным git push.

Где хранится код?+

На серверах платформы в России, в приватном репозитории вашей команды на git.relaxdev.ru. Там же, в одном месте, — сборка и её кэш, реестр образов, работающее приложение, базы данных и Redis. Каждую ночь делается резервная копия — тоже на серверах платформы.

Как забрать код?+

git clone по адресу со страницы проекта — с логином и паролем Git. Приходит весь код с историей коммитов.