Add deployment files and update README

2026-02-01 10:59:37 +03:00
parent f834d08a7f
commit d443d0b676
3 changed files with 131 additions and 1 deletions
@@ -0,0 +1,81 @@
+# Инструкция по публикации сайта через rsync
+
+## Описание
+
+Этот документ описывает процесс публикации сгенерированного сайта (папка `public`) на хостинге через `rsync`.
+
+## Учетные данные и параметры подключения
+
+Для работы используются следующие параметры, задаваемые в Makefile:
+- **Хост**: kpa39l.myjino.ru
+- **Порт SSH**: 2222
+- **Пользователь**: kpa39l_dedinit
+- **Целевой путь**: /domains/dedinit.ru
+
+## Установка зависимостей
+
+Для работы скрипта деплоя требуются:
+1. **rsync** - обычно предустановлен в большинстве Linux-систем, для Windows может потребоваться установка через Git Bash или WSL
+2. **SSH-клиент** - для подключения к серверу
+3. **Make** - для выполнения команд из Makefile
+
+## Использование Makefile
+
+### Сборка сайта
+```bash
+make build
+```
+Команда генерирует сайт в папку `public/`.
+
+### Деплой сайта
+```bash
+make deploy
+```
+Команда сначала собирает сайт, затем загружает содержимое папки `public/` на удаленный сервер.
+
+### Симуляция деплоя
+```bash
+make deploy-dry-run
+```
+Команда сначала собирает сайт, затем симулирует загрузку на сервер без фактического копирования файлов.
+
+### Очистка
+```bash
+make clean
+```
+Команда удаляет папку `public/`.
+
+### Полная пересборка
+```bash
+make rebuild
+```
+Команда удаляет папку `public/`, затем заново собирает и деплоит сайт.
+
+### Справка
+```bash
+make help
+```
+Показывает список доступных команд.
+
+## Конфигурация
+
+Все параметры подключения находятся в начале файла Makefile:
+- HOST - адрес сервера
+- PORT - порт SSH
+- USERNAME - имя пользователя
+- REMOTE_PATH - путь на удаленном сервере
+
+При необходимости вы можете изменить эти параметры в файле Makefile.
+
+## Настройка SSH
+
+Для удобства рекомендуется настроить SSH-ключи для подключения к серверу. Также можно настроить подключение через SSH config, добавив в ~/.ssh/config:
+
+```
+Host myjino
+    HostName kpa39l.myjino.ru
+    Port 2222
+    User kpa39l_dedinit
+```
+
+После такой настройки можно будет использовать сокращенное имя хоста.