Deployment Guide

Deployment Guide

Production deployment guide for Claude Code Agent Monitor. This document covers every supported deployment path — from a single Docker container to a fully orchestrated, multi-cloud Kubernetes deployment with blue-green releases, automated canary analysis, and comprehensive observability.

Architecture Overview

graph TB
  subgraph "Internet"
    U[Users / Browsers]
  end

  subgraph "Edge Layer"
    LB[Load Balancer
TLS Termination
WebSocket Upgrade]
  end

  subgraph "Compute Layer"
    subgraph "Blue Slot"
      B1[Dashboard Pod 1]
      B2[Dashboard Pod 2]
      B3[Dashboard Pod N]
    end
    subgraph "Green Slot"
      G1[Dashboard Pod 1]
      G2[Dashboard Pod 2]
      G3[Dashboard Pod N]
    end
  end

  subgraph "MCP Sidecar"
    MCP1[MCP Server]
  end

  subgraph "Persistence"
    PV[(SQLite on
Persistent Volume)]
  end

  subgraph "Observability"
    PROM[Prometheus]
    GRAF[Grafana]
    ALERT[Alertmanager]
    CX[Coralogix]
    OTEL[OTel Collector]
  end

  U --> LB
  LB -->|Active| B1 & B2 & B3
  LB -.->|Standby| G1 & G2 & G3
  B1 --- MCP1
  B1 & B2 & B3 --> PV
  PROM -->|Scrape| B1 & B2 & B3
  PROM --> ALERT
  OTEL -->|Ship logs, metrics, traces| CX
  B1 & B2 & B3 --> OTEL
  GRAF --> PROM

Deployment Methods

Three deployment methods are supported, each targeting different operational maturity levels:

flowchart LR
  Start([Choose Method]) --> Q1{Have
Kubernetes?}
  Q1 -->|No| Docker["🐳 Docker Compose
Simplest path"]
  Q1 -->|Yes| Q2{Need
IaC?}
  Q2 -->|No| Q3{Prefer
templating?}
  Q2 -->|Yes| TF["🏗️ Terraform
Full cloud provisioning"]
  Q3 -->|Helm| Helm["⎈ Helm Chart
Parameterized installs"]
  Q3 -->|Raw YAML| Kust["📦 Kustomize
Overlay-based patching"]

  style Docker fill:#0db7ed,color:#fff
  style Helm fill:#0f1689,color:#fff
  style Kust fill:#326ce5,color:#fff
  style TF fill:#7b42bc,color:#fff

Method	Best For	Prerequisites	Cloud Agnostic
Docker Compose	Local dev, single-server	Docker	✅
Helm	Teams with Kubernetes	helm, kubectl	✅
Kustomize	GitOps, raw YAML fans	kustomize, kubectl	✅
Terraform	Full infra provisioning	terraform	✅ AWS/GCP/Azure/OCI

---

Quick Start: Docker Compose

The fastest path to a running production instance:

# Build and start everything
docker compose up -d --build

# Verify
curl http://localhost:4820/api/health
# → {"status":"ok","timestamp":"..."}

# View logs
docker compose logs -f

The included `docker-compose.yml` at the project root runs the dashboard on port `4820` with a persistent `./data` volume for SQLite.

---

Helm Deployment

Prerequisites

# Verify tools
helm version    # >= 3.12
kubectl version # >= 1.27

Install

# From the repository root:
cd deployments/helm/agent-monitor

# Dev environm