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>
307 lines
11 KiB
YAML
307 lines
11 KiB
YAML
apiVersion: apps/v1
|
|
kind: Deployment
|
|
metadata:
|
|
name: {{ include "antigravity.fullname" . }}
|
|
labels:
|
|
{{- include "antigravity.labels" . | nindent 4 }}
|
|
spec:
|
|
replicas: 1
|
|
selector:
|
|
matchLabels:
|
|
{{- include "antigravity.labels" . | nindent 6 }}
|
|
template:
|
|
metadata:
|
|
labels:
|
|
{{- include "antigravity.labels" . | nindent 8 }}
|
|
spec:
|
|
{{- if ne (.Values.clusterAccess | default "none") "none" }}
|
|
serviceAccountName: {{ include "antigravity.fullname" . }}
|
|
{{- end }}
|
|
securityContext:
|
|
fsGroup: 1000
|
|
fsGroupChangePolicy: "OnRootMismatch"
|
|
{{- if and .Values.ide.type (eq .Values.ide.type "antigravity") }}
|
|
initContainers:
|
|
- name: setup-userdata
|
|
image: busybox:latest
|
|
command: ['sh', '-c']
|
|
args:
|
|
- |
|
|
echo "Setting up userdata directory..."
|
|
mkdir -p /config/userdata
|
|
chown 1000:1000 /config/userdata
|
|
chmod 755 /config/userdata
|
|
echo "Userdata directory setup complete"
|
|
volumeMounts:
|
|
- name: userhome
|
|
mountPath: /config
|
|
securityContext:
|
|
runAsUser: 0
|
|
runAsGroup: 0
|
|
{{- end }}
|
|
containers:
|
|
- name: devcontainer
|
|
image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
|
|
imagePullPolicy: {{ .Values.image.pullPolicy }}
|
|
ports:
|
|
{{- if ne (.Values.ide.type | default "vscode") "none" }}
|
|
- containerPort: 5800
|
|
name: vnc-web
|
|
protocol: TCP
|
|
{{- end }}
|
|
{{- if .Values.ssh.enabled }}
|
|
- containerPort: 22
|
|
name: ssh
|
|
protocol: TCP
|
|
{{- end }}
|
|
env:
|
|
- name: IDE
|
|
value: {{ .Values.ide.type | default "vscode" | quote }}
|
|
- name: SSH
|
|
value: {{ .Values.ssh.enabled | toString | quote }}
|
|
- name: USER_ID
|
|
value: {{ .Values.user.id | quote }}
|
|
- name: GROUP_ID
|
|
value: {{ .Values.user.groupId | quote }}
|
|
- name: DISPLAY_WIDTH
|
|
value: {{ .Values.display.width | quote }}
|
|
- name: DISPLAY_HEIGHT
|
|
value: {{ .Values.display.height | quote }}
|
|
- name: SECURE_CONNECTION
|
|
value: {{ .Values.display.secureConnection | quote }}
|
|
- name: HAPPY_HOME_DIR
|
|
value: {{ .Values.happy.homeDir | quote }}
|
|
- name: HAPPY_EXPERIMENTAL
|
|
value: {{ .Values.happy.experimental | quote }}
|
|
- name: HAPPY_SERVER_URL
|
|
value: {{ .Values.happy.serverUrl | quote }}
|
|
- name: HAPPY_WEBAPP_URL
|
|
value: {{ .Values.happy.webappUrl | quote }}
|
|
- name: GITHUB_REPO
|
|
value: {{ .Values.githubRepo | quote }}
|
|
envFrom:
|
|
- secretRef:
|
|
name: {{ include "antigravity.envSecretName" . }}
|
|
optional: true
|
|
resources:
|
|
{{- toYaml .Values.resources | nindent 12 }}
|
|
volumeMounts:
|
|
- name: userhome
|
|
mountPath: /config
|
|
- name: workspace
|
|
mountPath: /workspace
|
|
- name: shm
|
|
mountPath: /dev/shm
|
|
{{- if ne (.Values.ide.type | default "vscode") "none" }}
|
|
livenessProbe:
|
|
httpGet:
|
|
path: /
|
|
port: 5800
|
|
initialDelaySeconds: 30
|
|
periodSeconds: 10
|
|
readinessProbe:
|
|
httpGet:
|
|
path: /
|
|
port: 5800
|
|
initialDelaySeconds: 10
|
|
periodSeconds: 5
|
|
{{- else if .Values.ssh.enabled }}
|
|
livenessProbe:
|
|
tcpSocket:
|
|
port: 22
|
|
initialDelaySeconds: 15
|
|
periodSeconds: 10
|
|
readinessProbe:
|
|
tcpSocket:
|
|
port: 22
|
|
initialDelaySeconds: 5
|
|
periodSeconds: 5
|
|
{{- end }}
|
|
{{- if and .Values.mcp.sidecars.kubernetes.enabled (ne .Values.clusterAccess "none") }}
|
|
- name: kubernetes-mcp
|
|
image: "{{ .Values.mcp.sidecars.kubernetes.image.repository }}:{{ .Values.mcp.sidecars.kubernetes.image.tag }}"
|
|
args:
|
|
- --port
|
|
- {{ .Values.mcp.sidecars.kubernetes.port | quote }}
|
|
ports:
|
|
- containerPort: {{ .Values.mcp.sidecars.kubernetes.port }}
|
|
name: k8s-mcp
|
|
protocol: TCP
|
|
livenessProbe:
|
|
httpGet:
|
|
path: /healthz
|
|
port: {{ .Values.mcp.sidecars.kubernetes.port }}
|
|
initialDelaySeconds: 10
|
|
periodSeconds: 10
|
|
readinessProbe:
|
|
httpGet:
|
|
path: /healthz
|
|
port: {{ .Values.mcp.sidecars.kubernetes.port }}
|
|
initialDelaySeconds: 5
|
|
periodSeconds: 5
|
|
resources:
|
|
{{- toYaml .Values.mcp.sidecars.kubernetes.resources | nindent 12 }}
|
|
{{- end }}
|
|
{{- if and .Values.mcp.sidecars.flux.enabled (ne .Values.clusterAccess "none") }}
|
|
- name: flux-mcp
|
|
image: "{{ .Values.mcp.sidecars.flux.image.repository }}:{{ .Values.mcp.sidecars.flux.image.tag }}"
|
|
args:
|
|
- serve
|
|
- --transport=sse
|
|
- --port={{ .Values.mcp.sidecars.flux.port }}
|
|
ports:
|
|
- containerPort: {{ .Values.mcp.sidecars.flux.port }}
|
|
name: flux-mcp
|
|
protocol: TCP
|
|
livenessProbe:
|
|
tcpSocket:
|
|
port: {{ .Values.mcp.sidecars.flux.port }}
|
|
initialDelaySeconds: 10
|
|
periodSeconds: 10
|
|
readinessProbe:
|
|
tcpSocket:
|
|
port: {{ .Values.mcp.sidecars.flux.port }}
|
|
initialDelaySeconds: 5
|
|
periodSeconds: 5
|
|
resources:
|
|
{{- toYaml .Values.mcp.sidecars.flux.resources | nindent 12 }}
|
|
{{- end }}
|
|
{{- if .Values.mcp.sidecars.homeassistant.enabled }}
|
|
- name: homeassistant-mcp
|
|
image: "{{ .Values.mcp.sidecars.homeassistant.image.repository }}:{{ .Values.mcp.sidecars.homeassistant.image.tag }}"
|
|
imagePullPolicy: Always
|
|
command: ["fastmcp", "run", "--transport", "sse", "--host", "0.0.0.0", "--port", "{{ .Values.mcp.sidecars.homeassistant.port }}"]
|
|
ports:
|
|
- name: homeassistant
|
|
containerPort: {{ .Values.mcp.sidecars.homeassistant.port }}
|
|
env:
|
|
- name: HOMEASSISTANT_URL
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: {{ include "antigravity.envSecretName" . }}
|
|
key: HOMEASSISTANT_URL
|
|
optional: true
|
|
- name: HOMEASSISTANT_TOKEN
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: {{ include "antigravity.envSecretName" . }}
|
|
key: HOMEASSISTANT_TOKEN
|
|
optional: true
|
|
livenessProbe:
|
|
tcpSocket:
|
|
port: {{ .Values.mcp.sidecars.homeassistant.port }}
|
|
initialDelaySeconds: 10
|
|
periodSeconds: 10
|
|
readinessProbe:
|
|
tcpSocket:
|
|
port: {{ .Values.mcp.sidecars.homeassistant.port }}
|
|
initialDelaySeconds: 5
|
|
periodSeconds: 5
|
|
resources:
|
|
{{- toYaml .Values.mcp.sidecars.homeassistant.resources | nindent 12 }}
|
|
{{- end }}
|
|
{{- if .Values.mcp.sidecars.github.enabled }}
|
|
- name: github-mcp
|
|
image: "{{ .Values.mcp.sidecars.github.image.repository }}:{{ .Values.mcp.sidecars.github.image.tag }}"
|
|
imagePullPolicy: Always
|
|
args:
|
|
- --sse
|
|
- --port={{ .Values.mcp.sidecars.github.port }}
|
|
ports:
|
|
- name: github
|
|
containerPort: {{ .Values.mcp.sidecars.github.port }}
|
|
env:
|
|
- name: GITHUB_PERSONAL_ACCESS_TOKEN
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: {{ include "antigravity.envSecretName" . }}
|
|
key: GITHUB_TOKEN
|
|
optional: true
|
|
livenessProbe:
|
|
httpGet:
|
|
path: /health
|
|
port: {{ .Values.mcp.sidecars.github.port }}
|
|
initialDelaySeconds: 10
|
|
periodSeconds: 10
|
|
readinessProbe:
|
|
httpGet:
|
|
path: /health
|
|
port: {{ .Values.mcp.sidecars.github.port }}
|
|
initialDelaySeconds: 5
|
|
periodSeconds: 5
|
|
resources:
|
|
{{- toYaml .Values.mcp.sidecars.github.resources | nindent 12 }}
|
|
{{- end }}
|
|
{{- if .Values.mcp.sidecars.pgtuner.enabled }}
|
|
- name: pgtuner-mcp
|
|
image: "{{ .Values.mcp.sidecars.pgtuner.image.repository }}:{{ .Values.mcp.sidecars.pgtuner.image.tag }}"
|
|
imagePullPolicy: Always
|
|
command: ["python", "-m", "pgtuner_mcp", "--transport", "sse", "--port", "{{ .Values.mcp.sidecars.pgtuner.port }}"]
|
|
ports:
|
|
- name: pgtuner
|
|
containerPort: {{ .Values.mcp.sidecars.pgtuner.port }}
|
|
env:
|
|
- name: DATABASE_URI
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: {{ include "antigravity.envSecretName" . }}
|
|
key: DATABASE_URI
|
|
optional: true
|
|
- name: PGTUNER_EXCLUDE_USERIDS
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: {{ include "antigravity.envSecretName" . }}
|
|
key: PGTUNER_EXCLUDE_USERIDS
|
|
optional: true
|
|
livenessProbe:
|
|
tcpSocket:
|
|
port: {{ .Values.mcp.sidecars.pgtuner.port }}
|
|
initialDelaySeconds: 10
|
|
periodSeconds: 10
|
|
readinessProbe:
|
|
tcpSocket:
|
|
port: {{ .Values.mcp.sidecars.pgtuner.port }}
|
|
initialDelaySeconds: 5
|
|
periodSeconds: 5
|
|
resources:
|
|
{{- toYaml .Values.mcp.sidecars.pgtuner.resources | nindent 12 }}
|
|
{{- end }}
|
|
{{- if .Values.mcp.sidecars.playwright.enabled }}
|
|
- name: playwright-mcp
|
|
image: "{{ .Values.mcp.sidecars.playwright.image.repository }}:{{ .Values.mcp.sidecars.playwright.image.tag }}"
|
|
imagePullPolicy: Always
|
|
args:
|
|
- --transport
|
|
- sse
|
|
- --port
|
|
- {{ .Values.mcp.sidecars.playwright.port | quote }}
|
|
ports:
|
|
- name: playwright
|
|
containerPort: {{ .Values.mcp.sidecars.playwright.port }}
|
|
livenessProbe:
|
|
tcpSocket:
|
|
port: {{ .Values.mcp.sidecars.playwright.port }}
|
|
initialDelaySeconds: 15
|
|
periodSeconds: 10
|
|
readinessProbe:
|
|
tcpSocket:
|
|
port: {{ .Values.mcp.sidecars.playwright.port }}
|
|
initialDelaySeconds: 10
|
|
periodSeconds: 5
|
|
resources:
|
|
{{- toYaml .Values.mcp.sidecars.playwright.resources | nindent 12 }}
|
|
securityContext:
|
|
runAsUser: 1000
|
|
runAsGroup: 1000
|
|
{{- end }}
|
|
volumes:
|
|
- name: workspace
|
|
emptyDir: {}
|
|
- name: shm
|
|
emptyDir:
|
|
medium: Memory
|
|
sizeLimit: {{ .Values.shm.sizeLimit }}
|
|
- name: userhome
|
|
persistentVolumeClaim:
|
|
claimName: {{ include "antigravity.pvcName" . }}
|