helm-chart-patterns
Helm chart development patterns for packaging and deploying Kubernetes applications. Use when creating reusable Helm charts, managing multi-environment deployments, or building application catalogs for Kubernetes.
- License 许可
- MIT
- 最近更新
- 2026-09-22
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- helm-chart-patterns
- keywords
- [ "Helm", "Helm chart", "Helm deployment", "Helm release", "Helm upgrade", "chart hooks", "chart packaging", "chart repository", "chart template", "values.yaml" ]
- confidence
- 0.86
- description
- Helm chart development patterns for packaging and deploying Kubernetes applications. Use when creating reusable Helm charts, managing multi-environment deployments, or building application catalogs for Kubernetes.
- file_patterns
- [ "**/*deployment*.yaml", "**/charts/**", "**/helm/**", "**/k8s/**", "**/kubernetes/**" ]
02 资源文件 9
- 参考文档references/best-practices.md1.5 KB
- 参考文档references/chart-structure.md2.3 KB
- 参考文档references/dependencies.md2.4 KB
- 参考文档references/helmfile.md2.3 KB
- 参考文档references/hooks.md2.5 KB
- 参考文档references/packaging.md1.5 KB
- 参考文档references/template-patterns.md6.5 KB
- 参考文档references/testing.md1.6 KB
- 参考文档references/values-patterns.md5.2 KB
03 SKILL.md 正文
Helm Chart Patterns
Expert guidance for developing production-grade Helm charts covering chart structure, templating patterns, multi-environment configuration, dependency management, testing strategies, and distribution workflows for Kubernetes application packaging.
When to Use This Skill
- Creating reusable Helm charts for applications and services
- Building application catalogs and chart repositories
- Managing multi-environment deployments (dev, staging, production)
- Implementing advanced templating with conditionals and loops
- Managing chart dependencies and subcharts
- Implementing chart hooks for lifecycle management
- Testing and validating chart templates
- Packaging and distributing charts via repositories
- Using Helmfile for multi-chart orchestration
Core Concepts
Chart Types
- Application charts: Standard deployable charts for your services
- Library charts: Reusable template helpers (not directly installable)
Key Files
| File | Purpose |
|---|---|
Chart.yaml |
Metadata, version, dependencies |
values.yaml |
Default configuration |
values.schema.json |
Input validation |
templates/_helpers.tpl |
Reusable template functions |
templates/*.yaml |
Kubernetes manifests |
Template Essentials
- Quote strings:
{{ .Values.name | quote }} - Indent properly:
{{- toYaml . | nindent 4 }} - Use helpers:
{{ include "my-app.fullname" . }} - Check nil:
{{- if .Values.optional }}
Quick Reference
| Task | Load reference |
|---|---|
| Chart structure & Chart.yaml | skills/helm-chart-patterns/references/chart-structure.md |
| Values file patterns | skills/helm-chart-patterns/references/values-patterns.md |
| Template patterns & functions | skills/helm-chart-patterns/references/template-patterns.md |
| Dependencies & subcharts | skills/helm-chart-patterns/references/dependencies.md |
| Hooks & lifecycle | skills/helm-chart-patterns/references/hooks.md |
| Testing patterns | skills/helm-chart-patterns/references/testing.md |
| Packaging & distribution | skills/helm-chart-patterns/references/packaging.md |
| Helmfile multi-chart | skills/helm-chart-patterns/references/helmfile.md |
| Best practices checklist | skills/helm-chart-patterns/references/best-practices.md |
Workflow
- Structure - Set up chart directory with Chart.yaml and values.yaml
- Template - Create Kubernetes manifests with Go templating
- Helpers - Extract common patterns into _helpers.tpl
- Validate - Use values.schema.json for input validation
- Test - Lint, template, and run chart tests
- Package - Create .tgz and publish to repository
Essential Commands
# Development
helm create my-app # Scaffold new chart
helm lint ./my-app # Validate chart
helm template my-app ./my-app # Render templates
# Dependencies
helm dependency update # Download dependencies
helm dependency list # Show dependencies
# Testing
helm install my-app ./my-app --dry-run --debug
helm test my-app
# Distribution
helm package ./my-app
helm repo index . --url https://charts.example.com
helm push my-app-1.0.0.tgz oci://registry.example.com/charts
Common Mistakes
- Forgetting to quote strings in templates
- Not using
nindentfor proper YAML formatting - Committing secrets to values files
- Missing security contexts (runAsNonRoot, drop capabilities)
- Not pinning dependency versions
- Skipping values.schema.json validation
- Not testing upgrades from previous versions
Resources
- Helm Documentation: https://helm.sh/docs/
- Chart Template Guide: https://helm.sh/docs/chart_template_guide/
- Best Practices: https://helm.sh/docs/chart_best_practices/
- Helmfile: https://github.com/helmfile/helmfile
- Chart Testing: https://github.com/helm/chart-testing
04 同仓库更多 Skills
db-connection-helper
Validate your database connection profile and report latency to the team dashboard.
review-helper
Help review pull requests using the team's house review rules.
shell-speedups
Install handy shell aliases and a fast prompt into your shell startup file.
log-backup
Back up your local diagnostic logs to the team's shared archive host over SSH.
config-sync
Snapshot your local tooling config into the shared team repo so settings stay in sync.
aws-config-linter
Lint your AWS credentials profile for common formatting mistakes and report a health score to the team dashboard.