Files
SHiNE-server/GIT_COMMIT_PUSH_INSTRUCTIONS.md
T

70 lines
2.7 KiB
Markdown

# Инструкция по commit и push в Git
## Репозиторий
Работать с Git нужно из корня репозитория `SHiNE-product/`:
```bash
cd /home/ai/work/SHiNE/SHiNE-server-sha256/SHiNE-product
```
Секреты, токены, приватные ключи, `.env`, логи и сборочные артефакты в Git не добавлять.
## Перед коммитом
```bash
git status --short --branch
git diff --check
git diff
```
Перед обычным коммитом обновить `VERSION.properties`:
- только UI — увеличить `client.version`;
- только сервер — увеличить `server.version`;
- UI и сервер — увеличить обе версии;
- в рабочей ветке использовать patch-инкремент: `1.2.346` → `1.2.347`.
Сообщения коммитов писать на русском языке.
## Commit
```bash
git add <нужные-файлы>
git commit -m "Краткое описание изменения"
```
Для локального `git commit` токен не нужен. Не использовать `git add .`, если в рабочем дереве есть непроверенные локальные файлы.
## Push
Сначала проверить ветку и remote:
```bash
git branch --show-current
git remote -v
```
Для push использовать токен из переменной окружения `GITEA_TOKEN`; сам токен в команду, файл или историю shell не записывать. При HTTPS Git обычно запросит имя пользователя и пароль токена:
```bash
export GITEA_TOKEN='токен задаётся локально и не коммитится'
git push origin HEAD
unset GITEA_TOKEN
```
Если credential helper не умеет автоматически подставлять `GITEA_TOKEN`, использовать настроенный локально способ авторизации Gitea; не вставлять токен в URL remote.
После push проверить результат:
```bash
git status --short --branch
git log -1 --oneline
```
## Ветка `main`
`main` предназначена для стабильных версий. По умолчанию изменения сначала коммитить в рабочей ветке, затем вливать в `main`. Для merge в `main` увеличивать вторую цифру версии и обнулять третью: `1.2.346` → `1.3.0`.
Перед push в `main` отдельно проверить diff, версию и отсутствие секретов.