Files
headquarter/openspec/changes/deployment-config/proposal.md
T
alex 78aaddb2b5
CI / Web CI (push) Failing after 12s
CI / API CI (push) Failing after 1m1s
docs(openspec): add OpenSpec changes for FN-005, FN-006, FN-008, FN-009, FN-010
- Add frontend-foundation change (FN-005) with 46 tasks
- Add deployment-config change (FN-006) with 27 tasks
- Add runfusion-poc/opencode-poc change (FN-008) with 25 tasks
- Add config-secrets change (FN-009) with 31 tasks
- Add codeserver-spawn change (FN-010) with 38 tasks
- Include project specsheet and configuration
- Archive completed deployment-config change
2026-05-14 17:35:20 +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