djd 1.0.0

A tool for managing Django + AWS ECS deployments

djd

djd is a command line tool for creating and managing Django + AWS ECS deployments. It wraps Terraform, AWS (via Boto3), Docker, Git, and GitHub to coordinate running deployments, building and uploading Docker images, and accessing infrastructure from the terminal.

Installation

pip install djd

Usage

Creating a deployment

This package includes templates for a canonical ECS web deployment architecture. Run the following command to scaffold a named deployment in your project's repository. (Recommended: commit the generated files.)

djd-templates init {deployment_name}

To see all configuration options, append --help.

ECS Services

To visualize running / configured ECS services:

djd {deployment_name} show-services

You will get a table that shows each ECS service's ID, name, latest deployment indicator, task counts, status, and rollout state:

Deployment Status

  Deployment ID                    Service                          Latest       Created On                  Count             Status            Rollout State
 ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  ecs-svc/0938446537801788686      deploy-staging-web               *            2025-10-24 12:30:48 PM      0 -> 1 / 1        Primary           Completed
  ecs-svc/2070367854272485563      deploy-staging-worker            *            2025-10-24 12:30:48 PM      0 -> 0 / 0        Primary           Completed

To visualize individual tasks on the cluster:

djd {deployment_name} show-tasks

Task Status

  Task ID                            Task Definition ID     Created At               Health Status          Status
 ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  b21dc0a1442740c5a00930a64d6b00cd   deploy-staging-web:2   2025-10-24 12:31:06 PM   Unknown                Running