247 lines
9.9 KiB
Markdown
247 lines
9.9 KiB
Markdown
# Ghaymah Cloud: V1 vs V2 — Comprehensive Comparison
|
|
|
|
> Generated: 2026-10-22
|
|
> Based on hands-on testing of both platform versions
|
|
|
|
---
|
|
|
|
## Quick Comparison Matrix
|
|
|
|
| Aspect | V1 (Console) | V2 (Deploy) | Winner |
|
|
|--------|:-----------:|:-----------:|:------:|
|
|
| Dashboard | console.cumin.dev | deploy.ghaymah.systems | V2 |
|
|
| CLI Tool | ❌ None | ✅ `gy` CLI | V2 |
|
|
| Managed Databases | ❌ | ✅ PostgreSQL | V2 |
|
|
| Object Storage | ❌ | ✅ S3 Buckets | V2 |
|
|
| AI Integration | ❌ | ✅ LiteLLM | V2 |
|
|
| Templates | ❌ | ✅ 22 Templates | V2 |
|
|
| Documentation | ❌ Limited | ✅ Full Docs Site | V2 |
|
|
| Service Mesh | ✅ CoreDNS | ✅ CoreDNS | Tie |
|
|
| Security Headers | ❓ Unknown | ❌ Missing | Neither |
|
|
| GraphQL API | ✅ 49 MCP tools | ✅ 41 Mutations | Tie |
|
|
|
|
---
|
|
|
|
## 1. Architecture Comparison
|
|
|
|
### V1 Architecture
|
|
```
|
|
console.cumin.dev (React SPA)
|
|
└── api.cumin.dev (MCP/REST Backend, 49 tools)
|
|
└── graphql.ghaymah.systems (Hasura GraphQL)
|
|
└── PostgreSQL (internal)
|
|
└── Kubernetes Cluster
|
|
├── CoreDNS (10.43.0.10:53)
|
|
├── Per-project namespaces
|
|
└── Kaniko/BuildKit (container builds)
|
|
```
|
|
|
|
### V2 Architecture
|
|
```
|
|
deploy.ghaymah.systems (React 19 SPA, Vite)
|
|
├── auth.ghaymah.systems (Hasura Auth, JWT)
|
|
├── graphql.ghaymah.systems (Hasura GraphQL)
|
|
│ ├── 15 Queries, 41 Mutations, 22 Subscriptions
|
|
│ └── WebSocket streaming for real-time updates
|
|
├── genai.ghaymah.systems (LiteLLM AI Gateway)
|
|
├── status.ghaymah.systems (Status Page)
|
|
├── logs.ghaymah.systems (Centralized Logging)
|
|
├── registry.ghaymah.systems (Container Registry)
|
|
├── cliv2.ghaymah.systems (CLI Distribution)
|
|
├── docs.ghaymah.cloud (Documentation, Starlight/Astro)
|
|
└── Kubernetes Cluster
|
|
├── CoreDNS (service discovery)
|
|
├── Helm Charts (ghaymah-project, ghaymah-app)
|
|
├── S3-compatible Object Storage
|
|
├── Managed PostgreSQL
|
|
└── App hosting on *.hosted.cumin.dev
|
|
```
|
|
|
|
---
|
|
|
|
## 2. Feature-by-Feature Comparison
|
|
|
|
### Core Features
|
|
| Feature | V1 | V2 | Notes |
|
|
|---------|:--:|:--:|-------|
|
|
| Container Apps | ✅ | ✅ | V2 adds friendly name-based management |
|
|
| Static Apps | ❌ | ✅ | **NEW** — Dedicated static site hosting |
|
|
| Projects | ✅ | ✅ | Both use Helm chart `ghaymah-project` |
|
|
| Public URL | ✅ | ✅ | V1: `*.hosted.ghaymah.systems`, V2: `*.hosted.cumin.dev` |
|
|
| Custom Domains | ❌ | ❌ | Neither supports custom domains |
|
|
| Environment Vars | ✅ | ✅ | V2 adds `is_secret` and `file_path` options |
|
|
| Resource Tiers | t1 only | t1-t7 | V2 has 7 tiers |
|
|
| App Instances | 1 | 1+ | V2 supports scaling |
|
|
| Health Checks | ❌ | ✅ | **NEW** — Port-level health monitoring |
|
|
| App Tags | ❌ | ✅ | **NEW** — Key/value metadata |
|
|
|
|
### Managed Services (All New in V2)
|
|
| Service | V1 | V2 | Details |
|
|
|---------|:--:|:--:|---------|
|
|
| **S3 Storage** | ❌ | ✅ | Managed buckets, scoped access keys, key rotation |
|
|
| **Persistent Volumes** | ❌ | ✅ | Disk that survives restarts, mountable into apps |
|
|
| **Managed PostgreSQL** | ❌ | ✅ | Production DB with connection URL |
|
|
| **Secrets** | ❌ | ✅ | Encrypted, write-only key-value store |
|
|
| **Pull Secrets** | ❌ | ✅ | Private registry credentials |
|
|
|
|
### Developer Experience
|
|
| Feature | V1 | V2 | Notes |
|
|
|---------|:--:|:--:|-------|
|
|
| CLI Tool | ❌ | ✅ `gy` | Auto stack detection, one-command deploy |
|
|
| Tunnels | ❌ | ✅ | Expose localhost to internet |
|
|
| JSON Output | ❌ | ✅ | `--json` flag on every CLI command |
|
|
| Friendly Names | ❌ UUID-based | ✅ `my-api` | No more memorizing UUIDs |
|
|
| Live Config Updates | ❌ Redeploy needed | ✅ `gy config` | Change env/ports without redeploy |
|
|
| App Logs (API) | ❌ | ✅ `appLogs` | Programmatic log access |
|
|
| Documentation | ❌ | ✅ Full site | docs.ghaymah.cloud (Starlight/Astro) |
|
|
|
|
### AI & Automation
|
|
| Feature | V1 | V2 | Notes |
|
|
|---------|:--:|:--:|-------|
|
|
| GenAI Gateway | ❌ | ✅ LiteLLM | Multi-model AI access with budget controls |
|
|
| AI Assistant | ❌ | ✅ `/assistant` | Built-in chat AI in dashboard |
|
|
| Store Templates | ❌ | ✅ 22 templates | One-click deploy for popular apps |
|
|
| Workflow Automation | ❌ | ✅ n8n template | Available via store |
|
|
| Monitoring | ❌ | ✅ Grafana template | Available via store |
|
|
|
|
### Platform & Business
|
|
| Feature | V1 | V2 | Notes |
|
|
|---------|:--:|:--:|-------|
|
|
| Teams | ❌ | ✅ | Multi-user collaboration |
|
|
| Billing | ❌ | ✅ | Payment management, plan upgrades |
|
|
| User Plans | ❌ | ✅ | Free plan: 5 max resources, 1 active app |
|
|
| Status Page | ❌ | ✅ | Public service status monitoring |
|
|
| Integrations | ❌ | ✅ | Third-party service integrations |
|
|
|
|
---
|
|
|
|
## 3. API Comparison
|
|
|
|
### V1 API (MCP/REST — 49 Tools)
|
|
```
|
|
api.cumin.dev
|
|
├── REST endpoints
|
|
└── GraphQL (graphql.ghaymah.systems)
|
|
└── insert_ghaymah_cloud_resources_one (main method)
|
|
```
|
|
|
|
### V2 API (GraphQL — 41 Mutations)
|
|
```
|
|
graphql.ghaymah.systems/v1/graphql
|
|
├── Queries (15): resource, store, plan, genai queries
|
|
├── Mutations (41): CRUD for apps, static, postgres, s3, volumes, secrets
|
|
└── Subscriptions (22): Real-time streams for all resources
|
|
```
|
|
|
|
### Key API Differences
|
|
|
|
| Aspect | V1 | V2 |
|
|
|--------|-----|-----|
|
|
| **Resource Model** | `name, image, port, protocol, subdomain` fields | `chart_name, chart_version, values (JSON blob)` |
|
|
| **App Creation** | `insert_ghaymah_cloud_resources_one` only | `createApp` mutation with typed `CreateAppInput` |
|
|
| **Data Model** | Flat fields per resource | JSON `values` blob (flexible schema) |
|
|
| **Subscriptions** | None | WebSocket subscriptions on all tables |
|
|
| **Auth** | Token-based (custom) | JWT (Hasura Auth, HS256, 900s expiry) |
|
|
| **Pagination** | Not visible | Hasura-standard `limit/offset/order_by` |
|
|
|
|
---
|
|
|
|
## 4. Networking Comparison
|
|
|
|
| Aspect | V1 | V2 |
|
|
|--------|-----|-----|
|
|
| **Internal DNS** | CoreDNS (10.43.0.10:53) | CoreDNS (Kubernetes cluster) |
|
|
| **Service Discovery** | `<name>.<namespace>.svc.cluster.local` | Same K8s DNS pattern |
|
|
| **Public Domain** | `*.hosted.ghaymah.systems` | `*.hosted.cumin.dev` ⚠️ |
|
|
| **Protocol Support** | HTTP, TCP (Redis RESP verified) | HTTP, TCP |
|
|
| **TLS** | Yes (Let's Encrypt) | Yes (Let's Encrypt) |
|
|
| **Backend Isolation** | HTTP 404 from public (partial) | Via Hasura RLS + K8s network policies |
|
|
| **Raw TCP** | Verified (Redis RESP protocol) | Port-level health checks available |
|
|
|
|
> ⚠️ **Key Finding**: V2 apps are hosted on `cumin.dev` domain instead of `ghaymah.systems`, revealing the underlying infrastructure change.
|
|
|
|
---
|
|
|
|
## 5. Security Comparison
|
|
|
|
| Security Aspect | V1 | V2 |
|
|
|----------------|:--:|:--:|
|
|
| **Auth Method** | Custom token | JWT (HS256, Hasura Auth) |
|
|
| **Token Expiry** | Unknown | 900s (15 min) ✅ |
|
|
| **IDOR Protection** | Partial (cross-project lateral movement found) | ✅ Row-level security (Hasura RLS) |
|
|
| **SQL Injection** | Not tested | ✅ Parameterized queries |
|
|
| **Cross-User Access** | ⚠️ Lateral movement possible | ✅ Blocked by user_id RLS |
|
|
| **Rate Limiting (Auth)** | Not tested | ✅ 429 enforced |
|
|
| **Rate Limiting (API)** | Not detected | ⚠️ Not detected |
|
|
| **CORS** | Not tested | Not fully tested |
|
|
| **GraphQL Introspection** | N/A | ⚠️ Fully exposed (148 types) |
|
|
| **Security Headers** | Not tested | ❌ All 5 missing |
|
|
| **Billing Enforcement** | Not tested | ✅ Server-side enforced |
|
|
|
|
### V1 Security Issues Found (Previous Testing)
|
|
1. Cross-project lateral movement between tenants
|
|
2. Backend services accessible from public (HTTP 404 but reachable)
|
|
3. Raw TCP Redis protocol accessible within mesh
|
|
|
|
### V2 Security Improvements
|
|
1. ✅ Hasura Row-Level Security prevents cross-user access
|
|
2. ✅ Auth rate limiting (429 on rapid requests)
|
|
3. ✅ Billing enforcement prevents free plan abuse
|
|
4. ⚠️ Still needs: security headers, introspection restriction, API rate limiting
|
|
|
|
---
|
|
|
|
## 6. Store Templates (New in V2)
|
|
|
|
V2 introduces a **marketplace** of 22 one-click deployable applications:
|
|
|
|
| Category | Templates |
|
|
|----------|-----------|
|
|
| **Development** | Code Server, WordPress, Memos, DocuSeal, Twenty CRM |
|
|
| **Database** | PostgreSQL, MariaDB, ChromaDB, Valkey, PgBouncer, MeiliBridge, Hasura GraphQL, Metabase |
|
|
| **Automation** | n8n, Uptime Kuma |
|
|
| **Monitoring** | Grafana |
|
|
| **Productivity** | IT Tools, Mini QR, Stirling PDF |
|
|
| **Web** | Basic Nginx, WordPress Light |
|
|
| **Tools** | MCP Demo |
|
|
|
|
Each template supports:
|
|
- Variable substitution (resource tiers, passwords, etc.)
|
|
- Multi-resource deployment (app + volume + database)
|
|
- Auto-provisioning of dependent resources
|
|
|
|
---
|
|
|
|
## 7. Summary & Verdict
|
|
|
|
### V2 Improvements Over V1
|
|
1. **22+ new managed services** (S3, PostgreSQL, Volumes, Secrets, etc.)
|
|
2. **CLI-first workflow** with `gy` tool (auto stack detection)
|
|
3. **AI integration** (LiteLLM gateway + AI assistant)
|
|
4. **One-click templates** (22 apps in the Store)
|
|
5. **Better security** (Hasura RLS, auth rate limiting, billing enforcement)
|
|
6. **Real-time updates** (WebSocket subscriptions)
|
|
7. **Full documentation** (docs.ghaymah.cloud)
|
|
8. **Teams & billing** (multi-user, plan management)
|
|
9. **Developer experience** (friendly names, live config, tunnels)
|
|
10. **Status monitoring** (public status page)
|
|
|
|
### Preserved from V1
|
|
1. Kubernetes-based orchestration
|
|
2. CoreDNS internal service mesh
|
|
3. Helm chart resource model (ghaymah-project, ghaymah-app)
|
|
4. Container registry per user
|
|
5. Hasura GraphQL as data layer
|
|
|
|
### Areas Still Needing Attention
|
|
1. Missing security headers (5/5 absent)
|
|
2. GraphQL introspection exposed in production
|
|
3. API rate limiting not detected on GraphQL endpoint
|
|
4. Resource counter bug (`current_resources: -14`)
|
|
5. No custom domain support for deployed apps
|
|
|
|
---
|
|
|
|
*Comparison generated from hands-on testing of both V1 and V2 platforms*
|
|
*Date: 2026-10-22*
|