Q: How do you share Helm charts internally across multiple engineering teams?
Modern strategy for publishing and sharing internal Helm charts across engineering teams via OCI registries (ECR, Harbor, GHCR) with semantic versioning, values schema validation, and CI/CD consumption.
Want to master this scenario in a live sandbox? KodeKloud's CKA & CKAD Hands-On Certification Track covers this exact problem with hands-on terminal drills.
🛠️ Production Runbook & Step-by-Step Resolution
Direct Answer: I package charts and publish them to an internal OCI registry (such as AWS ECR, Harbor, GHCR, or Artifactory) using semantic versioning. Teams consume the charts in their CI/CD pipelines with pinned versions, and we maintain a central changelog and JSON values schema. OCI-based sharing eliminates legacy chart repository servers and leverages our existing container registry authentication and RBAC.
Packaging & Publishing Charts to Internal OCI Registries
Modern Helm 3 treats charts as standard OCI artifacts stored alongside container images:
# Package and push chart to OCI registry
helm dependency update charts/base-app
helm lint charts/base-app
helm package charts/base-app
# Authenticate and push
helm registry login harbor.internal.example.com
helm push base-app-1.4.2.tgz oci://harbor.internal.example.com/helm
- Dependency & Lint Checks: Run
helm dependency updateandhelm lintto ensure dependencies and templates are validated. - Packaging: Package chart into a versioned tarball (e.g.
base-app-1.4.2.tgz). - OCI Push: Log in to the internal registry and push directly using the
oci://protocol.
Team Consumption, Version Pinning & Governance
How consumer teams integrate shared base charts into their deployment pipelines:
# Pull and inspect remote OCI chart
helm pull oci://harbor.internal.example.com/helm/base-app --version 1.4.2
# Deploy directly from OCI registry in CI/CD
helm upgrade --install myapp oci://harbor.internal.example.com/helm/base-app \
--version 1.4.2 -n myns -f values.yaml --create-namespace
- Version Pinning: Application pipelines consume charts by specifying explicit semantic versions (e.g.,
--version 1.4.2) to prevent unexpected breaking changes. - Values Schema Enforcement: Include a
values.schema.jsonfile in the chart to validate team-provided values during client-side rendering. - Automated Release Pipelines: Use GitHub Actions / GitLab CI with semantic-release to automatically build, test, and publish chart artifacts when PRs merge to main.
- Publish versioned Helm charts as OCI artifacts directly to internal registries like Harbor or AWS ECR.
- Enforce schema validation with values.schema.json and semantic versioning to protect downstream teams from breaking changes.
- Integrate chart consumption directly into application CI/CD pipelines using pinned oci:// registry URIs.
Senior hiring managers and bar raisers evaluate how you prioritize during outages. Avoid these common anti-patterns:
- Over-granting cluster-admin permissions to pod ServiceAccounts instead of scoping namespace Roles when configuring Enterprise Internal Helm Over-granting cluster-wide permissions violates least-privilege principles and allows compromised pods to escalate privileges across namespaces.
-
Referencing mutable latest container tags across production Kubernetes Deployment specs when configuring Enterprise Internal Helm
Deployments referencing
:latestrisk inconsistent versions across replica pods and break deterministic rollback capabilities. - Omitting pod readiness probes, causing traffic to hit uninitialized application containers when configuring Enterprise Internal Helm Readiness probes gate traffic delivery; missing probes cause Kubernetes to route user requests to pods before dependencies or caches are loaded.
- Executing diagnostic triage without analyzing chronological cluster events and describe outputs when configuring Enterprise Internal Helm Cluster events provide sequential timestamps of scheduler decisions, probe failures, and image pull timeouts essential for rapid root-cause isolation.