<!-- Generated by npm run confighub-example-guides. Do not edit by hand. -->

# prometheus-community/prometheus-node-exporter 4.55.0 - cluster-metrics-readonly

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 `cluster-metrics-readonly` preset config for `prometheus-community/prometheus-node-exporter@4.55.0`. The repo also calls this a base variant. Use this for a read-only cluster metrics shape.

The matching catalog page is [prometheus-community/prometheus-node-exporter@4.55.0](https://confighub.github.io/helm-expt/site/charts/prometheus-community-prometheus-node-exporter-4-55-0.html).

## The chart journey

We keep the Helm chart. We lock `prometheus-community/prometheus-node-exporter@4.55.0`, choose the `cluster-metrics-readonly` 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/prometheus-community/prometheus-node-exporter/4.55.0/revisions/cluster-metrics-readonly/r001/rendered/release-objects.yaml`](https://github.com/confighub/helm-expt/blob/main/recipes/prometheus-community/prometheus-node-exporter/4.55.0/revisions/cluster-metrics-readonly/r001/rendered/release-objects.yaml). It contains 4 Kubernetes object(s): DaemonSet x1, Service x1, ServiceAccount x1, ServiceMonitor x1.

The public package is `oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/prometheus-community-prometheus-node-exporter:4.55.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-prometheus-node-exporter-cluster-metrics-readonly`, but users can choose another name with `CUB_SPACE=...`.

## What to check

This preset config records 1 prerequisite: 1 CRD. The public package includes the files used to prepare them, and the generated try script applies them in the required order.

The catalog does not currently record a separate hook, setup job, or cleanup step for this preset.

Some CRDs must already exist before the rendered objects are applied.

## 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 4 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.
- Prerequisites are named before apply, so they are not discovered after rollout.

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:

```sh
bash <(curl -fsSL https://confighub.github.io/helm-expt/site/sh/prometheus-community-prometheus-node-exporter-4-55-0/cluster-metrics-readonly/try.sh)
```

Fast path with a ConfigHub account:

```sh
bash <(curl -fsSL https://confighub.github.io/helm-expt/site/sh/prometheus-community-prometheus-node-exporter-4-55-0/cluster-metrics-readonly/confighub.sh)
```

The core render command is:

```sh
cub installer setup --pull oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/prometheus-community-prometheus-node-exporter:4.55.0 --base cluster-metrics-readonly --work-dir ./prometheus-community-prometheus-node-exporter-4-55-0-cluster-metrics-readonly --non-interactive --namespace default
```

After 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](../../../../docs/user/variants-after-upload.md).

## Preset details

| Item | Value |
| --- | --- |
| Chart | `prometheus-community/prometheus-node-exporter@4.55.0` |
| Preset config | `cluster-metrics-readonly` |
| Namespace | `default` |
| Release name | `prometheus-node-exporter` |
| Values | [`recipes/prometheus-community/prometheus-node-exporter/4.55.0/effective-values-cluster-metrics-readonly.yaml`](https://github.com/confighub/helm-expt/blob/main/recipes/prometheus-community/prometheus-node-exporter/4.55.0/effective-values-cluster-metrics-readonly.yaml) |
| Render intent | [`data/helm-render-intents/intents/prometheus-community-prometheus-node-exporter-4-55-0-cluster-metrics-readonly.yaml`](https://github.com/confighub/helm-expt/blob/main/data/helm-render-intents/intents/prometheus-community-prometheus-node-exporter-4-55-0-cluster-metrics-readonly.yaml) |
| Render variant | [`recipes/prometheus-community/prometheus-node-exporter/4.55.0/revisions/cluster-metrics-readonly/r001/rendered/release-objects.yaml`](https://github.com/confighub/helm-expt/blob/main/recipes/prometheus-community/prometheus-node-exporter/4.55.0/revisions/cluster-metrics-readonly/r001/rendered/release-objects.yaml) |
| Package base | [`packages/prometheus-community/prometheus-node-exporter/4.55.0/bases/cluster-metrics-readonly`](https://github.com/confighub/helm-expt/tree/main/packages/prometheus-community/prometheus-node-exporter/4.55.0/bases/cluster-metrics-readonly) |
| Scripts | [try.sh](https://confighub.github.io/helm-expt/site/sh/prometheus-community-prometheus-node-exporter-4-55-0/cluster-metrics-readonly/try.sh) · [confighub.sh](https://confighub.github.io/helm-expt/site/sh/prometheus-community-prometheus-node-exporter-4-55-0/cluster-metrics-readonly/confighub.sh) |

## Prerequisites and lifecycle steps

| When | What | How it is handled |
| --- | --- | --- |
| Before install | 1 CRD: servicemonitors.monitoring.coreos.com | Included in the public package as prerequisites/target-facts/cluster-metrics-readonly-crds.yaml. The generated try script applies it and waits for the required CRD before installing the main objects. |

## Evidence

| Check | Status |
| --- | --- |
| Render parity | `yes` |
| ConfigHub scan/upload proof | `yes` |
| Earlier local-cluster test | `yes` |
| GitOps OCI live run | `yes` |
| Live Helm vs ConfigHub comparison | `yes` |
| Lifecycle routes | `0` |

## Limits

- Do not present as a catalog-supported chart until promotion review and support decisions are recorded.

## Source files

- Chart page: [https://confighub.github.io/helm-expt/site/charts/prometheus-community-prometheus-node-exporter-4-55-0.html](https://confighub.github.io/helm-expt/site/charts/prometheus-community-prometheus-node-exporter-4-55-0.html)
- Render intent: [`data/helm-render-intents/intents/prometheus-community-prometheus-node-exporter-4-55-0-cluster-metrics-readonly.yaml`](https://github.com/confighub/helm-expt/blob/main/data/helm-render-intents/intents/prometheus-community-prometheus-node-exporter-4-55-0-cluster-metrics-readonly.yaml)
- Rendered YAML: [`recipes/prometheus-community/prometheus-node-exporter/4.55.0/revisions/cluster-metrics-readonly/r001/rendered/release-objects.yaml`](https://github.com/confighub/helm-expt/blob/main/recipes/prometheus-community/prometheus-node-exporter/4.55.0/revisions/cluster-metrics-readonly/r001/rendered/release-objects.yaml)
- Package source: [`packages/prometheus-community/prometheus-node-exporter/4.55.0/bases/cluster-metrics-readonly`](https://github.com/confighub/helm-expt/tree/main/packages/prometheus-community/prometheus-node-exporter/4.55.0/bases/cluster-metrics-readonly)
- Generated scripts: [`site/sh/prometheus-community-prometheus-node-exporter-4-55-0/cluster-metrics-readonly`](https://github.com/confighub/helm-expt/tree/main/site/sh/prometheus-community-prometheus-node-exporter-4-55-0/cluster-metrics-readonly)
- Preset doctrine: [Helm Chart Presets And Values](../../../../docs/user/helm-presets-and-values.md)
