This guide explains the journey from a public Helm chart to a ConfigHub Space. Use it when you want to know why this preset exists, what problem it solves, how to repeat it, and what still needs care.
It is generated from the same records that build the package, chart page, render intent, scripts, and receipts. The proof links are lower down.
Why this preset exists
Helm charts often expose many settings, but a values file alone does not tell the whole operations story. A team still needs to know what Kubernetes objects will be created, which Secrets or CRDs must already exist, whether hooks or setup jobs need special handling, and what evidence backs the result.
This preset is a named answer for one useful operating choice. It keeps the upstream chart, records the inputs and rendered YAML, and gives the team a repeatable starting point instead of a private values-file guess.
What this is
This is the default preset config for gitlab/gitlab-runner@0.89.0. The repo also calls this a base variant. Use this when you want to start from the chart author's normal path, with the inputs recorded.
The matching catalog page is gitlab/gitlab-runner@0.89.0.
The chart journey
We keep the Helm chart. We lock gitlab/gitlab-runner@0.89.0, choose the default preset config, render it with the recorded values, namespace, release name, and Kubernetes capabilities, then save the output as files.
That captured output is the render variant: recipes/gitlab/gitlab-runner/0.89.0/revisions/default/r001/rendered/release-objects.yaml. It contains 2 Kubernetes object(s): ConfigMap x1, Deployment x1.
The public package is oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/gitlab-gitlab-runner:0.89.0. Users can pull it without cloning this repo. When someone runs cub installer upload, ConfigHub stores the rendered Kubernetes YAML in a Space so it can be searched, compared, reviewed, changed, and delivered. The example script defaults to Space helm-gitlab-runner-default, but users can choose another name with CUB_SPACE=....
What to check
The current catalog record does not identify an extra Secret, CRD, or setup step that must be supplied before install.
The catalog does not currently record a separate hook, setup job, or cleanup step for this preset.
For this preset, the main change from plain Helm is that the render inputs and output files are recorded before upload.
Why you can trust it
- The chart version, source, namespace, release name, values, and capability profile are recorded in the render intent.
- The render variant is committed as YAML and contains 2 Kubernetes object(s).
- The installer package OCI ref points to the package users pull for this chart version.
- Render parity is recorded as passing for this preset config.
This is a claim about this recorded preset config. It is not a claim that every possible values file for this chart has been checked.
Repeat it
Fast path with no ConfigHub account:
bash <(curl -fsSL https://confighub.github.io/helm-expt/site/sh/gitlab-gitlab-runner-0-89-0/default/try.sh)Fast path with a ConfigHub account:
bash <(curl -fsSL https://confighub.github.io/helm-expt/site/sh/gitlab-gitlab-runner-0-89-0/default/confighub.sh)The core render command is:
New to cub? Install the cub CLI first. You can pull and render public catalog packages without an account. Commands that save or change ConfigHub data require you to sign in.
What this command does. cub installer is a released, open-source plugin for the cub CLI. cub installer setup pulls a catalog package and writes its Kubernetes files locally. It does not apply those files to a cluster; use kubectl, Argo CD, or Flux for delivery. The generated scripts stop before doing any work when the plugin or kustomize is missing.
cub installer setup --pull oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/gitlab-gitlab-runner:0.89.0 --base default --work-dir ./gitlab-gitlab-runner-0-89-0-default --non-interactive --namespace defaultAfter upload, create environment versions with cub variant create and move reviewed changes with cub variant promote. The walkthrough is After Upload: Create A Variant And Promote Changes.
Preset details
| Item | Value |
|---|---|
| Chart | gitlab/gitlab-runner@0.89.0 |
| Preset config | default |
| Namespace | default |
| Release name | gitlab-runner |
| Values | recipes/gitlab/gitlab-runner/0.89.0/effective-values.yaml |
| Render intent | data/helm-render-intents/intents/gitlab-gitlab-runner-0-89-0-default.yaml |
| Render variant | recipes/gitlab/gitlab-runner/0.89.0/revisions/default/r001/rendered/release-objects.yaml |
| Package base | packages/gitlab/gitlab-runner/0.89.0/bases/default |
| Scripts | try.sh · confighub.sh |
Prerequisites and lifecycle steps
| When | What | How it is handled |
|---|---|---|
| No extra step recorded | The catalog has not identified a separate prerequisite or lifecycle step for this preset. | Check the limits and evidence before production use. |
Evidence
| Check | Status |
|---|---|
| Render parity | yes |
| ConfigHub scan/upload proof | yes |
| Earlier local-cluster test | no |
| GitOps OCI live run | watch |
| Live Helm vs ConfigHub comparison | watch |
| Lifecycle routes | 0 |
Limits
- Local kind evidence is no for this preset config.
- GitOps OCI live evidence is watch for this preset config.
- Render parity alone is useful evidence, not a production or catalog recommendation.
Source files
- Chart page: https://confighub.github.io/helm-expt/site/charts/gitlab-gitlab-runner-0-89-0.html
- Render intent:
data/helm-render-intents/intents/gitlab-gitlab-runner-0-89-0-default.yaml - Rendered YAML:
recipes/gitlab/gitlab-runner/0.89.0/revisions/default/r001/rendered/release-objects.yaml - Package source:
packages/gitlab/gitlab-runner/0.89.0/bases/default - Generated scripts:
site/sh/gitlab-gitlab-runner-0-89-0/default - Preset doctrine: Helm Chart Presets And Values