177 lines
3.2 KiB
Markdown
177 lines
3.2 KiB
Markdown
# Jobs App - Docker Deployment
|
|
|
|
This application is a Craigslist job scraper with a Flask web interface.
|
|
|
|
## Quick Start with Docker
|
|
|
|
### Prerequisites
|
|
|
|
- Docker
|
|
- Docker Compose
|
|
|
|
### Deployment
|
|
|
|
1. **Clone the repository and navigate to the project directory**
|
|
|
|
```bash
|
|
cd /path/to/jobs-app/jobs
|
|
```
|
|
|
|
2. **Start the application**
|
|
|
|
```bash
|
|
docker-compose up --build -d
|
|
```
|
|
|
|
3. **Wait for services to be ready** (about 30 seconds)
|
|
|
|
```bash
|
|
# Check if the app is running
|
|
curl http://localhost:8000
|
|
```
|
|
|
|
4. **Access the application**
|
|
- Main app: http://localhost:8000
|
|
- Admin interface: http://localhost:8000/admin/users
|
|
- Username: `admin`
|
|
- Password: `M11ffpgm.`
|
|
- Scraper interface: http://localhost:8000/scrape-page
|
|
|
|
## Docker Architecture
|
|
|
|
### Services
|
|
|
|
- **jobs-app**: Flask application with Gunicorn WSGI server
|
|
- **mysql**: MySQL 8.0 database
|
|
|
|
### Ports
|
|
|
|
- 8000: Flask application
|
|
- 3306: MySQL database (exposed for external access if needed)
|
|
|
|
### Volumes
|
|
|
|
- `mysql_data`: Persistent MySQL data storage
|
|
|
|
## Configuration
|
|
|
|
### Environment Variables
|
|
|
|
- `FLASK_ENV`: Set to `production`
|
|
- `FLASK_SECRET`: Secret key for Flask sessions
|
|
|
|
### Database Configuration
|
|
|
|
The database configuration is in `config/settings.json`:
|
|
|
|
```json
|
|
{
|
|
"database": {
|
|
"mysql": {
|
|
"host": "mysql",
|
|
"user": "jobs",
|
|
"password": "jobdb",
|
|
"database": "jobs",
|
|
"port": 3306
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Useful Commands
|
|
|
|
```bash
|
|
# View logs
|
|
docker-compose logs -f
|
|
|
|
# Stop services
|
|
docker-compose down
|
|
|
|
# Restart services
|
|
docker-compose restart
|
|
|
|
# Rebuild and restart
|
|
docker-compose up --build
|
|
|
|
# View running containers
|
|
docker-compose ps
|
|
|
|
# Execute commands in the app container
|
|
docker-compose exec jobs-app bash
|
|
|
|
# Check database
|
|
docker-compose exec mysql mysql -u jobs -p jobs
|
|
```
|
|
|
|
## Production Considerations
|
|
|
|
1. **Security**:
|
|
|
|
- Change default passwords in `docker-compose.yml`
|
|
- Use environment variables for secrets
|
|
- Configure proper firewall rules
|
|
|
|
2. **Scaling**:
|
|
|
|
- Adjust Gunicorn workers in `gunicorn.conf.py`
|
|
- Consider using a reverse proxy (nginx)
|
|
- Implement proper logging and monitoring
|
|
|
|
3. **Database**:
|
|
|
|
- Use external MySQL for production
|
|
- Configure backups
|
|
- Set up connection pooling
|
|
|
|
4. **Networking**:
|
|
- Use proper domain names
|
|
- Configure SSL/TLS
|
|
- Set up load balancing if needed
|
|
|
|
## Troubleshooting
|
|
|
|
### Common Issues
|
|
|
|
1. **Port conflicts**: Change ports in `docker-compose.yml`
|
|
2. **Database connection**: Ensure MySQL container is healthy
|
|
3. **Memory issues**: Increase Docker memory limits
|
|
4. **Permission issues**: Check file permissions in mounted volumes
|
|
|
|
### Logs
|
|
|
|
```bash
|
|
# Application logs
|
|
docker-compose logs jobs-app
|
|
|
|
# Database logs
|
|
docker-compose logs mysql
|
|
|
|
# All logs
|
|
docker-compose logs
|
|
```
|
|
|
|
## Development
|
|
|
|
For development with hot reload:
|
|
|
|
```bash
|
|
# Run in development mode
|
|
docker-compose -f docker-compose.dev.yml up --build
|
|
```
|
|
|
|
Create `docker-compose.dev.yml`:
|
|
|
|
```yaml
|
|
version: "3.8"
|
|
services:
|
|
jobs-app:
|
|
build: .
|
|
ports:
|
|
- "8000:8000"
|
|
environment:
|
|
- FLASK_ENV=development
|
|
volumes:
|
|
- .:/app
|
|
command: ["flask", "run", "--host", "0.0.0.0", "--port", "8000"]
|
|
```
|