In this guide, we'll walk through the easiest and fastest way to deploy a full-featured Django application—including real-time chat and background task processing—to the cloud using Defang. You'll see firsthand how simple Defang makes it to deploy apps that require multiple services like web servers, background workers, Redis, and Postgres.
Clone the repo
Before we get started, you'll want to clone the repo with the app code, here.
Overview of Our Django Application
We're deploying a real-time chat application that includes automatic moderation powered by a background worker using the Natural Language Toolkit (NLTK). The application structure includes:
- Web Service: Django app with chat functionality using Django Channels for real-time interactions.
- Worker Service: Background tasks processing messages for profanity and sentiment analysis.
- Postgres Database: Managed database instance for persistent storage.
- Redis Broker: Managed Redis instance serving as the broker for Celery tasks and Django Channels.
Running Locally
To run the app locally, we use Docker Compose, splitting configurations into two YAML files:
compose.yaml: Production configuration.compose.dev.yaml: Development overrides extending production.
You can quickly spin up the application locally with:
docker compose --env-file .env.dev -f compose.dev.yaml up --build
This runs things with autoreloading so you can iterate on the Django app, all while passing environment variables in the same way as we will with Defang's secure configuration system and being ready to deploy to production.
Application Features
Real-time Chat
Using Django Channels and Redis, users can engage in real-time conversations within chat rooms.
Background Moderation Tasks
The worker service runs independently, handling moderation tasks asynchronously. It uses NLTK to:
- Check for profanity.
- Perform sentiment analysis.
- Automatically flag negative or inappropriate messages.
This decouples resource-intensive tasks from the main API server, ensuring optimal application responsiveness. The demo isn't doing anything very complicated, but you could easily run machine learning models with access to GPUs with Defang if you needed to.
Django Admin
The Django admin is setup to quickly visualize messages and their moderation status. Access it at /admin with your superuser credentials: username admin and password admin setup by default when you first run or deploy.
Deploying with Defang
Deploying multi-service applications to cloud providers traditionally involves complex infrastructure setup, including configuring ECS clusters, security groups, networking, and more. Defang simplifies this significantly.
Deploying to Defang Playground
The Defang Playground lets you quickly preview your deployed app in a managed environment.
Secure Configuration
Before deploying, securely set encrypted sensitive values:
defang config set DJANGO_SECRET_KEY
defang config set POSTGRES_PASSWORD
Then run the deployment command:
defang compose up
Defang automatically:
- Builds Docker containers.
- Sets up required services.
- Manages networking and provisioning.
Once deployed, your app is accessible via a public URL provided by Defang, which you can find in the CLI output or in our portal at https://portal.defang.io
Deploying to Your Own Cloud
To deploy directly into your AWS account (or other supported providers):
- Set your cloud provider:
In my case, I use an AWS Profile, but you should be able to use any methods supported by the AWS CLI
export DEFANG_PROVIDER=AWS
export AWS_PROFILE=your-profile-name
Secure Configuration
Before deploying, securely set encrypted sensitive values in your cloud account:
defang config set DJANGO_SECRET_KEY
defang config set POSTGRES_PASSWORD
- Deploy:
defang compose up
Defang handles provisioning managed services (RDS for Postgres, ElastiCache for Redis), container builds, and networking setup. Note: Initial provisioning for managed data stores might take a few minutes.
Cloud Deployment Results
Post-deployment, your Django app infrastructure includes (among other things):
- Managed Postgres: AWS RDS instance.
- Managed Redis: AWS ElastiCache instance.
- Containers: ECS services with load balancers and DNS configured.
Why Use Defang?
Defang simplifies complex cloud deployments by:
- Automatically provisioning managed cloud resources.
- Securely handling sensitive configurations.
- Providing seamless container orchestration without manual infrastructure setup.
Try It Yourself
Explore deploying your Django applications effortlessly with Defang. The full source code for this example is available on GitHub. Feel free to give it a try, and let us know how it goes!
Happy deploying!
