Final version
This commit is contained in:
cyrteL
367
DEPLOYMENT.md
Normal file
367
DEPLOYMENT.md
Normal file
@ -0,0 +1,367 @@
|
||||
# 🚀 Инструкции по развертыванию в продакшн
|
||||
|
||||
## 📋 Предварительные требования
|
||||
|
||||
### Системные требования
|
||||
- **Node.js** 18+ LTS
|
||||
- **MySQL** 8.0+
|
||||
- **Nginx** (рекомендуется для прокси)
|
||||
- **PM2** (для управления процессами)
|
||||
|
||||
### Минимальные характеристики сервера
|
||||
- **CPU**: 2 ядра
|
||||
- **RAM**: 4 GB
|
||||
- **Диск**: 20 GB SSD
|
||||
- **Сеть**: 100 Mbps
|
||||
|
||||
## 🔧 Установка и настройка
|
||||
|
||||
### 1. Подготовка сервера
|
||||
|
||||
```bash
|
||||
# Обновление системы
|
||||
sudo apt update && sudo apt upgrade -y
|
||||
|
||||
# Установка Node.js
|
||||
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
|
||||
sudo apt-get install -y nodejs
|
||||
|
||||
# Установка MySQL
|
||||
sudo apt install mysql-server -y
|
||||
sudo mysql_secure_installation
|
||||
|
||||
# Установка PM2
|
||||
sudo npm install -g pm2
|
||||
|
||||
# Установка Nginx
|
||||
sudo apt install nginx -y
|
||||
```
|
||||
|
||||
### 2. Настройка базы данных
|
||||
|
||||
```sql
|
||||
-- Подключение к MySQL
|
||||
sudo mysql
|
||||
|
||||
-- Создание базы данных
|
||||
CREATE DATABASE warehouse_manager CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||||
|
||||
-- Создание пользователя
|
||||
CREATE USER 'warehouse_user'@'localhost' IDENTIFIED BY 'YOUR_STRONG_PASSWORD';
|
||||
GRANT ALL PRIVILEGES ON warehouse_manager.* TO 'warehouse_user'@'localhost';
|
||||
FLUSH PRIVILEGES;
|
||||
EXIT;
|
||||
```
|
||||
|
||||
### 3. Настройка приложения
|
||||
|
||||
```bash
|
||||
# Клонирование проекта
|
||||
git clone https://github.com/your-repo/warehouse-manager.git
|
||||
cd warehouse-manager
|
||||
|
||||
# Установка зависимостей
|
||||
cd server
|
||||
npm install --production
|
||||
|
||||
# Создание production конфигурации
|
||||
cp env.production.example .env
|
||||
nano .env
|
||||
```
|
||||
|
||||
### 4. Конфигурация .env
|
||||
|
||||
```env
|
||||
# Production Environment Configuration
|
||||
NODE_ENV=production
|
||||
PORT=3001
|
||||
|
||||
# Database Configuration
|
||||
DB_HOST=127.0.0.1
|
||||
DB_PORT=3306
|
||||
DB_USER=warehouse_user
|
||||
DB_PASSWORD=YOUR_STRONG_PASSWORD
|
||||
DB_NAME=warehouse_manager
|
||||
|
||||
# Security Configuration
|
||||
JWT_SECRET=YOUR_VERY_LONG_RANDOM_SECRET_KEY_HERE
|
||||
JWT_EXPIRES_IN=8h
|
||||
|
||||
# CORS Configuration
|
||||
CORS_ORIGIN=https://your-domain.com
|
||||
CORS_CREDENTIALS=true
|
||||
|
||||
# Rate Limiting
|
||||
RATE_LIMIT_WINDOW_MS=900000
|
||||
RATE_LIMIT_MAX_REQUESTS=100
|
||||
|
||||
# Logging
|
||||
LOG_LEVEL=info
|
||||
LOG_FILE=logs/app.log
|
||||
|
||||
# Performance
|
||||
CONNECTION_LIMIT=20
|
||||
QUEUE_LIMIT=0
|
||||
```
|
||||
|
||||
### 5. Инициализация базы данных
|
||||
|
||||
```bash
|
||||
# Создание таблиц
|
||||
npm run migrate
|
||||
|
||||
# Заполнение тестовыми данными
|
||||
npm run seed
|
||||
|
||||
# ИЛИ полная настройка
|
||||
npm run setup:prod
|
||||
```
|
||||
|
||||
### 6. Настройка PM2
|
||||
|
||||
```bash
|
||||
# Создание PM2 конфигурации
|
||||
cat > ecosystem.config.js << EOF
|
||||
module.exports = {
|
||||
apps: [{
|
||||
name: 'warehouse-api',
|
||||
script: 'src/server.js',
|
||||
instances: 'max',
|
||||
exec_mode: 'cluster',
|
||||
env: {
|
||||
NODE_ENV: 'production',
|
||||
PORT: 3001
|
||||
},
|
||||
error_file: './logs/err.log',
|
||||
out_file: './logs/out.log',
|
||||
log_file: './logs/combined.log',
|
||||
time: true,
|
||||
max_memory_restart: '1G',
|
||||
restart_delay: 4000,
|
||||
max_restarts: 10
|
||||
}]
|
||||
};
|
||||
EOF
|
||||
|
||||
# Создание директории для логов
|
||||
mkdir -p logs
|
||||
|
||||
# Запуск приложения
|
||||
pm2 start ecosystem.config.js
|
||||
pm2 save
|
||||
pm2 startup
|
||||
```
|
||||
|
||||
### 7. Настройка Nginx
|
||||
|
||||
```bash
|
||||
# Создание конфигурации
|
||||
sudo nano /etc/nginx/sites-available/warehouse-manager
|
||||
```
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name your-domain.com www.your-domain.com;
|
||||
|
||||
# Редирект на HTTPS
|
||||
return 301 https://$server_name$request_uri;
|
||||
}
|
||||
|
||||
server {
|
||||
listen 443 ssl http2;
|
||||
server_name your-domain.com www.your-domain.com;
|
||||
|
||||
# SSL сертификаты (Let's Encrypt)
|
||||
ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
|
||||
ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
|
||||
|
||||
# SSL настройки
|
||||
ssl_protocols TLSv1.2 TLSv1.3;
|
||||
ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384;
|
||||
ssl_prefer_server_ciphers off;
|
||||
|
||||
# Статические файлы фронтенда
|
||||
location / {
|
||||
root /var/www/warehouse-manager;
|
||||
index index.html;
|
||||
try_files $uri $uri/ /index.html;
|
||||
|
||||
# Кэширование
|
||||
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
|
||||
expires 1y;
|
||||
add_header Cache-Control "public, immutable";
|
||||
}
|
||||
}
|
||||
|
||||
# API прокси
|
||||
location /api/ {
|
||||
proxy_pass http://localhost:3001;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection 'upgrade';
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
proxy_cache_bypass $http_upgrade;
|
||||
|
||||
# Rate limiting
|
||||
limit_req zone=api burst=20 nodelay;
|
||||
limit_req_zone $binary_remote_addr zone=api:10m rate=10r/s;
|
||||
}
|
||||
|
||||
# Безопасность
|
||||
add_header X-Frame-Options "SAMEORIGIN" always;
|
||||
add_header X-XSS-Protection "1; mode=block" always;
|
||||
add_header X-Content-Type-Options "nosniff" always;
|
||||
add_header Referrer-Policy "no-referrer-when-downgrade" always;
|
||||
add_header Content-Security-Policy "default-src 'self' http: https: data: blob: 'unsafe-inline'" always;
|
||||
}
|
||||
```
|
||||
|
||||
```bash
|
||||
# Активация конфигурации
|
||||
sudo ln -s /etc/nginx/sites-available/warehouse-manager /etc/nginx/sites-enabled/
|
||||
sudo nginx -t
|
||||
sudo systemctl reload nginx
|
||||
```
|
||||
|
||||
### 8. SSL сертификат (Let's Encrypt)
|
||||
|
||||
```bash
|
||||
# Установка Certbot
|
||||
sudo apt install certbot python3-certbot-nginx -y
|
||||
|
||||
# Получение сертификата
|
||||
sudo certbot --nginx -d your-domain.com -d www.your-domain.com
|
||||
|
||||
# Автоматическое обновление
|
||||
sudo crontab -e
|
||||
# Добавить строку: 0 12 * * * /usr/bin/certbot renew --quiet
|
||||
```
|
||||
|
||||
### 9. Развертывание фронтенда
|
||||
|
||||
```bash
|
||||
# Копирование файлов
|
||||
sudo cp -r . /var/www/warehouse-manager/
|
||||
sudo chown -R www-data:www-data /var/www/warehouse-manager/
|
||||
sudo chmod -R 755 /var/www/warehouse-manager/
|
||||
```
|
||||
|
||||
## 🔒 Безопасность
|
||||
|
||||
### Обязательные меры безопасности
|
||||
|
||||
1. **Измените пароли по умолчанию:**
|
||||
```sql
|
||||
UPDATE users SET password_hash = 'NEW_HASHED_PASSWORD' WHERE username = 'admin';
|
||||
```
|
||||
|
||||
2. **Настройте файрвол:**
|
||||
```bash
|
||||
sudo ufw enable
|
||||
sudo ufw allow ssh
|
||||
sudo ufw allow 'Nginx Full'
|
||||
sudo ufw deny 3001 # Блокируем прямой доступ к API
|
||||
```
|
||||
|
||||
3. **Регулярные обновления:**
|
||||
```bash
|
||||
# Автоматические обновления безопасности
|
||||
sudo apt install unattended-upgrades
|
||||
sudo dpkg-reconfigure -plow unattended-upgrades
|
||||
```
|
||||
|
||||
4. **Мониторинг логов:**
|
||||
```bash
|
||||
# Просмотр логов приложения
|
||||
pm2 logs warehouse-api
|
||||
|
||||
# Просмотр логов Nginx
|
||||
sudo tail -f /var/log/nginx/access.log
|
||||
sudo tail -f /var/log/nginx/error.log
|
||||
```
|
||||
|
||||
## 📊 Мониторинг и обслуживание
|
||||
|
||||
### PM2 команды
|
||||
|
||||
```bash
|
||||
# Статус приложений
|
||||
pm2 status
|
||||
|
||||
# Перезапуск
|
||||
pm2 restart warehouse-api
|
||||
|
||||
# Обновление кода
|
||||
pm2 reload warehouse-api
|
||||
|
||||
# Просмотр логов
|
||||
pm2 logs warehouse-api
|
||||
|
||||
# Мониторинг ресурсов
|
||||
pm2 monit
|
||||
```
|
||||
|
||||
### Резервное копирование
|
||||
|
||||
```bash
|
||||
# Скрипт резервного копирования
|
||||
cat > backup.sh << 'EOF'
|
||||
#!/bin/bash
|
||||
DATE=$(date +%Y%m%d_%H%M%S)
|
||||
BACKUP_DIR="/backup/warehouse-manager"
|
||||
|
||||
# Создание резервной копии БД
|
||||
mysqldump -u warehouse_user -p warehouse_manager > $BACKUP_DIR/db_$DATE.sql
|
||||
|
||||
# Сжатие
|
||||
gzip $BACKUP_DIR/db_$DATE.sql
|
||||
|
||||
# Удаление старых резервных копий (старше 30 дней)
|
||||
find $BACKUP_DIR -name "db_*.sql.gz" -mtime +30 -delete
|
||||
|
||||
echo "Backup completed: $BACKUP_DIR/db_$DATE.sql.gz"
|
||||
EOF
|
||||
|
||||
chmod +x backup.sh
|
||||
|
||||
# Добавление в cron (ежедневно в 2:00)
|
||||
echo "0 2 * * * /path/to/backup.sh" | crontab -
|
||||
```
|
||||
|
||||
## 🚨 Устранение неполадок
|
||||
|
||||
### Частые проблемы
|
||||
|
||||
1. **Приложение не запускается:**
|
||||
```bash
|
||||
pm2 logs warehouse-api
|
||||
tail -f logs/err.log
|
||||
```
|
||||
|
||||
2. **Ошибки подключения к БД:**
|
||||
```bash
|
||||
mysql -u warehouse_user -p warehouse_manager
|
||||
```
|
||||
|
||||
3. **Проблемы с Nginx:**
|
||||
```bash
|
||||
sudo nginx -t
|
||||
sudo systemctl status nginx
|
||||
```
|
||||
|
||||
4. **Проблемы с SSL:**
|
||||
```bash
|
||||
sudo certbot certificates
|
||||
sudo certbot renew --dry-run
|
||||
```
|
||||
|
||||
## 📞 Поддержка
|
||||
|
||||
При возникновении проблем:
|
||||
1. Проверьте логи: `pm2 logs warehouse-api`
|
||||
2. Проверьте статус сервисов: `pm2 status`, `sudo systemctl status nginx`
|
||||
3. Проверьте конфигурацию: `nginx -t`, `node -c src/server.js`
|
||||
Reference in New Issue
Block a user