Files
softclick-landing/scripts/docs/DEPLOYMENT.md
2026-04-02 23:35:06 +03:00

164 lines
5.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🚀 Инструкции по деплою SOFTCLICK
Этот документ содержит все способы публикации вашего сайта.
## 🎯 Быстрый старт
### Локальная сборка
```bash
# 1. Установите зависимости
npm install
# 2. Соберите проект
npm run build
# 3. Папка dist/ (или build/) содержит готовый сайт
```
**⚠️ Важно:** Vite может создать папку `dist` или `build` в зависимости от конфигурации. Проверьте, какая папка создаётся после `npm run build`.
---
## 📌 Рекомендуемые платформы
### ⭐ 1. Netlify (САМЫЙ ПРОСТОЙ)
**✅ Плюсы:** Бесплатно, автоматический деплой, HTTPS, CDN
**⏱ Время настройки:** 2 минуты
**Инструкция:**
1. Регистрация: https://netlify.com
2. "Add new site" → "Import an existing project"
3. Выберите ваш Git-репозиторий
4. Netlify автоматически найдет `netlify.toml`
5. Нажмите "Deploy" - готово! 🎉
**Автоматизация:** При каждом пуше в репозиторий сайт обновляется автоматически.
---
### ⭐ 2. Cloudflare Pages (САМЫЙ БЫСТРЫЙ)
**✅ Плюсы:** Бесплатно, очень быстрый CDN, неограниченный трафик
**⏱ Время настройки:** 3 минуты
**Инструкция:**
1. Регистрация: https://pages.cloudflare.com
2. "Create a project" → подключите Git
3. Настройки:
- Build command: `npm run build`
- Build output: `dist`
4. Deploy - готово! 🎉
---
### ⭐ 3. GitHub Pages (100% БЕСПЛАТНО)
**✅ Плюсы:** Полностью бесплатно навсегда
**⏱ Время настройки:** 1 минута
**Инструкция:**
1. Запушьте код в GitHub
2. Settings → Pages → Source: "GitHub Actions"
3. Готово! Автоматический деплой настроен 🎉
**URL:** `https://username.github.io/repository-name`
---
## 🇷🇺 Российские платформы
### 4. Яндекс.Облако (ИМПОРТОЗАМЕЩЕНИЕ)
**✅ Плюсы:** Российская платформа, Object Storage + CDN
**💰 Стоимость:** ~50-200 ₽/месяц
**⏱ Время настройки:** 10 минут
**Подробная инструкция:** См. файл `deploy-yandex-cloud.md`
**Быстрая настройка:**
```bash
# 1. Установите Yandex Cloud CLI
curl -sSL https://storage.yandexcloud.net/yandexcloud-yc/install.sh | bash
# 2. Создайте бакет
yc storage bucket create --name softclick-website --public-read
# 3. Соберите и загрузите
npm run build
yc storage s3api sync ./dist/ s3://softclick-website/
```
---
### 5. Традиционный хостинг
**Подходит для:** Timeweb, Beget, Reg.ru, HostiMan
**💰 Стоимость:** от 120 ₽/месяц
**Подробная инструкция:** См. файл `deploy-traditional-hosting.md`
**Краткая версия:**
1. Соберите проект: `npm run build`
2. Загрузите содержимое папки `dist/` на хостинг через FTP
3. Файл `.htaccess` уже готов и настроен
4. Готово! 🎉
---
## 🛠 Автоматизация
### Автоматический деплой при пуше в Git
**GitHub Actions готовы для:**
- ✅ GitHub Pages → `.github/workflows/deploy.yml`
- ✅ Яндекс.Облако → `.github/workflows/deploy-yandex.yml`
**Настройка GitHub Actions для Яндекс.Облако:**
1. Создайте сервисный аккаунт в Yandex Cloud
2. Добавьте секреты в GitHub:
- `YC_SERVICE_ACCOUNT_KEY_JSON` - ключ сервисного аккаунта
- `YC_BUCKET_NAME` - название бакета
3. При пуше в main автоматически загрузится на Яндекс.Облако
---
## 📋 Сравнительная таблица
| Платформа | Цена | Скорость настройки | Автодеплой | Российская |
|-----------|------|-------------------|------------|------------|
| Netlify | Бесплатно | ⚡⚡⚡ 2 мин | ✅ | ❌ |
| Cloudflare Pages | Бесплатно | ⚡⚡⚡ 3 мин | ✅ | ❌ |
| GitHub Pages | Бесплатно | ⚡⚡⚡ 1 мин | ✅ | ❌ |
| Яндекс.Облако | ~100₽/мес | ⚡⚡ 10 мин | ✅ | ✅ |
| Timeweb/Beget | от 120₽/мес | ⚡ 15 мин | ❌ | ✅ |
---
## 🎯 Рекомендации
**Для быстрого запуска:** Netlify или Cloudflare Pages
**Для 100% бесплатно:** GitHub Pages
**Для импортозамещения:** Яндекс.Облако
**Для полного контроля:** Свой VPS + Nginx
---
## 🆘 Помощь
**Не работает сборка?**
```bash
# Очистите кеш и пересоберите
rm -rf node_modules dist
npm install
npm run build
```
**Проблемы с роутингом?**
- Проверьте наличие `.htaccess` (Apache) или настройки Nginx
- На платформах типа Netlify/Cloudflare это работает автоматически
**Белый экран после деплоя?**
- Проверьте консоль браузера (F12)
- Убедитесь что загружены все файлы из `dist/`
---
## 📞 Контакты
При возникновении проблем с деплоем - проверьте логи сборки на выбранной платформе.