81 lines
3.0 KiB
Markdown
81 lines
3.0 KiB
Markdown
# Инструкция по публикации сайта через 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
|
|
```
|
|
|
|
После такой настройки можно будет использовать сокращенное имя хоста. |