@sylix/coworker 2.0.10 → 2.0.12

package/dist/skills/defaults/kubernetes/helm.md

@@ -0,0 +1,343 @@
+---
+name: helm-chart-scaffolding
+description: Design, organize, and manage Helm charts for templating and packaging Kubernetes applications with reusable configurations. Use when creating Helm charts, packaging Kubernetes applications, or implementing templated deployments.
+---
+
+# Helm Chart Scaffolding
+
+Comprehensive guidance for creating, organizing, and managing Helm charts for packaging and deploying Kubernetes applications.
+
+## When to Use This Skill
+
+- Create new Helm charts from scratch
+- Package Kubernetes applications for distribution
+- Manage multi-environment deployments with Helm
+- Implement templating for reusable Kubernetes manifests
+- Set up Helm chart repositories
+- Follow Helm best practices and conventions
+
+## Helm Overview
+
+**Helm** is the package manager for Kubernetes that:
+
+- Templates Kubernetes manifests for reusability
+- Manages application releases and rollbacks
+- Handles dependencies between charts
+- Provides version control for deployments
+- Simplifies configuration management across environments
+
+## Step-by-Step Workflow
+
+### 1. Initialize Chart Structure
+
+**Create new chart:**
+
+```bash
+helm create my-app
+```
+
+**Standard chart structure:**
+
+```
+my-app/
+├── Chart.yaml           # Chart metadata
+├── values.yaml          # Default configuration values
+├── charts/              # Chart dependencies
+├── templates/           # Kubernetes manifest templates
+│   ├── NOTES.txt       # Post-install notes
+│   ├── _helpers.tpl    # Template helpers
+│   ├── deployment.yaml
+│   ├── service.yaml
+│   ├── ingress.yaml
+│   ├── serviceaccount.yaml
+│   ├── hpa.yaml
+│   └── tests/
+│       └── test-connection.yaml
+└── .helmignore         # Files to ignore
+```
+
+### 2. Configure Chart.yaml
+
+**Chart metadata defines the package:**
+
+```yaml
+apiVersion: v2
+name: my-app
+description: A Helm chart for My Application
+type: application
+version: 1.0.0
+appVersion: "2.1.0"
+
+keywords:
+  - web
+  - api
+  - backend
+
+maintainers:
+  - name: DevOps Team
+    email: devops@example.com
+    url: https://github.com/example/my-app
+
+sources:
+  - https://github.com/example/my-app
+
+home: https://example.com
+
+icon: https://example.com/icon.png
+
+dependencies:
+  - name: postgresql
+    version: "12.0.0"
+    repository: "https://charts.bitnami.com/bitnami"
+    condition: postgresql.enabled
+  - name: redis
+    version: "17.0.0"
+    repository: "https://charts.bitnami.com/bitnami"
+    condition: redis.enabled
+```
+
+### 3. Design values.yaml Structure
+
+**Organize values hierarchically:**
+
+```yaml
+image:
+  repository: myapp
+  tag: "1.0.0"
+  pullPolicy: IfNotPresent
+
+replicaCount: 3
+
+service:
+  type: ClusterIP
+  port: 80
+  targetPort: 8080
+
+ingress:
+  enabled: false
+  className: nginx
+  hosts:
+    - host: app.example.com
+      paths:
+        - path: /
+          pathType: Prefix
+
+resources:
+  requests:
+    memory: "256Mi"
+    cpu: "250m"
+  limits:
+    memory: "512Mi"
+    cpu: "500m"
+
+autoscaling:
+  enabled: false
+  minReplicas: 2
+  maxReplicas: 10
+  targetCPUUtilizationPercentage: 80
+
+env:
+  - name: LOG_LEVEL
+    value: "info"
+
+configMap:
+  data:
+    APP_MODE: production
+
+postgresql:
+  enabled: true
+  auth:
+    database: myapp
+    username: myapp
+
+redis:
+  enabled: false
+```
+
+### 4. Create Template Files
+
+**Use Go templating with Helm functions:**
+
+```yaml
+# templates/deployment.yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "my-app.fullname" . }}
+  labels:
+    {{- include "my-app.labels" . | nindent 4 }}
+spec:
+  {{- if not .Values.autoscaling.enabled }}
+  replicas: {{ .Values.replicaCount }}
+  {{- end }}
+  selector:
+    matchLabels:
+      {{- include "my-app.selectorLabels" . | nindent 6 }}
+  template:
+    metadata:
+      labels:
+        {{- include "my-app.selectorLabels" . | nindent 8 }}
+    spec:
+      containers:
+      - name: {{ .Chart.Name }}
+        image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default .Chart.AppVersion }}"
+        imagePullPolicy: {{ .Values.image.pullPolicy }}
+        ports:
+        - name: http
+          containerPort: {{ .Values.service.targetPort }}
+        resources:
+          {{- toYaml .Values.resources | nindent 12 }}
+        env:
+          {{- toYaml .Values.env | nindent 12 }}
+```
+
+### 5. Create Template Helpers
+
+```yaml
+{{- define "my-app.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{- define "my-app.fullname" -}}
+{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- if contains $name .Release.Name }}
+{{- .Release.Name | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}
+{{- end }}
+
+{{- define "my-app.labels" -}}
+helm.sh/chart: {{ include "my-app.chart" . }}
+{{ include "my-app.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end }}
+
+{{- define "my-app.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "my-app.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end }}
+```
+
+### 6. Manage Dependencies
+
+```bash
+helm dependency update
+helm dependency build
+```
+
+### 7. Test and Validate
+
+```bash
+# Lint the chart
+helm lint my-app/
+
+# Dry-run installation
+helm install my-app ./my-app --dry-run --debug
+
+# Template rendering
+helm template my-app ./my-app
+```
+
+### 8. Package and Distribute
+
+```bash
+helm package my-app/
+# Creates: my-app-1.0.0.tgz
+
+helm repo index .
+
+helm repo add my-repo https://charts.example.com
+helm repo update
+helm install my-app my-repo/my-app
+```
+
+### 9. Multi-Environment Configuration
+
+```
+my-app/
+├── values.yaml          # Defaults
+├── values-dev.yaml      # Development
+├── values-staging.yaml  # Staging
+└── values-prod.yaml     # Production
+```
+
+```bash
+helm install my-app ./my-app -f values-prod.yaml --namespace production
+```
+
+### 10. Implement Hooks and Tests
+
+```yaml
+# templates/tests/test-connection.yaml
+apiVersion: v1
+kind: Pod
+metadata:
+  name: "{{ include "my-app.fullname" . }}-test-connection"
+  annotations:
+    "helm.sh/hook": test
+spec:
+  containers:
+  - name: wget
+    image: busybox
+    command: ['wget']
+    args: ['{{ include "my-app.fullname" . }}:{{ .Values.service.port }}']
+  restartPolicy: Never
+```
+
+```bash
+helm test my-app
+```
+
+## Common Patterns
+
+### Pattern 1: Conditional Resources
+
+```yaml
+{{- if .Values.ingress.enabled }}
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: {{ include "my-app.fullname" . }}
+spec:
+  # ...
+{{- end }}
+```
+
+### Pattern 2: Iterating Over Lists
+
+```yaml
+env:
+{{- range .Values.env }}
+- name: {{ .name }}
+  value: {{ .value | quote }}
+{{- end }}
+```
+
+### Pattern 3: Including Files
+
+```yaml
+data:
+  config.yaml: |
+    {{- .Files.Get "config/application.yaml" | nindent 4 }}
+```
+
+## Best Practices
+
+1. **Use semantic versioning** for chart and app versions
+2. **Document all values** in values.yaml with comments
+3. **Use template helpers** for repeated logic
+4. **Validate charts** before packaging
+5. **Pin dependency versions** explicitly
+6. **Use conditions** for optional resources
+7. **Follow naming conventions** (lowercase, hyphens)
+8. **Include NOTES.txt** with usage instructions
+9. **Add labels** consistently using helpers
+10. **Test installations** in all environments