97 lines
4.0 KiB
Markdown
97 lines
4.0 KiB
Markdown
# Инструкция по публикации сайта через SFTP
|
||
|
||
## Описание
|
||
|
||
Этот документ описывает процесс публикации сгенерированного сайта (папка `public`) на хостинге через SFTP. Решение кроссплатформенное и работает как на Unix-подобных системах (Linux/macOS), так и на Windows.
|
||
|
||
## Учетные данные и параметры подключения
|
||
|
||
Для работы используются следующие параметры:
|
||
- **Хост**: kpa39l.myjino.ru
|
||
- **Порт SSH**: 2222
|
||
- **Пользователь**: kpa39l_dedinit
|
||
- **Пароль**: -Zp4ep747t25
|
||
- **Целевой путь**: /domains/dedinit.ru
|
||
|
||
## Установка зависимостей
|
||
|
||
### Для Linux/macOS:
|
||
- **rsync** - обычно предустановлен в большинстве систем
|
||
- **SSH-клиент** - для подключения к серверу
|
||
- **Make** - для выполнения команд из Makefile
|
||
|
||
### Для Windows:
|
||
- **WinSCP** - установите с официального сайта (https://winscp.net/)
|
||
- **PowerShell** - предустановлен в Windows 7 и выше
|
||
- **Make** - можно установить через Chocolatey, MinGW или Git for Windows
|
||
|
||
## Использование Makefile
|
||
|
||
### Сборка сайта
|
||
```bash
|
||
make build
|
||
```
|
||
Команда генерирует сайт в папку `public/`.
|
||
|
||
### Деплой сайта
|
||
```bash
|
||
make deploy
|
||
```
|
||
Команда сначала собирает сайт, затем загружает содержимое папки `public/` на удаленный сервер.
|
||
|
||
Для Windows используется PowerShell-скрипт с WinSCP, для 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 - порт SSH
|
||
- USERNAME - имя пользователя
|
||
- REMOTE_PATH - путь на удаленном сервере
|
||
|
||
При необходимости вы можете изменить эти параметры в файле Makefile.
|
||
|
||
## Настройка для Windows
|
||
|
||
Для корректной работы на Windows необходимо:
|
||
1. Установить WinSCP с официального сайта
|
||
2. По умолчанию скрипт ищет WinSCP в "C:\Program Files (x86)\WinSCP\WinSCP.exe", если у вас другой путь, измените его в файле deploy.ps1
|
||
|
||
## Настройка SSH (для Unix-подобных систем)
|
||
|
||
Для удобства рекомендуется настроить SSH-ключи для подключения к серверу. Также можно настроить подключение через SSH config, добавив в ~/.ssh/config:
|
||
|
||
```
|
||
Host myjino
|
||
HostName kpa39l.myjino.ru
|
||
Port 2222
|
||
User kpa39l_dedinit
|
||
```
|
||
|
||
После такой настройки можно будет использовать сокращенное имя хоста. |