# Git / Gitea — репозиторий local_machine

Документация и скрипты этой машины в self-hosted **Gitea**. Обычная работа — коммиты и push; из РФ часто нужен SSH или прокси.

| Документ | Назначение |
|----------|------------|
| **[RUNBOOK.md](./RUNBOOK.md)** | Push не идёт, таймаут, auth, bundle — пошагово |
| [docs/git/LOCAL_MACHINE_GITEA_SETUP.md](../../git/LOCAL_MACHINE_GITEA_SETUP.md) | Первый пуш, `.gitignore` |
| [docs/git/GITEA_COMPLETE_GUIDE.md](../../git/GITEA_COMPLETE_GUIDE.md) | Полный справочник Gitea (сервер, SSL, админ) |

---

## Константы

| Что | Значение |
|-----|----------|
| Репозиторий | `hunabgit/local_machine` |
| Веб | https://gitea.hunab.app/hunabgit/local_machine |
| Ветка | `main` |
| SSH | `ssh://git@gitea.hunab.app:2223/hunabgit/local_machine.git` |
| HTTPS | `https://gitea.hunab.app/hunabgit/local_machine.git` |
| Ключ (прод / Gitea) | `~/.ssh/hunab_deploy_key` |
| RU-прокси (SSH hop) | `hsites-ahau` (149.154.64.19) |

---

## Быстрый старт

### Первый раз (репо ещё не на Gitea)

```bash
cd /Users/eternal/code/local_machine
# 1. На https://gitea.hunab.app → New Repository → local_machine (пустой)
bash scripts/deployment/gitea/setup-and-push.sh
```

### Обычный коммит и push

```bash
cd /Users/eternal/code/local_machine
git status
git add …
git commit -m "…"
git push origin main
```

### Push из РФ (если `git push` зависает)

```bash
cd /Users/eternal/code/local_machine
bash scripts/deployment/gitea/git-push-gitea-via-proxy.sh --dry-run
bash scripts/deployment/gitea/git-push-gitea-via-proxy.sh
```

Подробно: [RUNBOOK.md](./RUNBOOK.md).

---

## Скрипты

| Скрипт | Когда |
|--------|--------|
| `scripts/deployment/gitea/setup-and-push.sh` | Первый push, init git |
| `scripts/deployment/gitea/git-push-gitea-via-proxy.sh` | Push через RU → DO (SSH / HTTPS / bundle) |

---

## Связанное

- [docs/connectivity/PROXY_GUIDE.md](../../connectivity/PROXY_GUIDE.md) — SSH `hsites-ahau`, `hunab-prod`
- [docs/connectivity/PROXY_EMERGENCY.md](../../connectivity/PROXY_EMERGENCY.md) — если «всё слетело»
