hdspace-devspace

Secure container-based cloud development environment for HDSPACE-DEV.

Overview

hdspace-devspace provides on-demand, secure development environments running in containers. Developers get a full workspace with their IDE, tools, and project files, accessible from anywhere.

Inspired by Gitpod and Coder.

Architecture

┌──────────┐     ┌────────────┐     ┌────────────┐
│ dashboard│────▶│ ws-manager │────▶│ ws-daemon  │
│ (Web UI) │     │ (control)  │     │ (node)     │
└──────────┘     └────────────┘     └────────────┘
                       │                    │
                       ▼                    ▼
                 ┌──────────┐      ┌──────────────┐
                 │ws-proxy  │      │  workspace   │
                 │(ingress) │      │  container   │
                 └──────────┘      │  + supervisor│
                                   └──────────────┘

Components

Component	Role	Language	Binary	Description
ws-manager	manager	Go	ws-manager	Workspace CRUD, lifecycle management
ws-daemon	daemon	Go	ws-daemon	Node-side container/VM lifecycle
ws-proxy	proxy	Go	ws-proxy	Ingress proxy, port forwarding
image-builder	builder	Go	image-builder	Workspace image building
supervisor	supervisor	Go	supervisor	Container init process (PID 1)
cli	—	Go	devspace-cli	Command-line client
dashboard	—	TypeScript	—	Web console

Quick Start

make build COMPONENT=ws-manager
make test COMPONENT=ws-manager

Project Structure

hdspace-devspace/
├── components/
│   ├── ws-manager/       # Workspace lifecycle management
│   ├── ws-daemon/        # Node-side daemon
│   ├── ws-proxy/         # Traffic proxy
│   ├── image-builder/    # Image building service
│   ├── supervisor/       # Container PID 1
│   ├── cli/              # CLI client
│   └── dashboard/        # Web console
├── install/              # Helm charts
├── docs/                 # Architecture + ADR
├── scripts/
├── .github/workflows/    # CI per component (path-filtered)
├── Makefile              # Root orchestration
└── go.work               # Go workspace

License

MIT — see LICENSE.