djd 0.1.0__tar.gz

djd-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Zagaran, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

djd-0.1.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: djd
+Version: 0.1.0
+Summary: A tool for managing Django + AWS ECS deployments
+Author-email: Matthew Coleman <matthew@zagaran.com>
+License: MIT
+Project-URL: Homepage, https://github.com/zagaran/djd
+Project-URL: Repository, https://github.com/zagaran/djd
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3>=1.26.0
+Requires-Dist: django>=4.2
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: ipython>=8.0.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pygithub>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pytz>=2023.3
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://cdn-icons-png.flaticon.com/512/5731/5731863.png" width=256 />
+</p>
+
+## djd
+
+**djd** is a command line tool for creating and managing Django + AWS ECS deployments. It wraps
+Terraform, AWS (via [Boto3](https://github.com/boto/boto3)), Docker, Git, and GitHub to coordinate
+running deployments, building and uploading Docker images, and accessing infrastructure from the terminal.
+
+## Installation
+
+```bash
+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.)
+
+```bash
+djd-templates init {deployment_name}
+```
+
+To see all configuration options, append `--help`.
+
+### ECS Services
+
+To visualize running / configured ECS services:
+
+```bash
+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:
+
+```bash
+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
+
+```

djd-0.1.0/README.md

@@ -0,0 +1,63 @@
+<p align="center">
+  <img src="https://cdn-icons-png.flaticon.com/512/5731/5731863.png" width=256 />
+</p>
+
+## djd
+
+**djd** is a command line tool for creating and managing Django + AWS ECS deployments. It wraps
+Terraform, AWS (via [Boto3](https://github.com/boto/boto3)), Docker, Git, and GitHub to coordinate
+running deployments, building and uploading Docker images, and accessing infrastructure from the terminal.
+
+## Installation
+
+```bash
+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.)
+
+```bash
+djd-templates init {deployment_name}
+```
+
+To see all configuration options, append `--help`.
+
+### ECS Services
+
+To visualize running / configured ECS services:
+
+```bash
+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:
+
+```bash
+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
+
+```

djd-0.1.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "djd"
+version = "0.1.0"
+description = "A tool for managing Django + AWS ECS deployments"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = [
+    "boto3>=1.26.0",
+    "django>=4.2",
+    "gitpython>=3.1.0",
+    "ipython>=8.0.0",
+    "jinja2>=3.1.0",
+    "pygithub>=2.0.0",
+    "python-dotenv>=1.0.0",
+    "pytz>=2023.3",
+    "rich>=13.0.0",
+    "typer>=0.9.0",
+]
+authors = [
+  { name="Matthew Coleman", email="matthew@zagaran.com" }
+]
+
+[project.urls]
+Homepage = "https://github.com/zagaran/djd"
+Repository = "https://github.com/zagaran/djd"
+
+[project.scripts]
+djd = "deploy.cli.deploy:main"
+djd-templates = "deploy.cli.templates:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+deploy = ["templates/**/*"]
+
+[dependency-groups]
+dev = [
+    "autopep8>=2.3.2",
+    "basedpyright>=1.31.7",
+    "django-stubs>=5.2.7",
+    "ipdb>=0.13.13",
+    "pre-commit>=4.3.0",
+    "setuptools>=80.9.0",
+]

djd-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

djd-0.1.0/src/deploy/__init__.py

@@ -0,0 +1,3 @@
+from deploy.logging import initialize_logging
+
+initialize_logging(log_name="deploy")

djd-0.1.0/src/deploy/aws.py

@@ -0,0 +1,108 @@
+import logging
+import os
+import pty
+import subprocess
+import traceback
+
+from botocore.exceptions import BotoCoreError, ClientError
+
+from deploy.config import AWS_REGION
+
+
+def describe_service_deployments(client, cluster: str, services: list[str]):
+    describe_services_response = client.describe_services(cluster=cluster, services=services)
+
+    all_deployment_updates = []
+    for response in describe_services_response["services"]:
+        service_name = response["serviceName"]
+        deployment_updates = response["deployments"]
+        latest_deployment_id = next(reversed(sorted(deployment_updates, key=lambda x: x["createdAt"])))["id"]
+
+        for deployment_update in deployment_updates:
+            deployment_update["service"] = service_name
+            deployment_update["is_latest"] = latest_deployment_id == deployment_update["id"]
+            all_deployment_updates.append(deployment_update)
+
+    return all_deployment_updates
+
+
+def describe_service_tasks(client, cluster: str, services: list[str] | None = None):
+    task_ids = []
+    if services:
+        for service in services:
+            list_tasks_response = client.list_tasks(cluster=cluster, serviceName=service)
+            task_ids += list_tasks_response["taskArns"]
+    else:
+        list_tasks_response = client.list_tasks(cluster=cluster)
+        task_ids += list_tasks_response["taskArns"]
+
+    tasks = []
+    if task_ids:
+        describe_tasks_response = client.describe_tasks(cluster=cluster, tasks=task_ids)
+        tasks = describe_tasks_response["tasks"]
+
+    return tasks
+
+
+def execute_command(client, command: str, cluster: str, service: str, interactive: bool = False):
+    list_tasks_response = client.list_tasks(cluster=cluster, serviceName=service)
+    task_ids = list_tasks_response["taskArns"]
+
+    # TODO: exec command in most recent task (sort first)
+
+    if len(task_ids):
+        task_id = task_ids[0]
+
+        logging.info("Starting Interactive Session...")
+        cmd = ["aws", "ecs", "execute-command", "--cluster", cluster, "--region",
+               AWS_REGION, "--task", task_id, "--interactive", "--command", f"'{command}'"]
+        logging.info(f'Running Command: \n"{(" ").join(cmd)}"')
+
+        try:
+            if interactive:
+                pty.spawn(cmd)
+            else:
+                subprocess.run(
+                    cmd,
+                    check=True,
+                    text=True,
+                    capture_output=True
+                )
+
+        except subprocess.CalledProcessError as e:
+            traceback.print_exception(e)
+            logging.error("Command failed")
+
+    else:
+        logging.info("No running task")
+
+
+def copy_ecr_image(
+    client,
+    source_repo_name: str,
+    target_repo_name: str,
+    image_tag: str = "latest",
+):
+    try:
+        # Get the image manifest from the source repo
+        get_response = client.batch_get_image(repositoryName=source_repo_name, imageIds=[{"imageTag": image_tag}])
+
+        if not get_response["images"]:
+            raise RuntimeError("Image not found in source repo")
+
+        image = get_response["images"][0]
+        manifest = image["imageManifest"]
+        media_type = image.get("imageManifestMediaType", "application/vnd.docker.distribution.manifest.v2+json")
+
+        # Push the manifest to the target repo
+        client.put_image(
+            repositoryName=target_repo_name,
+            imageManifest=manifest,
+            imageTag=image_tag,
+            imageManifestMediaType=media_type,
+        )
+
+    except (ClientError, BotoCoreError):
+        return False
+
+    return True