Files
SHiNE-server/GIT_COMMIT_PUSH_INSTRUCTIONS.md
T

2.7 KiB

Инструкция по commit и push в Git

Репозиторий

Работать с Git нужно из корня репозитория SHiNE-product/:

cd /home/ai/work/SHiNE/SHiNE-server-sha256/SHiNE-product

Секреты, токены, приватные ключи, .env, логи и сборочные артефакты в Git не добавлять.

Перед коммитом

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

git add <нужные-файлы>
git commit -m "Краткое описание изменения"

Для локального git commit токен не нужен. Не использовать git add ., если в рабочем дереве есть непроверенные локальные файлы.

Push

Сначала проверить ветку и remote:

git branch --show-current
git remote -v

Для push использовать токен из переменной окружения GITEA_TOKEN; сам токен в команду, файл или историю shell не записывать. При HTTPS Git обычно запросит имя пользователя и пароль токена:

export GITEA_TOKEN='токен задаётся локально и не коммитится'
git push origin HEAD
unset GITEA_TOKEN

Если credential helper не умеет автоматически подставлять GITEA_TOKEN, использовать настроенный локально способ авторизации Gitea; не вставлять токен в URL remote.

После push проверить результат:

git status --short --branch
git log -1 --oneline

Ветка main

main предназначена для стабильных версий. По умолчанию изменения сначала коммитить в рабочей ветке, затем вливать в main. Для merge в main увеличивать вторую цифру версии и обнулять третью: 1.2.346 → 1.3.0.

Перед push в main отдельно проверить diff, версию и отсутствие секретов.