Files
headquarter/openspec/changes/archive/2026-05-14-deployment-config/proposal.md
T
alex 8b4784f5ed
CI / Web CI (push) Failing after 10s
CI / API CI (push) Failing after 11s
chore(openspec): archive completed changes
- Archive config-secrets (FN-009) - 31 tasks complete
- Archive runfusion-poc (FN-008) - 25 tasks complete
- Archive deployment-config (FN-006) - 27 tasks complete
- All changes moved to openspec/changes/archive/
2026-05-16 11:33:37 +02:00

1.6 KiB

Why

The scaffold provides local Docker Compose development (FN-002) but lacks production deployment configuration. Without Traefik label generation and production stacks, tool instances cannot receive HTTPS subdomains, blocking the core value proposition of the platform.

What Changes

  • Traefik label generator: Backend service that generates Docker labels for subdomain routing based on tool instance metadata
  • Production Docker Compose stack: docker-compose.prod.yml with API, web, Traefik, and PostgreSQL services
  • Portainer stack definition: Docker Compose file optimized for Portainer deployment
  • Dynamic subdomain routing: Automatic Traefik rule generation for spawned tool containers
  • HTTPS configuration: Let's Encrypt or custom certificate support via Traefik
  • Network isolation: Separate Docker networks for platform and tool containers

Capabilities

New Capabilities

  • traefik-label-generator: Generate Traefik Docker labels for tool subdomain routing
  • production-compose-stack: Production Docker Compose configuration
  • portainer-deployment: Portainer-friendly stack definition and deployment guide
  • subdomain-routing: Dynamic HTTPS subdomain allocation for tool instances

Modified Capabilities

  • None (this extends the existing deployment skeleton)

Impact

  • apps/api/app/services/: New Traefik label generation service
  • apps/api/app/routers/tool_instances.py: Integrate label generation on spawn
  • deploy/: New production deployment files
  • docker-compose.prod.yml: Production stack definition
  • docs/deployment.md: Updated deployment instructions