DevContainer User
d8d83ffa47
Implements comprehensive enhancements to make the Helm chart more user-friendly and easier to deploy across different scenarios. 🎯 **IMPLEMENTED IMPROVEMENTS:** **1. Values Organization & Grouping** - Reorganized values.yaml with logical sections: - Basic Configuration (name, image, githubRepo) - Access & Interface (ide, ssh, display, user) - Infrastructure & Resources (storage, resources, shm, clusterAccess) - Integrations (happy, mcp sidecars) - Smart Defaults & Auto-Detection - Updated deployment templates to use new structure - Maintains clean, navigable configuration **2. Simplified Quick-Start Values** - Added values-quickstart.yaml for 80% of users - Just 2 required fields: name + githubRepo - Includes usage instructions and common customizations - Copy-paste ready deployment experience **3. Better Documentation Structure** - Added values.schema.json for IDE validation and autocomplete - Created comprehensive USAGE.md with real-world examples: - Development, team, K8s admin, AI/ML, lightweight scenarios - Secret configuration examples - Resource sizing by use case - Common troubleshooting patterns **4. Smart Defaults & Auto-Detection** - Added template helpers for intelligent resource sizing - Environment auto-detection based on naming patterns - Smart MCP sidecar selection based on cluster access - Resource profile auto-selection (auto/small/medium/large/xlarge) - Enhanced _helpers.tpl with smart default functions 🎫 **CREATED GITHUB ISSUES** for future enhancements: - #32: Helm chart preset profiles - #33: Split large deployment.yaml template - #34: Advanced auto-detection for Kubernetes environments - #35: Specialized Helm chart variants (basic/team/k8s/ai) - #36: Installation and configuration helper scripts - #37: Comprehensive validation and health monitoring - #38: User experience improvements with better error messages - #39: Comprehensive examples and template library 📊 **IMPACT:** - Reduced required configuration from ~20 values to 2 essential fields - Added IDE support with schema validation - Created guided examples for common scenarios - Established foundation for advanced auto-detection - Planned comprehensive tooling ecosystem 🚀 **USAGE:** ```bash # Quick start (new users) cp chart/values-quickstart.yaml my-values.yaml # Edit name and githubRepo helm install mydev ./chart -f my-values.yaml # Full customization (power users) # Edit chart/values.yaml with organized sections helm install mydev ./chart ``` Generated with [Claude Code](https://claude.ai/code) via [Happy](https://happy.engineering) Co-Authored-By: Claude <noreply@anthropic.com> Co-Authored-By: Happy <yesreply@happy.engineering>
191 lines
4.9 KiB
YAML
191 lines
4.9 KiB
YAML
# =============================================================================
|
|
# BASIC CONFIGURATION
|
|
# =============================================================================
|
|
|
|
# Instance name — used to generate resource names (devcontainer-{name}, userhome-{name})
|
|
name: ""
|
|
|
|
# Container image configuration
|
|
image:
|
|
repository: ghcr.io/cpfarhood/devcontainer
|
|
tag: latest
|
|
pullPolicy: Always
|
|
|
|
# GitHub repository to clone into /workspace
|
|
githubRepo: ""
|
|
|
|
# =============================================================================
|
|
# ACCESS & INTERFACE
|
|
# =============================================================================
|
|
|
|
# IDE configuration
|
|
ide:
|
|
# Options: vscode | antigravity | none
|
|
type: vscode
|
|
|
|
# SSH access configuration
|
|
ssh:
|
|
enabled: false
|
|
|
|
# VNC display settings
|
|
display:
|
|
width: "1920"
|
|
height: "1080"
|
|
secureConnection: "0" # Set to "1" when TLS is not terminated upstream
|
|
|
|
# User configuration
|
|
user:
|
|
id: "1000"
|
|
groupId: "1000"
|
|
|
|
# =============================================================================
|
|
# INFRASTRUCTURE & RESOURCES
|
|
# =============================================================================
|
|
|
|
# Storage configuration
|
|
storage:
|
|
size: 32Gi
|
|
className: ceph-filesystem
|
|
|
|
# Resource allocation
|
|
resources:
|
|
requests:
|
|
memory: "2Gi"
|
|
cpu: "1000m"
|
|
limits:
|
|
memory: "8Gi"
|
|
cpu: "4000m"
|
|
|
|
# Shared memory for Electron apps (Chrome, Antigravity)
|
|
shm:
|
|
sizeLimit: 2Gi
|
|
|
|
# Kubernetes cluster access via RBAC
|
|
# Options: none | readonlyns | readwritens | readonly | readwrite
|
|
clusterAccess: none
|
|
|
|
# =============================================================================
|
|
# INTEGRATIONS
|
|
# =============================================================================
|
|
|
|
# Happy Coder AI assistant configuration
|
|
happy:
|
|
serverUrl: "https://happy.farh.net"
|
|
webappUrl: "https://happy-coder.farh.net"
|
|
homeDir: "/config/userdata/.happy"
|
|
experimental: "true"
|
|
|
|
# MCP (Model Context Protocol) server sidecars
|
|
mcp:
|
|
sidecars:
|
|
# Kubernetes API access
|
|
kubernetes:
|
|
enabled: true
|
|
image:
|
|
repository: quay.io/containers/kubernetes_mcp_server
|
|
tag: v0.0.57
|
|
port: 8080
|
|
resources:
|
|
requests:
|
|
memory: "64Mi"
|
|
cpu: "50m"
|
|
limits:
|
|
memory: "256Mi"
|
|
cpu: "500m"
|
|
|
|
# Flux GitOps operations
|
|
flux:
|
|
enabled: true
|
|
image:
|
|
repository: ghcr.io/controlplaneio-fluxcd/flux-operator-mcp
|
|
tag: v0.41.1
|
|
port: 8081
|
|
resources:
|
|
requests:
|
|
memory: "64Mi"
|
|
cpu: "50m"
|
|
limits:
|
|
memory: "256Mi"
|
|
cpu: "500m"
|
|
|
|
# Home Assistant smart home control
|
|
homeassistant:
|
|
enabled: false # Requires HOMEASSISTANT_URL and HOMEASSISTANT_TOKEN
|
|
image:
|
|
repository: ghcr.io/homeassistant-ai/ha-mcp
|
|
tag: stable
|
|
port: 8087
|
|
resources:
|
|
requests:
|
|
memory: "64Mi"
|
|
cpu: "50m"
|
|
limits:
|
|
memory: "256Mi"
|
|
cpu: "500m"
|
|
|
|
# GitHub API access (DISABLED: archived image)
|
|
github:
|
|
enabled: false
|
|
image:
|
|
repository: ghcr.io/modelcontextprotocol/servers/github
|
|
tag: latest
|
|
port: 8088
|
|
resources:
|
|
requests:
|
|
memory: "64Mi"
|
|
cpu: "50m"
|
|
limits:
|
|
memory: "256Mi"
|
|
cpu: "500m"
|
|
|
|
# PostgreSQL performance tuning
|
|
pgtuner:
|
|
enabled: false # Requires DATABASE_URI in secrets
|
|
image:
|
|
repository: dog830228/pgtuner_mcp
|
|
tag: latest
|
|
port: 8085
|
|
resources:
|
|
requests:
|
|
memory: "64Mi"
|
|
cpu: "50m"
|
|
limits:
|
|
memory: "256Mi"
|
|
cpu: "500m"
|
|
|
|
# Browser automation and web testing
|
|
playwright:
|
|
enabled: true
|
|
image:
|
|
repository: microsoft/playwright-mcp
|
|
tag: latest
|
|
port: 8086
|
|
resources:
|
|
requests:
|
|
memory: "128Mi"
|
|
cpu: "100m"
|
|
limits:
|
|
memory: "512Mi"
|
|
cpu: "1000m"
|
|
|
|
# =============================================================================
|
|
# SMART DEFAULTS & AUTO-DETECTION
|
|
# =============================================================================
|
|
|
|
# Environment auto-detection based on name patterns
|
|
# Automatically adjusts defaults for dev/test/prod/team environments
|
|
autoDetect:
|
|
environment: true # Auto-detect dev/prod/team from name
|
|
storageClass: true # Auto-detect ReadWriteMany storage class
|
|
resources: true # Auto-size resources based on enabled features
|
|
|
|
# Resource profiles (auto-selected based on environment and features)
|
|
# Override specific values above to customize
|
|
resourceProfile: auto # auto | small | medium | large | xlarge
|
|
|
|
# =============================================================================
|
|
# ADVANCED CONFIGURATION
|
|
# =============================================================================
|
|
|
|
# Custom env secret name (defaults to: devcontainer-{name}-secrets-env)
|
|
envSecretName: "" |