Документация / 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
«Новый проект» → вкладка «GitRelax»
Список репозиториев GitHub не нужен — вместо него появится описание GitRelax и поле «Загрузить код». - 2
Имя и стек
Имя — латинские буквы, цифры и дефис, с буквы. Стек — как обычно:Dockerдля своего Dockerfile или готовый сборщик (Next.js, Vite, Node.js, Python и другие). - 3
Создать
Платформа заведёт проект и репозиторий. Если приложили архив или папку — код попадёт в репозиторий одним коммитом и сборка начнётся сразу; иначе — после первого push.
Залить код
На странице проекта — карточка «GitRelax». Нажмите «Получить логин и пароль Git»: логин вида u… и пароль покажутся один раз — сохраните пароль. Затем в папке с кодом:
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 mainGit спросит логин и пароль — те, что выдала карточка. Дальше достаточно 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, в панели его нет.
Вручную тоже можно — история коммитов переносится целиком. В папке с уже существующим репозиторием:
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. Приходит весь код с историей коммитов.