dedinit.ru/DEPLOY_INSTRUCTIONS.md

Инструкция по публикации сайта через 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

Сборка сайта

make build

Команда генерирует сайт в папку public/.

Деплой сайта

make deploy

Команда сначала собирает сайт, затем загружает содержимое папки public/ на удаленный сервер.

Для Windows используется PowerShell-скрипт с WinSCP, для Unix-подобных систем - rsync.

Симуляция деплоя

make deploy-dry-run

Команда сначала собирает сайт, затем симулирует загрузку на сервер:

• На Unix-подобных системах используется флаг -n для симуляции rsync
• На Windows симуляция пока не реализована, будет выведено соответствующее сообщение

Очистка

make clean

Команда удаляет папку public/.

Полная пересборка

make rebuild

Команда удаляет папку public/, затем заново собирает и деплоит сайт.

Справка

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

После такой настройки можно будет использовать сокращенное имя хоста.