README: сократить до заголовка и таблицы, вынести инструкции в docs/

Убраны упоминания GitHub; ссылка только на git.kalinamall.ru. Добавлены docs/git.md, docs/haproxy-install.md, docs/letsencrypt-acme.md.
2026-06-01 11:43:12 +10:00
parent 6a75c9b7a2
commit 1314eb8010
4 changed files with 371 additions and 373 deletions
@@ -0,0 +1,109 @@
+# Работа с Git на Ubuntu
+
+Репозиторий: [https://git.kalinamall.ru/PapaTramp/reverse-proxy](https://git.kalinamall.ru/PapaTramp/reverse-proxy)
+
+## Установка Git
+
+```bash
+sudo apt update
+sudo apt install -y git
+```
+
+## Первое клонирование
+
+```bash
+cd ~
+git clone https://git.kalinamall.ru/PapaTramp/reverse-proxy.git
+cd reverse-proxy
+```
+
+Для **push** с сервера настройте SSH-ключ или PAT (см. ниже).
+
+## Обновление локальной копии
+
+```bash
+cd ~/reverse-proxy
+git pull origin main
+```
+
+После `git pull` снова скопируйте при необходимости файлы в `/etc/haproxy/` (см. [haproxy-install.md](haproxy-install.md)).
+
+## Как не вводить логин и пароль при каждом `git pull` / `git push`
+
+### Способ 1: SSH-ключ (предпочтительно)
+
+1. Создайте ключ (имя файла можно своё):
+
+   ```bash
+   ssh-keygen -t ed25519 -C "ubuntu-haproxy" -f ~/.ssh/id_ed25519_kalinamall
+   ```
+
+   Парольную фразу можно задать или оставить пустой (на сервере оцените риски).
+
+2. Покажите **публичный** ключ и добавьте его на **git.kalinamall.ru**: профиль → **Settings** → **SSH / GPG Keys** → **Add Key**.
+
+   ```bash
+   cat ~/.ssh/id_ed25519_kalinamall.pub
+   ```
+
+3. Проверьте доступ:
+
+   ```bash
+   ssh -T git@git.kalinamall.ru
+   ```
+
+4. Клонируйте по **SSH** (или смените URL у уже существующего клона):
+
+   ```bash
+   git clone git@git.kalinamall.ru:PapaTramp/reverse-proxy.git
+   # уже склонировано по HTTPS — переключение:
+   # git remote set-url origin git@git.kalinamall.ru:PapaTramp/reverse-proxy.git
+   ```
+
+Дальше `git pull` / `git push` идут по SSH **без пароля** (при необходимости один раз вводится только passphrase ключа, если вы её задали; её можно кешировать через `ssh-agent`).
+
+### Способ 2: HTTPS + Personal Access Token (PAT)
+
+**git.kalinamall.ru** не принимает обычный пароль от аккаунта для операций `git clone` / `git pull` / `git push` по **HTTPS**. Вместо пароля нужно создать **Personal Access Token (PAT)** и вводить его там, где Git спрашивает пароль.
+
+#### Создание токена
+
+1. Войдите на **git.kalinamall.ru** под нужным аккаунтом.
+2. Откройте **Settings** (Настройки) → **Applications** (или **Access Tokens**).
+3. Создайте новый токен:
+   - **Name** — произвольное имя (например `ubuntu-haproxy-pull`), чтобы потом понимать, зачем токен.
+   - **Expiration** — срок действия (чем короче, тем безопаснее; для сервера часто выбирают ограниченный срок и потом перевыпускают).
+   - **Scopes** — для `pull`/`push` включите минимум **`read:repository`** и **`write:repository`** (или эквивалентные права на репозиторий).
+4. **Сразу скопируйте** строку токена — сервер покажет её **один раз**; после ухода со страницы повторно не отобразит.
+
+#### Использование PAT в Git на Ubuntu
+
+- **Username** (логин): ваш **логин** на git.kalinamall.ru, не e-mail, если Git явно просит username.
+- **Password**: вставьте **целиком PAT** (не пароль от сайта).
+
+Пример первого клонирования по HTTPS:
+
+```bash
+git clone https://git.kalinamall.ru/PapaTramp/reverse-proxy.git
+# при запросе: Username = ваш_логин
+#              Password = вставить PAT
+```
+
+#### Чтобы не вводить PAT каждый раз
+
+Токен хранится **в открытом виде** в `~/.git-credentials` — используйте только на **доверенных** машинах:
+
+```bash
+git config --global credential.helper store
+cd ~/reverse-proxy
+git pull origin main
+# один раз ввести Username + PAT — дальше подставятся из файла
+```
+
+Кеш в памяти на заданное время (секунды), без постоянной записи в файл:
+
+```bash
+git config --global credential.helper 'cache --timeout=28800'
+```
+
+После истечения срока кеша или срока действия токена снова создайте новый PAT и при необходимости обновите сохранённые учётные данные (удалите строчку с `git.kalinamall.ru` из `~/.git-credentials` или снова выполните `git pull` и введите новый токен).