Configuration Reference

# cascade.yaml
version: "1.0"
environment: production
 
# Platform settings
platform:
  name: "loan-processor"
  namespace: default
  replicas: 3
  
  # Resource limits
  resources:
    requests:
      cpu: 500m
      memory: 512Mi
    limits:
      cpu: 2000m
      memory: 2Gi
 
# Database
database:
  driver: postgres
  host: postgres.default.svc.cluster.local
  port: 5432
  name: cascade_db
  ssl_mode: require
  max_connections: 20
  connection_timeout: 10s
 
# Redis (for caching, sessions)
cache:
  driver: redis
  host: redis.default.svc.cluster.local
  port: 6379
  database: 0
  ttl: 1h
 
# Temporal (workflow engine)
temporal:
  host: temporal.default.svc.cluster.local
  port: 7233
  namespace: default
  task_queue: cascade_tasks
 
# Observability
observability:
  tracing:
    enabled: true
    provider: jaeger
    endpoint: http://jaeger.default.svc.cluster.local:14268
  metrics:
    enabled: true
    provider: prometheus
    port: 9090
  logs:
    provider: loki
    endpoint: http://loki.default.svc.cluster.local:3100
 
# Security
security:
  auth:
    provider: kratos  # OAuth, Kratos
    endpoint: http://kratos.default.svc.cluster.local
  authorization:
    provider: spicedb
    endpoint: spicedb.default.svc.cluster.local:50051
  encryption:
    enabled: true
    key_provider: vault
    endpoint: http://vault.default.svc.cluster.local:8200

# Minimal local setup
environment: development
log_level: debug
database:
  driver: sqlite
  path: ./cascade.db
cache:
  driver: memory  # In-memory cache
temporal:
  host: localhost
  port: 7233

# Pre-production
environment: staging
log_level: info
replicas: 2
database:
  driver: postgres
  ssl_mode: prefer
temporal:
  namespace: staging

# High availability
environment: production
log_level: warn
replicas: 3
database:
  driver: postgres
  max_connections: 50
  ssl_mode: require
temporal:
  namespace: production
security:
  encryption:
    enabled: true
  authorization:
    provider: spicedb

cascade app apply \
  --file app.yaml \
  --namespace default \
  --replicas 3 \
  --wait

cascade process start \
  --app myapp \
  --workflow ProcessOrder \
  --input '{"order_id":"123"}' \
  --timeout 10m

database:
  max_connections: 20      # Concurrent connections
  idle_timeout: 30s        # Close idle after 30s
  max_lifetime: 5m         # Max connection lifetime

cache:
  ttl: 1h                  # Default TTL
  max_entries: 10000       # Max cached items
  eviction: lru            # Eviction policy

temporal:
  activity_workers: 10     # Parallel activities
  max_concurrent_activities: 100

# Workflow metrics
cascade_workflow_duration_seconds
cascade_workflow_errors_total
cascade_workflow_active

# Activity metrics
cascade_activity_duration_seconds
cascade_activity_errors_total

# System metrics
cascade_database_connections
cascade_cache_hit_rate
cascade_memory_bytes_total

alerts:
  - name: HighErrorRate
    condition: "rate(cascade_errors_total[5m]) > 0.05"
    action: page
  
  - name: DatabaseLatency
    condition: "cascade_db_latency_ms > 100"
    action: notify
  
  - name: WorkflowTimeout
    condition: "cascade_workflow_duration_seconds > 3600"
    action: escalate

auth:
  provider: kratos
  endpoints:
    admin: http://kratos-admin:80
    public: http://kratos-public:80
  session:
    timeout: 24h
    refresh_enabled: true

authorization:
  provider: spicedb
  relationships:
    - user:alice can view:app:1
    - user:bob can admin:app:1

encryption:
  enabled: true
  algorithm: AES-256-GCM
  key_rotation:
    enabled: true
    interval: 90d

logging:
  level: info
  format: json           # json or text
  output: stdout         # stdout, file, both
  file:
    path: /var/log/cascade.log
    max_size: 100M
    max_age: 30d
    max_backups: 5

# Set environment
export CASCADE_ENV=production
export DATABASE_URL=postgres://...
export TEMPORAL_HOST=temporal.default
 
# Start application
cascade start --config cascade.yaml
 
# Apply application
cascade app apply -f app.yaml
 
# Check status
cascade system status