69 lines
2.9 KiB
Markdown
69 lines
2.9 KiB
Markdown
# local_machine — репозиторий на Gitea
|
||
|
||
Репозиторий **local_machine** на сервере Gitea (gitea.hunab.app): документация и скрипты для локальной машины.
|
||
|
||
## Быстрый старт
|
||
|
||
### 1. Создать репозиторий на Gitea (один раз)
|
||
|
||
**Вариант А — через веб-интерфейс**
|
||
|
||
1. Открыть: https://gitea.hunab.app
|
||
2. Войти под пользователем `hunabgit` (или своим).
|
||
3. **New Repository** → Name: `local_machine` → Create Repository.
|
||
4. Репо создавать **пустым** (без README / .gitignore).
|
||
|
||
**Вариант Б — через API (если есть токен)**
|
||
|
||
```bash
|
||
# Токен: Gitea → Settings → Applications → Generate New Token (write:repository, read:repository)
|
||
export GITEA_TOKEN="your_token"
|
||
bash scripts/deployment/gitea/setup-and-push.sh --create-only
|
||
```
|
||
|
||
### 2. Инициализация и первый пуш
|
||
|
||
Из корня **local_machine** (не из родительского репо):
|
||
|
||
```bash
|
||
cd /Users/eternal/code/local_machine
|
||
bash scripts/deployment/gitea/setup-and-push.sh
|
||
```
|
||
|
||
Скрипт:
|
||
|
||
- инициализирует git в `local_machine` (если ещё нет `.git`);
|
||
- добавляет `origin` (SSH или HTTPS);
|
||
- делает первый коммит и `git push -u origin main`.
|
||
|
||
### 3. Если пуш из РФ зависает
|
||
|
||
По гайду [GITEA_COMPLETE_GUIDE.md](./GITEA_COMPLETE_GUIDE.md):
|
||
|
||
- предпочтительно **SSH** (порт 2223):
|
||
`git remote set-url origin git@gitea.hunab.app:hunabgit/local_machine.git`
|
||
и снова `git push -u origin main`;
|
||
- либо использовать прокси/скрипты пуша из основного репо (bundle-метод), если они у вас настроены.
|
||
|
||
## .gitignore
|
||
|
||
В корне проекта настроен `.gitignore`, чтобы не пушить:
|
||
|
||
- системный мусор: `.DS_Store`, `Thumbs.db`;
|
||
- секреты и ключи: `.env`, `*.pem`, `*.key`, конфиги VPN с ключами (`docs/connectivity/vpn/*.conf`);
|
||
- артефакты: `node_modules/`, `__pycache__/`, `*.log`, `*.tmp`, кэши и т.п.;
|
||
- IDE/редакторы: `.idea/`, `.vscode/`, `.cursor/`.
|
||
|
||
Конфиги с приватными ключами (WireGuard и т.д.) в репозиторий не попадают.
|
||
|
||
## Дальнейшая работа
|
||
|
||
- Клонирование:
|
||
`git clone https://gitea.hunab.app/hunabgit/local_machine.git`
|
||
или по SSH:
|
||
`git clone git@gitea.hunab.app:hunabgit/local_machine.git`
|
||
- Обычные коммиты и пуш:
|
||
`git add ... && git commit -m "..." && git push origin main`
|
||
|
||
Полный гайд по Gitea (пуши, SSH, bundle, из РФ): [GITEA_COMPLETE_GUIDE.md](./GITEA_COMPLETE_GUIDE.md).
|