101 lines
3.6 KiB
Markdown
101 lines
3.6 KiB
Markdown
# Инструкция по публикации сайта через SFTP
|
|
|
|
## Описание
|
|
|
|
Этот документ описывает процесс публикации сгенерированного сайта (папка `public`) на хостинге через SFTP. Решение кроссплатформенное и работает как на Unix-подобных системах (Linux/macOS), так и на Windows.
|
|
|
|
## Учетные данные и параметры подключения
|
|
|
|
Для работы используются следующие параметры:
|
|
|
|
- **Хост**: kpa39l.myjino.ru
|
|
- **Порт SFTP**: 2222
|
|
- **Пользователь**: kpa39l_dedinit
|
|
- **Пароль**: -Zp4ep747t25
|
|
- **Целевой путь**: /dedinit.ru (относительно домашнего каталога пользователя)
|
|
|
|
## Установка зависимостей
|
|
|
|
### Для Linux/macOS
|
|
|
|
- **rsync** - установите через менеджер пакетов (например, apt-get install rsync или brew install rsync)
|
|
- **Make** - для выполнения команд из Makefile
|
|
|
|
### Для Windows
|
|
|
|
- **WinSCP** - установите с официального сайта (<https://winscp.net/>)
|
|
- **Make** - можно установить через Chocolatey, MinGW или Git for Windows
|
|
|
|
## Использование Makefile
|
|
|
|
### Сборка сайта
|
|
|
|
```bash
|
|
make build
|
|
```
|
|
|
|
Команда генерирует сайт в папку `public/`.
|
|
|
|
### Деплой сайта
|
|
|
|
```bash
|
|
make deploy
|
|
```
|
|
|
|
Команда сначала собирает сайт, затем загружает содержимое папки `public/` на удаленный сервер.
|
|
|
|
Для Windows используется WinSCP.com для SFTP-подключения, для Unix-подобных систем - rsync.
|
|
|
|
### Симуляция деплоя
|
|
|
|
```bash
|
|
make deploy-dry-run
|
|
```
|
|
|
|
Команда сначала собирает сайт, затем симулирует загрузку на сервер:
|
|
|
|
- На Unix-подобных системах используется флаг `-n` для симуляции rsync
|
|
- На Windows симуляция пока не реализована, будет выведено соответствующее сообщение
|
|
|
|
### Очистка
|
|
|
|
```bash
|
|
make clean
|
|
```
|
|
|
|
Команда удаляет папку `public/`.
|
|
|
|
### Полная пересборка
|
|
|
|
```bash
|
|
make rebuild
|
|
```
|
|
|
|
Команда удаляет папку `public/`, затем заново собирает и деплоит сайт.
|
|
|
|
### Справка
|
|
|
|
```bash
|
|
make help
|
|
```
|
|
|
|
Показывает список доступных команд.
|
|
|
|
## Конфигурация
|
|
|
|
Параметры подключения находятся в файле Makefile:
|
|
|
|
- HOST - адрес сервера
|
|
- PORT - порт SFTP
|
|
- USERNAME - имя пользователя
|
|
- REMOTE_PATH - путь на удаленном сервере (относительно домашнего каталога пользователя)
|
|
|
|
При необходимости вы можете изменить эти параметры в файле Makefile.
|
|
|
|
## Настройка для Windows
|
|
|
|
Для корректной работы на Windows необходимо:
|
|
|
|
1. Убедиться, что WinSCP установлен в стандартную директорию `C:\Program Files (x86)\WinSCP\`
|
|
2. Файл `winscp_script.txt` содержит команды для подключения и синхронизации файлов
|