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_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
|
||||
|
||||
# ── Auth ─────────────────────────────────────────────────────────
|
||||
@ -13,9 +14,11 @@ RATE_LIMIT_STORE_MODE=datastore
|
||||
|
||||
# ── Azure Blob Storage (Azurite emulator) ────────────────────────
|
||||
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_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
|
||||
|
||||
# ── Email (Mailpit sandbox) ──────────────────────────────────────
|
||||
|
||||
1
.gitignore
vendored
1
.gitignore
vendored
@ -9,6 +9,7 @@ coverage/
|
||||
.env.bak
|
||||
.env.local
|
||||
.env.*.local
|
||||
.env.ecosystem
|
||||
*.pem
|
||||
*.p12
|
||||
*.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