Skip to content

services.md

Latest commit

 

History

History
183 lines (139 loc) · 5.95 KB

services.md

File metadata and controls

183 lines (139 loc) · 5.95 KB
Raw

Service Catalog

A.R.C. provides 29 pre-configured services across 4 categories. Each service has a codename and maps to industry-standard technology.

Quick Reference

# List all services
arc services list

# Filter by category
arc services list --role infrastructure

# Get service details
arc services info heimdall

# View dependency tree
arc services deps sherlock

# Check port allocations
arc services ports

Infrastructure Services

Codename Technology Ports Description
heimdall Traefik v3.0 80, 443, 8080 API Gateway and reverse proxy
jarvis Kratos v1.1 4433, 4434 Identity and authentication
nick-fury Infisical 8082 Secrets management
mystique Unleash 4242 Feature flags
dr-strange Pulsar 6650, 8083 Event streaming
the-flash NATS 4222, 8222, 6222 High-speed messaging
hedwig Postal 25, 587, 8084 Email delivery
t-800 ChaosMesh 2333 Chaos engineering

Data Services

Codename Technology Ports Description
oracle PostgreSQL 16 5432 Relational database
sonic Redis 7 6379 In-memory cache
cerebro Qdrant 6333, 6334 Vector database
tardis MinIO 9000, 9001 S3-compatible storage
pathfinder Migrate - Schema migrations

AI Services

Codename Technology Ports Dependencies Description
sherlock LangGraph 8000 oracle, sonic, cerebro AI reasoning agent
robocop RuleGo 8001 sherlock Safety guardrails
gordon-ramsay QACritic 8002 sherlock Quality assessment
ivan-drago AdversarialTrainer 8003 sherlock Red team training
uhura SemanticTranslator 8004 cerebro Language translation
statham SelfHealing 8005 sherlock, dr-house Auto-repair
the-wolf OpsJanitor 8006 sherlock Operations cleanup
alfred BillingManager 8007 oracle Cost management
sentry MediaIngress 1935, 5060 - Media streaming
scribe SessionRecorder 8008 tardis Session recording

Observability Services

Codename Technology Ports Description
black-widow OpenTelemetry 4317, 4318 Telemetry collection
dr-house Prometheus 9090 Metrics
watson Loki 3100 Log aggregation
friday Grafana 3000 Visualization dashboard
columbo Tempo 3200, 9411 Distributed tracing
hermes Promtail - Log shipping

Service Aliases

Services can be accessed by codename or technology:

arc services info postgres     # → oracle
arc services info traefik      # → heimdall
arc services info redis        # → sonic
arc services info grafana      # → friday

Dependency Resolution

When enabling a service, dependencies are automatically included:

arc services deps sherlock

Output:

sherlock (LangGraph)
├── oracle (PostgreSQL)
├── sonic (Redis)
└── cerebro (Qdrant)

Start Order:
1. oracle
2. sonic
3. cerebro
4. sherlock

Port Allocation

Range Usage
25, 587 SMTP (hedwig)
80, 443 HTTP/HTTPS (heimdall)
1935 RTMP (sentry)
2333 Chaos Dashboard (t-800)
3000-3200 Web UIs (friday, watson, columbo)
4222-4434 APIs (the-flash, jarvis, mystique)
5060 SIP (sentry)
5432 PostgreSQL (oracle)
6222-6379 Messaging/Cache (the-flash, sonic)
6333-6650 Vector/Events (cerebro, dr-strange)
8000-8084 AI/Admin APIs
9000-9411 Storage/Metrics (tardis, dr-house, columbo)

JSON Output

All commands support JSON for scripting:

arc services list --json
arc services info heimdall --json
arc services deps sherlock --json
arc services ports --json

Configuration Files

Many services require config files, generated from embedded templates:

arc services info heimdall

Shows required configuration files like traefik.yml, dynamic.yml.

Environment Variables

Database (oracle)

POSTGRES_USER=arc
POSTGRES_PASSWORD=your-password
POSTGRES_DB=arc

Identity (jarvis)

DSN=postgres://...
SECRETS_COOKIE=your-cookie-secret
SECRETS_CIPHER=your-cipher-secret

Secrets (nick-fury)

ENCRYPTION_KEY=your-encryption-key
JWT_SECRET=your-jwt-secret

AI (sherlock)

LLM_API_KEY=sk-your-api-key
LLM_MODEL=gpt-4

Visualization (friday)

GF_SECURITY_ADMIN_USER=admin
GF_SECURITY_ADMIN_PASSWORD=your-password