chore(infra): add .env.ecosystem.example for ecosystem compose
This commit is contained in:
saravanakumardb1
parent
ed17f52d14
commit
3a840572bf
@ -4,7 +4,8 @@
|
|||||||
|
|
||||||
# ── Cosmos DB (local emulator) ───────────────────────────────────
|
# ── Cosmos DB (local emulator) ───────────────────────────────────
|
||||||
COSMOS_ENDPOINT=http://cosmos-emulator:8081
|
COSMOS_ENDPOINT=http://cosmos-emulator:8081
|
||||||
COSMOS_KEY=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==
|
# Use the well-known Cosmos emulator key (see Microsoft docs)
|
||||||
|
COSMOS_KEY=
|
||||||
COSMOS_DATABASE=bytelyst
|
COSMOS_DATABASE=bytelyst
|
||||||
|
|
||||||
# ── Auth ─────────────────────────────────────────────────────────
|
# ── Auth ─────────────────────────────────────────────────────────
|
||||||
@ -13,9 +14,11 @@ RATE_LIMIT_STORE_MODE=datastore
|
|||||||
|
|
||||||
# ── Azure Blob Storage (Azurite emulator) ────────────────────────
|
# ── Azure Blob Storage (Azurite emulator) ────────────────────────
|
||||||
STORAGE_PROVIDER=azure
|
STORAGE_PROVIDER=azure
|
||||||
AZURE_BLOB_CONNECTION_STRING=DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite:10000/devstoreaccount1;
|
# Use the well-known Azurite default connection string (see Microsoft docs)
|
||||||
|
AZURE_BLOB_CONNECTION_STRING=
|
||||||
AZURE_BLOB_ACCOUNT_NAME=devstoreaccount1
|
AZURE_BLOB_ACCOUNT_NAME=devstoreaccount1
|
||||||
AZURE_BLOB_ACCOUNT_KEY=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==
|
# Use the well-known Azurite default account key (see Microsoft docs)
|
||||||
|
AZURE_BLOB_ACCOUNT_KEY=
|
||||||
AZURE_BLOB_PUBLIC_ENDPOINT=http://localhost:10000/devstoreaccount1
|
AZURE_BLOB_PUBLIC_ENDPOINT=http://localhost:10000/devstoreaccount1
|
||||||
|
|
||||||
# ── Email (Mailpit sandbox) ──────────────────────────────────────
|
# ── Email (Mailpit sandbox) ──────────────────────────────────────
|
||||||
|
|||||||
1
.gitignore
vendored
1
.gitignore
vendored
@ -9,6 +9,7 @@ coverage/
|
|||||||
.env.bak
|
.env.bak
|
||||||
.env.local
|
.env.local
|
||||||
.env.*.local
|
.env.*.local
|
||||||
|
.env.ecosystem
|
||||||
*.pem
|
*.pem
|
||||||
*.p12
|
*.p12
|
||||||
*.pfx
|
*.pfx
|
||||||
|
|||||||
209
docs/devops/ECOSYSTEM_DEPLOYMENT.md
Normal file
209
docs/devops/ECOSYSTEM_DEPLOYMENT.md
Normal file
@ -0,0 +1,209 @@
|
|||||||
|
# Ecosystem Deployment Guide
|
||||||
|
|
||||||
|
> **File:** `docker-compose.ecosystem.yml`
|
||||||
|
> **Purpose:** Run the entire ByteLyst ecosystem in a single Docker Compose stack.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
1. **Docker Desktop** with Compose v2+
|
||||||
|
2. All product repos cloned as siblings of `learning_ai_common_plat`:
|
||||||
|
|
||||||
|
```
|
||||||
|
~/code/mygh/
|
||||||
|
├── learning_ai_common_plat/ # This repo
|
||||||
|
├── learning_voice_ai_agent/ # LysnrAI
|
||||||
|
├── learning_multimodal_memory_agents/ # MindLyst
|
||||||
|
├── learning_ai_clock/ # ChronoMind
|
||||||
|
├── learning_ai_jarvis_jr/ # JarvisJr
|
||||||
|
├── learning_ai_fastgap/ # NomGap
|
||||||
|
├── learning_ai_peakpulse/ # PeakPulse
|
||||||
|
├── learning_ai_flowmonk/ # FlowMonk
|
||||||
|
├── learning_ai_notes/ # NoteLett
|
||||||
|
├── learning_ai_trails/ # ActionTrail
|
||||||
|
└── learning_ai_local_memory_gpt/ # LocalMemGPT
|
||||||
|
```
|
||||||
|
|
||||||
|
3. `@bytelyst/*` packages built (for platform-service / extraction-service):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd learning_ai_common_plat
|
||||||
|
pnpm -r --filter './packages/*' build
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quick Start
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd learning_ai_common_plat
|
||||||
|
|
||||||
|
# 1. Create env file from example
|
||||||
|
cp .env.ecosystem.example .env.ecosystem
|
||||||
|
# Edit .env.ecosystem — fill in Stripe keys, Gemini key, etc.
|
||||||
|
|
||||||
|
# 2. Validate compose config
|
||||||
|
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem config --quiet
|
||||||
|
|
||||||
|
# 3. Build and start everything
|
||||||
|
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem up --build -d
|
||||||
|
|
||||||
|
# 4. Check health
|
||||||
|
docker compose -f docker-compose.ecosystem.yml ps
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Port Map
|
||||||
|
|
||||||
|
### Infrastructure
|
||||||
|
|
||||||
|
| Service | Port | URL |
|
||||||
|
|---------|------|-----|
|
||||||
|
| Cosmos DB Emulator | 8081 | http://localhost:8081 |
|
||||||
|
| Cosmos Data Explorer | 1234 | http://localhost:1234 |
|
||||||
|
| Azurite (Blob) | 10000 | http://localhost:10000 |
|
||||||
|
| Mailpit SMTP | 1025 | — |
|
||||||
|
| Mailpit UI | 8025 | http://localhost:8025 |
|
||||||
|
| Loki | 3100 | http://localhost:3100 |
|
||||||
|
| Grafana | 3000 | http://localhost:3000 |
|
||||||
|
| Traefik Dashboard | 8080 | http://localhost:8080 |
|
||||||
|
|
||||||
|
### Platform Services
|
||||||
|
|
||||||
|
| Service | Port | URL |
|
||||||
|
|---------|------|-----|
|
||||||
|
| platform-service | 4003 | http://localhost:4003/health |
|
||||||
|
| extraction-service | 4005 | http://localhost:4005/health |
|
||||||
|
| mcp-server | 4007 | http://localhost:4007/health |
|
||||||
|
|
||||||
|
### Platform Dashboards
|
||||||
|
|
||||||
|
| Dashboard | Port | URL |
|
||||||
|
|-----------|------|-----|
|
||||||
|
| Admin Console | 3001 | http://localhost:3001 |
|
||||||
|
| Issue Tracker | 3003 | http://localhost:3003 |
|
||||||
|
|
||||||
|
### Product Backends
|
||||||
|
|
||||||
|
| Product | Port | URL |
|
||||||
|
|---------|------|-----|
|
||||||
|
| PeakPulse | 4010 | http://localhost:4010/health |
|
||||||
|
| ChronoMind | 4011 | http://localhost:4011/health |
|
||||||
|
| JarvisJr | 4012 | http://localhost:4012/health |
|
||||||
|
| NomGap | 4013 | http://localhost:4013/health |
|
||||||
|
| MindLyst | 4014 | http://localhost:4014/health |
|
||||||
|
| LysnrAI | 4015 | http://localhost:4015/health |
|
||||||
|
| NoteLett | 4016 | http://localhost:4016/health |
|
||||||
|
| FlowMonk | 4017 | http://localhost:4017/health |
|
||||||
|
| ActionTrail | 4018 | http://localhost:4018/health |
|
||||||
|
| LocalMemGPT | 4019 | http://localhost:4019/health |
|
||||||
|
|
||||||
|
### Product Web Apps
|
||||||
|
|
||||||
|
| Product | Port | URL |
|
||||||
|
|---------|------|-----|
|
||||||
|
| LysnrAI Dashboard | 3002 | http://localhost:3002 |
|
||||||
|
| ChronoMind | 3030 | http://localhost:3030 |
|
||||||
|
| JarvisJr | 3035 | http://localhost:3035 |
|
||||||
|
| FlowMonk | 3040 | http://localhost:3040 |
|
||||||
|
| NoteLett | 3045 | http://localhost:3045 |
|
||||||
|
| MindLyst | 3050 | http://localhost:3050 |
|
||||||
|
| NomGap | 3055 | http://localhost:3055 |
|
||||||
|
| ActionTrail | 3060 | http://localhost:3060 |
|
||||||
|
| LocalMemGPT | 3070 | http://localhost:3070 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Selective Startup
|
||||||
|
|
||||||
|
You don't need to run everything. Use Docker Compose profiles or just name services:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Infrastructure + platform only
|
||||||
|
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem up -d \
|
||||||
|
cosmos-emulator azurite mailpit loki grafana gateway \
|
||||||
|
platform-service extraction-service mcp-server \
|
||||||
|
admin-web tracker-web
|
||||||
|
|
||||||
|
# Infrastructure + platform + one product
|
||||||
|
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem up -d \
|
||||||
|
cosmos-emulator azurite mailpit platform-service \
|
||||||
|
flowmonk-backend flowmonk-web
|
||||||
|
|
||||||
|
# Just backends (no web apps)
|
||||||
|
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem up -d \
|
||||||
|
cosmos-emulator azurite mailpit platform-service extraction-service \
|
||||||
|
flowmonk-backend notelett-backend actiontrail-backend
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Teardown
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Stop all
|
||||||
|
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem down
|
||||||
|
|
||||||
|
# Stop and remove volumes (clean slate)
|
||||||
|
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem down -v
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Cosmos emulator slow to start
|
||||||
|
The emulator needs 20-30s on first boot. Other services wait via `depends_on: condition: service_healthy`.
|
||||||
|
|
||||||
|
### Port conflicts
|
||||||
|
If a port is already in use (e.g., Grafana on 3000), either stop the conflicting process or override the host port:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Override in .env.ecosystem or via CLI
|
||||||
|
docker compose -f docker-compose.ecosystem.yml --env-file .env.ecosystem up -d \
|
||||||
|
-e GRAFANA_PORT=3099
|
||||||
|
```
|
||||||
|
|
||||||
|
### LocalMemGPT needs Ollama
|
||||||
|
LocalMemGPT connects to Ollama on the host via `host.docker.internal:11434`. Make sure Ollama is running locally.
|
||||||
|
|
||||||
|
### Build failures for product repos
|
||||||
|
Product Dockerfiles use the Gitea npm registry for `@bytelyst/*` packages. If building on a fresh machine, ensure:
|
||||||
|
1. `GITEA_NPM_TOKEN` is set in your environment
|
||||||
|
2. Gitea is running at `localhost:3300`
|
||||||
|
3. All 49 `@bytelyst/*` packages are published
|
||||||
|
|
||||||
|
See `docs/devops/GITEA_NPM_REGISTRY_MIGRATION.md` for details.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────────────────────┐
|
||||||
|
│ Traefik Gateway (:80) │
|
||||||
|
└──────┬──────────────┬──────────────┬────────────────────────┘
|
||||||
|
│ │ │
|
||||||
|
┌────▼────┐ ┌─────▼─────┐ ┌────▼────┐
|
||||||
|
│Platform │ │Extraction │ │ MCP │
|
||||||
|
│ :4003 │ │ :4005 │ │ :4007 │
|
||||||
|
└────┬────┘ └───────────┘ └─────────┘
|
||||||
|
│
|
||||||
|
┌────▼────────────────────────────────────────────────┐
|
||||||
|
│ 10 Product Backends │
|
||||||
|
│ :4010-4019 (PeakPulse…LocalMemGPT) │
|
||||||
|
└────┬────────────────────────────────────────────────┘
|
||||||
|
│
|
||||||
|
┌────▼────────────────────────────────────────────────┐
|
||||||
|
│ 9 Product Web Apps │
|
||||||
|
│ :3002, :3030-3070 │
|
||||||
|
└─────────────────────────────────────────────────────┘
|
||||||
|
│
|
||||||
|
┌────▼────────────────────────────────────────────────┐
|
||||||
|
│ Infrastructure │
|
||||||
|
│ Cosmos :8081 Azurite :10000 Mailpit :1025/8025 │
|
||||||
|
│ Loki :3100 Grafana :3000 │
|
||||||
|
└─────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
Loading…
Reference in New Issue
Block a user