SHA256
87 lines
3.1 KiB
Markdown
87 lines
3.1 KiB
Markdown
# Инструкция по commit и push в Git
|
|
|
|
## Репозиторий
|
|
|
|
Работать с Git нужно из корня репозитория `SHiNE-product/`:
|
|
|
|
```bash
|
|
cd /home/ai/work/SHiNE/SHiNE-server-sha256/SHiNE-product
|
|
```
|
|
|
|
## Канонический Gitea
|
|
|
|
Всегда использовать этот Git-сервер и этот remote:
|
|
|
|
```text
|
|
https://git.shineup.me/Aidar/SHiNE-server.git
|
|
```
|
|
|
|
Проверка и исправление `origin`:
|
|
|
|
```bash
|
|
git remote set-url origin https://git.shineup.me/Aidar/SHiNE-server.git
|
|
git remote -v
|
|
```
|
|
|
|
Старый адрес `git2.shineup.me` не использовать.
|
|
|
|
Секреты, токены, приватные ключи, `.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, версию и отсутствие секретов.
|