docs: Обновлена документация по настройке Git credentials

- Добавлена информация в CHANGELOG о настройке credential helper
- Обновлён README с инструкциями по автоматической отправке
- Создан .git_setup.md с подробными инструкциями
This commit is contained in:
dosai 2025-11-01 19:44:20 +03:00
parent 25178247e7
commit 281fc94838
3 changed files with 109 additions and 0 deletions

85
.git_setup.md Normal file
View File

@ -0,0 +1,85 @@
# Настройка автоматической отправки в Git
## Текущая конфигурация
✅ Credential helper настроен на `store` - пароль будет сохранён после первого ввода.
## Варианты настройки
### Вариант 1: Использование сохранённого пароля (уже настроено)
При первом `git push` введите логин и пароль - они будут сохранены в `~/.git-credentials`.
```bash
cd /home/dosai/projects/DoSoapCalc
git push origin main
# Введите username и password один раз
```
### Вариант 2: Использование Access Token (рекомендуется для безопасности)
1. Создайте токен в Gitea:
- Войдите в Gitea: http://192.168.0.19:3002
- Settings → Access Tokens
- Создайте новый токен с правами `write:repository`
2. Используйте токен вместо пароля:
```bash
cd /home/dosai/projects/DoSoapCalc
git push origin main
# Username: ваш_логин
# Password: ваш_токен (не пароль!)
```
### Вариант 3: SSH ключи (самый безопасный)
1. Создайте SSH ключ:
```bash
ssh-keygen -t ed25519 -C "dosai@dosoapcalc" -f ~/.ssh/id_ed25519_gitea
```
2. Добавьте публичный ключ в Gitea:
- Settings → SSH / GPG Keys → Add Key
- Скопируйте содержимое `~/.ssh/id_ed25519_gitea.pub`
3. Измените remote на SSH:
```bash
cd /home/dosai/projects/DoSoapCalc
git remote set-url origin git@192.168.0.19:DosAi/DoSoapCalc.git
# Или если используется порт:
# git remote set-url origin ssh://git@192.168.0.19:PORT/DosAi/DoSoapCalc.git
```
4. Настройте SSH config (если нужен нестандартный порт):
```bash
cat >> ~/.ssh/config << 'EOF'
Host gitea
HostName 192.168.0.19
User git
Port 2222
IdentityFile ~/.ssh/id_ed25519_gitea
EOF
```
### Вариант 4: Токен в URL (менее безопасно, но работает сразу)
```bash
cd /home/dosai/projects/DoSoapCalc
git remote set-url origin http://username:token@192.168.0.19:3002/DosAi/DoSoapCalc.git
```
⚠️ **Внимание:** Токен будет виден в истории команд и конфигах!
## Проверка текущего состояния
```bash
# Проверить remote
git remote -v
# Проверить credential helper
git config --global credential.helper
# Проверить сохранённые credentials (если есть)
cat ~/.git-credentials 2>/dev/null || echo "Credentials не сохранены"
```

View File

@ -24,6 +24,7 @@
- `CALCULATOR_GUIDE.md` - руководство по добавлению новых калькуляторов
- `README.md` - обновлённая документация проекта
- `CHANGELOG.md` - этот файл для отслеживания изменений
- `.git_setup.md` - инструкции по настройке Git credentials
### Изменено
@ -40,6 +41,13 @@
- **Типизация**: Добавлены TypeScript типы для калькуляторов
- **Код-организация**: Разделение ответственности между модулями
### Настроено
- **Git Credential Helper**: Настроено автоматическое сохранение credentials для push без запроса пароля
- Credential helper: `store` (постоянное сохранение)
- Файл credentials: `~/.git-credentials` (права доступа 600)
- При первом push вводятся логин и пароль, далее - автоматически
### Технические детали
#### Backend структура:

View File

@ -141,6 +141,22 @@ DoSoapCalc/
- TypeScript
- Tailwind CSS 4
## Настройка Git (автоматическая отправка)
Для автоматической отправки изменений в репозиторий без запроса пароля:
1. Credential helper уже настроен на `store`
2. При первом `git push` введите логин и пароль - они сохранятся
3. Все последующие push будут выполняться автоматически
```bash
git push origin main
# Username: ваш_логин
# Password: ваш_пароль
```
Подробные инструкции по альтернативным вариантам (SSH, токены) см. в `.git_setup.md`
## Лицензия
ISC