mirror of
https://github.com/mblanke/Lottery-Tracker.git
synced 2026-03-01 14:10:22 -05:00
Version 1.1
This commit is contained in:
@@ -1,255 +1,92 @@
|
||||
# 🐋 Docker Setup Complete!
|
||||
# Docker Quick Start
|
||||
|
||||
## What's Been Created
|
||||
## What's Included
|
||||
|
||||
### Docker Files
|
||||
- ✅ `Dockerfile.backend` - Flask API with Playwright
|
||||
- ✅ `Dockerfile.frontend` - Next.js app optimized for production
|
||||
- ✅ `Dockerfile.email` - Email scheduler service
|
||||
- ✅ `docker-compose.yml` - Development setup
|
||||
- ✅ `docker-compose.prod.yml` - Production setup with nginx
|
||||
- ✅ `.dockerignore` - Optimized build context
|
||||
- ✅ `requirements.txt` - Python dependencies
|
||||
|
||||
### Configuration
|
||||
- ✅ Updated `next.config.ts` for standalone output
|
||||
- ✅ Created startup scripts (Windows & Linux)
|
||||
- ✅ Complete documentation in `DOCKER_README.md`
|
||||
- `Dockerfile.backend` — Flask API with Playwright & Chromium
|
||||
- `Dockerfile.frontend` — Next.js standalone production build
|
||||
- `docker-compose.yml` — Development setup (backend + frontend)
|
||||
- `docker-compose.prod.yml` — Production setup (+ nginx reverse proxy)
|
||||
- `nginx.conf` — Reverse proxy with rate limiting & caching
|
||||
- `.env.example` — All available environment variables
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Quick Start
|
||||
## Quick Start
|
||||
|
||||
### Option 1: Windows Script (Easiest)
|
||||
### 1. Configure
|
||||
```bash
|
||||
cp .env.example .env
|
||||
```
|
||||
|
||||
### 2. Start
|
||||
```bash
|
||||
# Windows
|
||||
docker-start.bat
|
||||
|
||||
# Linux/macOS
|
||||
./docker-start.sh
|
||||
|
||||
# Or directly
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
### Option 2: Docker Compose
|
||||
```bash
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
### Option 3: Manual Build
|
||||
```bash
|
||||
# Build
|
||||
docker-compose build
|
||||
|
||||
# Start
|
||||
docker-compose up -d
|
||||
|
||||
# Check status
|
||||
docker-compose ps
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📦 What Gets Deployed
|
||||
|
||||
### Backend Container
|
||||
- Python 3.13
|
||||
- Flask API on port 5000
|
||||
- Playwright with Chromium browser
|
||||
- Lottery scrapers for all 4 lotteries
|
||||
- Investment calculator
|
||||
- Health check endpoint
|
||||
|
||||
### Frontend Container
|
||||
- Node.js 20
|
||||
- Next.js standalone build
|
||||
- Optimized production bundle
|
||||
- Connects to backend API
|
||||
|
||||
### Email Container (Optional)
|
||||
- Runs daily at 7:00 AM
|
||||
- Sends lottery jackpot emails
|
||||
- Uses same scraping logic
|
||||
|
||||
---
|
||||
|
||||
## 🌐 Access Points
|
||||
|
||||
After running `docker-compose up -d`:
|
||||
|
||||
### 3. Open
|
||||
- **Frontend**: http://localhost:3000
|
||||
- **Backend API**: http://localhost:5000
|
||||
- **Health Check**: http://localhost:5000/api/health
|
||||
|
||||
---
|
||||
|
||||
## 📊 Container Management
|
||||
## What Gets Deployed
|
||||
|
||||
### Backend Container
|
||||
- Python 3.13 + Flask + Gunicorn (2 workers)
|
||||
- Playwright with Chromium (for Canadian lottery scraping)
|
||||
- Unified scraper for Powerball, Mega Millions, Lotto Max, Lotto 6/49
|
||||
- Investment calculator with tax, annuity, group play, break-even
|
||||
- TTL-cached jackpot data (6 hours default)
|
||||
|
||||
### Frontend Container
|
||||
- Node.js 20 + Next.js 15 standalone build
|
||||
- Material-UI dark theme
|
||||
- 6 interactive pages (Calculator, Compare, Break-Even, Annuity, Group Play, Odds)
|
||||
|
||||
### Nginx (Production Only)
|
||||
- Reverse proxy for API and frontend
|
||||
- Rate limiting (10 req/s burst 20)
|
||||
- Static asset caching (30 days)
|
||||
- HTTPS ready (see `ssl/README.md`)
|
||||
|
||||
---
|
||||
|
||||
## Common Commands
|
||||
|
||||
### View Logs
|
||||
```bash
|
||||
# All services
|
||||
docker-compose logs -f
|
||||
# View logs
|
||||
docker compose logs -f
|
||||
|
||||
# Specific service
|
||||
docker-compose logs -f backend
|
||||
docker-compose logs -f frontend
|
||||
```
|
||||
# Restart
|
||||
docker compose restart
|
||||
|
||||
### Restart Services
|
||||
```bash
|
||||
docker-compose restart
|
||||
```
|
||||
# Rebuild after code changes
|
||||
docker compose up -d --build
|
||||
|
||||
### Stop Everything
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
# Stop
|
||||
docker compose down
|
||||
|
||||
### Rebuild After Changes
|
||||
```bash
|
||||
docker-compose up -d --build
|
||||
# Production
|
||||
docker compose -f docker-compose.prod.yml up -d
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Troubleshooting
|
||||
## Troubleshooting
|
||||
|
||||
### Port Already in Use
|
||||
If ports 3000 or 5000 are busy:
|
||||
1. **Check Docker Desktop is running**
|
||||
2. **Ensure ports 3000 and 5000 are available**
|
||||
3. **Check logs**: `docker compose logs`
|
||||
4. **Rebuild**: `docker compose up -d --build`
|
||||
5. **Reset**: `docker compose down && docker compose up -d`
|
||||
|
||||
**Option A**: Stop other services
|
||||
```bash
|
||||
# Windows
|
||||
netstat -ano | findstr :3000
|
||||
taskkill /PID <PID> /F
|
||||
```
|
||||
|
||||
**Option B**: Change ports in `docker-compose.yml`
|
||||
```yaml
|
||||
ports:
|
||||
- "8080:3000" # Use port 8080 instead
|
||||
```
|
||||
|
||||
### Backend Won't Start
|
||||
```bash
|
||||
# Check logs
|
||||
docker logs lottery-backend
|
||||
|
||||
# Rebuild without cache
|
||||
docker-compose build --no-cache backend
|
||||
```
|
||||
|
||||
### Frontend Can't Connect
|
||||
Update `docker-compose.yml` frontend environment:
|
||||
```yaml
|
||||
environment:
|
||||
- NEXT_PUBLIC_API_URL=http://localhost:5000
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Include Email Scheduler
|
||||
|
||||
To run the email scheduler:
|
||||
|
||||
```bash
|
||||
docker-compose --profile email up -d
|
||||
```
|
||||
|
||||
Or remove the `profiles` section from `docker-compose.yml` to always include it.
|
||||
|
||||
---
|
||||
|
||||
## 📈 Production Deployment
|
||||
|
||||
### Use Production Compose
|
||||
```bash
|
||||
docker-compose -f docker-compose.prod.yml up -d
|
||||
```
|
||||
|
||||
### Deploy to Server
|
||||
```bash
|
||||
# On your server
|
||||
git clone <your-repo>
|
||||
cd Lottery
|
||||
docker-compose -f docker-compose.prod.yml up -d
|
||||
```
|
||||
|
||||
### Push to Docker Hub
|
||||
```bash
|
||||
# Login
|
||||
docker login
|
||||
|
||||
# Tag images
|
||||
docker tag lottery-backend yourusername/lottery-backend:latest
|
||||
docker tag lottery-frontend yourusername/lottery-frontend:latest
|
||||
|
||||
# Push
|
||||
docker push yourusername/lottery-backend:latest
|
||||
docker push yourusername/lottery-frontend:latest
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔒 Security for Production
|
||||
|
||||
1. **Use environment variables** - Don't hardcode credentials
|
||||
2. **Enable HTTPS** - Use nginx with SSL certificates
|
||||
3. **Update base images** regularly
|
||||
4. **Scan for vulnerabilities**:
|
||||
```bash
|
||||
docker scan lottery-backend
|
||||
```
|
||||
5. **Use Docker secrets** for sensitive data
|
||||
|
||||
---
|
||||
|
||||
## 💾 Data Persistence
|
||||
|
||||
Currently, containers are stateless. To add persistence:
|
||||
|
||||
Add volumes in `docker-compose.yml`:
|
||||
```yaml
|
||||
volumes:
|
||||
- ./data:/app/data
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎛️ Resource Limits
|
||||
|
||||
Current limits (production):
|
||||
- Backend: 2GB RAM, 1 CPU
|
||||
- Frontend: 512MB RAM, 0.5 CPU
|
||||
- Email: 1GB RAM, 0.5 CPU
|
||||
|
||||
Adjust in `docker-compose.prod.yml` if needed.
|
||||
|
||||
---
|
||||
|
||||
## ✅ Benefits of Docker
|
||||
|
||||
1. ✅ **Consistent environment** - Works the same everywhere
|
||||
2. ✅ **Easy deployment** - One command to start everything
|
||||
3. ✅ **Isolation** - Each service in its own container
|
||||
4. ✅ **Scalability** - Easy to scale services
|
||||
5. ✅ **Version control** - Docker images are versioned
|
||||
6. ✅ **Portability** - Deploy anywhere Docker runs
|
||||
|
||||
---
|
||||
|
||||
## 📝 Next Steps
|
||||
|
||||
1. ✅ Test locally: `docker-compose up -d`
|
||||
2. ✅ Check logs: `docker-compose logs -f`
|
||||
3. ✅ Access app: http://localhost:3000
|
||||
4. ✅ Configure email scheduler if needed
|
||||
5. ✅ Deploy to production server
|
||||
6. ✅ Set up CI/CD pipeline (optional)
|
||||
|
||||
---
|
||||
|
||||
## 🆘 Need Help?
|
||||
|
||||
See detailed documentation in:
|
||||
- `DOCKER_README.md` - Full Docker guide
|
||||
- `EMAIL_SETUP.md` - Email configuration
|
||||
- Docker logs: `docker-compose logs -f`
|
||||
|
||||
---
|
||||
|
||||
Enjoy your Dockerized Lottery Investment Calculator! 🎰🐋
|
||||
See `DOCKER_README.md` for detailed troubleshooting.
|
||||
|
||||
Reference in New Issue
Block a user