Deployment System Guide

This guide details the lifecycle of a deployment in Docklift, from source code to running container.

Core Services

• projects.ts: Manages Project CRUD and triggers deployments.
• deployments.ts: Manages deployment history, logs, and streaming deploy/stop/restart/redeploy.
• docker.ts: Wrapper for dockerode to control containers and stream compose operations.
• compose.ts: Generates docker-compose.yml files dynamically (scans Dockerfiles, detects ports).
• git.ts: Handles cloning (git clone) and pulling (fetch + hard reset + clean) repositories.

Deployment Lifecycle

1. Trigger:
   • Manual (UI button) or Webhook (GitHub push).
   • POST /api/deployments/:projectId/deploy.