Helm charts for defining, provisioning, and managing Kubernetes clusters using Cluster API (CAPI).
All charts in this repository are either directly responsible for provisioning a Cluster API cluster or required to make that provisioning succeed.
This repository contains a reusable base chart as well as opinionated application charts used by unbyte to create management and workload clusters. It also includes tightly-coupled helper charts that are required during cluster bootstrapping (e.g. External Secrets Operator configuration).
These charts define the primary infrastructure and Cluster API specifications.
The cluster library chart is designed to be reusable outside of unbyte-specific setups,
while the application charts provide opinionated defaults used by unbyte.
| Chart Name | Type | Description |
|---|---|---|
cluster |
library | Base library providing standardized templates and schemas for Cluster API resources. |
management-cluster |
application | Opinionated chart for provisioning unbyte-style management clusters. |
workload-cluster |
application | Opinionated chart for provisioning unbyte-style workload clusters. |
Helper charts required during the initial cluster lifecycle and secret management,
primarily for unbyte-style clusters.
These charts are grouped under charts/helpers.
| Chart Name | Type | Description |
|---|---|---|
cluster-bootstrap-configs |
application | Helper chart for generating ConfigMaps required during cluster bootstrapping. |
eso-providers |
application | Helper chart for deploying External Secrets Operator providers required during cluster bootstrapping. |
eso-secrets |
application | Helper chart for deploying External Secrets Operator secrets required during cluster bootstrapping. |
| Chart Name | Type | Description |
|---|---|---|
example-workload-cluster |
application | Minimal example workload cluster used for validation, testing, and documentation. Not for production use. |
- Application charts depend on the
clusterlibrary chart. - Charts are designed to work with Cluster API–compatible infrastructure providers.
- The
example-workload-clusterchart is not intended for production use.
This repository focuses on Cluster API cluster provisioning and the minimum set of tightly-coupled helper charts required to bootstrap clusters.
It includes:
- A reusable Cluster API library chart
- Opinionated charts for management and workload clusters
- Helper charts required during cluster bootstrap (e.g. ESO providers and secrets)
This repository intentionally does not include:
- General-purpose platform add-ons installed after cluster provisioning (e.g. Kyverno policies, network policies, RBAC baselines, shared services)
- Application workloads or tenant-specific deployments
- Charts intended to be reused independently of Cluster API cluster provisioning
Such charts belong in separate, dedicated repositories (e.g. platform add-ons).
To run yamlfmt locally:
yamlfmt "**/*.{yaml,yml,yamlfmt}"
# Or remove -quiet and/or -lint flag of yamlfmt in .pre-commit-config.yaml and run
pre-commit run --all-files