- Separated settings for different environments
- Docker
- Different docker-compose for different environments
- CI/CD
- Local dev: to develop on your PC without Docker. Use
manage.pyas always. - Docker dev: to develop on your PC using a more production-like environment with a MySQL database. Auto-reload is enabled and every change in the
appfolder is applied to/appin the container and vice versa. Requirements are installed at build time and migrations are applied at boot but you can do that manually. - Staging: like production but with admin and debug enabled for testing purposes.
- Production: the deployed version.
- create a file named
.envcontaining the required environment variables (read the next section) - run
docker-compose up --build - work with your local files
- execute commands inside the container. ex
docker exec -it django-whitelabel-app_1 python manage.py makemigrations
| Local Dev | Docker Dev | Staging | Production | |
|---|---|---|---|---|
| Auto-reload | ✅ | ✅ | ❌ | ❌ |
| Auto migrate at start | ✅ | ✅ | ✅ | ✅ |
| Auto requirements install at start | ✅ | ✅ | ✅ | ✅ |
| Database | SQLite | MariaDB | MariaDB | MariaDB |
| Database port publically exposed | Not present | ✅ | ❌ | ❌ |
| Reverse proxy (Nginx) | ❌ | ❌ | ✅ | ✅ |
| Debug | ✅ | ✅ | ✅ | ❌ |
| Admin page | ✅ | ✅ | ✅ | ❌ (can be enabled in settings/production) |
| Serving media automatically | ✅ | ✅ | ❌ | ❌ |
| CORS allow all | ✅ | ✅ | ❌ | ❌ |
| CSRF allow all | ✅ | ✅ | ❌ | ❌ |
| Allow all hosts | ✅ | ✅ | ❌ | ❌ |
- ✅ Required
- ❌ Not required
⚠️ Optional
| Local Dev | Docker Dev | Staging | Production | |
|---|---|---|---|---|
| MYSQL_PASSWORD | ✅ | ✅ | ✅ | ✅ |
| SECRET_KEY (default string for dev) | ✅ | ✅ | ||
| ALLOWED_HOSTS (all for dev) | ❌ | ❌ | ✅ | ✅ |
| CORS_ALLOWED_ORIGINS (all for dev) | ❌ | ❌ | ✅ | ✅ |
| CSRF_TRUSTED_ORIGINS (all for dev) | ❌ | ❌ | ✅ | ✅ |
| EMAIL_HOST | ||||
| EMAIL_HOST_PASSWORD | ||||
| EMAIL_HOST_USER | ||||
| EMAIL_PORT (default EMAIL_PORT) |
MYSQL_PASSWORD=somerandomstring
SECRET_KEY=anotherrandomstring
EMAIL_HOST=smtp.gmail.com
EMAIL_HOST_PASSWORD=gmailpassword
[email protected]
EMAIL_PORT=587
ALLOWED_HOSTS=localhost,127.0.0.1,api.something.it
CORS_ALLOWED_ORIGINS=https://frontend.com,https://sub.frontend.com
CSRF_TRUSTED_ORIGINS=https://api.app.com,https://app.com,https://*.otherdomain.com
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent