smartsoltech_site/docs/ENV_VARIABLES.md

SmartSolTech - Environment Variables Summary

✅ Все переменные окружения для .env файла

🔐 Django Settings (обязательные)

SECRET_KEY=your-secret-key-here-change-this-in-production
DEBUG=False
ALLOWED_HOSTS=localhost,127.0.0.1,your-domain.com
CSRF_TRUSTED_ORIGINS=http://localhost:8000,https://your-domain.com

🗄️ PostgreSQL Database (обязательные)

POSTGRES_DB=smartsoltech_db
POSTGRES_USER=smartsoltech_user
POSTGRES_PASSWORD=your-strong-password-here
POSTGRES_HOST=postgres_db

🔧 PgAdmin (обязательные)

PGADMIN_DEFAULT_EMAIL=admin@smartsoltech.kr
PGADMIN_DEFAULT_PASSWORD=your-pgadmin-password

📊 Zabbix Agent (опционально)

ZBX_SERVER_HOST=your-zabbix-server-ip

🔒 Security Settings для Production (опционально)

SECURE_SSL_REDIRECT=True
SESSION_COOKIE_SECURE=True
CSRF_COOKIE_SECURE=True

📝 Настройки через админ-панель Django

Следующие настройки НЕ хранятся в .env, а настраиваются через админ-панель Django:

📱 Telegram Bot Settings

• Токен бота (от @BotFather)
• Имя бота
• Webhook URL (опционально)
• Используется скрипт update_telegram_token.py для обновления

📧 Email Settings

• SMTP сервер
• SMTP порт
• Отправитель email
• Пароль
• TLS/SSL настройки

🚀 Быстрый старт

1. Создайте .env файл:

   cp .env.example .env
   

2. Сгенерируйте SECRET_KEY:

   python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"
   

3. Отредактируйте .env:

   nano .env
   

4. Проверьте конфигурацию:

   ./check-config.sh
   

5. Запустите деплой:

   ./deploy.sh
   

📂 Созданные файлы

Конфигурационные файлы:

• ✅ .env.example - Пример переменных окружения
• ✅ docker-compose.yml - Обновлён для development
• ✅ docker-compose.prod.yml - Production конфигурация с Nginx
• ✅ Dockerfile - Обновлён с улучшениями
• ✅ nginx.conf - Конфигурация Nginx для production

Скрипты:

• ✅ deploy.sh - Автоматический деплой
• ✅ check-config.sh - Проверка конфигурации
• ✅ setup-ssl.sh - Настройка SSL сертификатов

Документация:

• ✅ DEPLOYMENT.md - Подробная документация по деплою
• ✅ ENV_VARIABLES.md - Этот файл
• ✅ settings_production.py - Дополнительные настройки для production

🔍 Изменения в коде

smartsoltech/settings.py:

• ✅ Добавлена поддержка DEBUG из .env (с приведением к bool)
• ✅ Используется python-decouple для управления переменными

docker-compose.yml:

• ✅ Добавлены health checks для всех сервисов
• ✅ Добавлены volumes для persistent storage
• ✅ Улучшены зависимости между сервисами
• ✅ Добавлены restart policies

Dockerfile:

• ✅ Установка системных зависимостей (postgresql-client, netcat)
• ✅ Улучшенная обработка статики
• ✅ Health check для контейнера
• ✅ Использование wait-for-it.sh для ожидания БД

⚠️ Важные замечания

1. Никогда не коммитьте .env файл в git! Он в .gitignore
2. В production обязательно установите DEBUG=False
3. Используйте сильные пароли для всех сервисов
4. Регулярно обновляйте зависимости
5. Настройте backup базы данных
6. Используйте HTTPS в production

🆘 Поддержка

Для получения помощи:

1. Проверьте логи: docker-compose logs -f
2. Смотрите DEPLOYMENT.md для troubleshooting
3. Используйте check-config.sh для диагностики