Helm Releases Overview
The Helm release management system tracks and controls the lifecycle of all Helm chart deployments across tenant namespaces. It provides a unified interface for installing, upgrading, rolling back, and monitoring Helm releases, with full revision history and batch operations for platform-wide upgrades.
Architecture
Each tenant has its own set of Helm releases deployed into its isolated namespace. The HelmReleaseManager service coordinates all Helm operations and persists state in the control plane database.
Platform Admin HelmReleaseController HelmReleaseManager
| | |
|--- Install release ---->| |
| |--- install() ------------>|
| | |--- Validate chart
| | |--- Helm install
| | |--- Record release
| | |--- Record history
|<-- Release response ----|<-- HelmRelease -----------|Release States
| Status | Description |
|---|---|
DEPLOYED | Release is active and healthy |
PENDING_INSTALL | Installation is in progress |
PENDING_UPGRADE | Upgrade is in progress |
PENDING_ROLLBACK | Rollback is in progress |
FAILED | Last operation failed |
UNINSTALLED | Release has been uninstalled |
Key Concepts
| Concept | Description |
|---|---|
| Release | A named instance of a chart deployed to a namespace |
| Revision | A version of a release created by install, upgrade, or rollback |
| Values Override | Tenant-specific configuration applied on top of chart defaults |
| Atomic Install | If set, failed installs are automatically rolled back |
Section Pages
| Page | Description |
|---|---|
| Release Management | Installing, listing, and uninstalling releases |
| Release Upgrades | Upgrading releases and batch operations |
| Release Rollbacks | Rolling back to previous revisions |