apiVersion: helm-expt.confighub.com/v1alpha1
kind: HelmCatalogDemoReadme
metadata:
  name: readme
  labels:
    app.kubernetes.io/part-of: helm-catalog
    helm-expt.confighub.com/space: "prometheus-community-kube-prometheus-stack-85-3-3-no-crds"
    helm-expt.confighub.com/readme-kind: "preset"
spec:
  space: "prometheus-community-kube-prometheus-stack-85-3-3-no-crds"
  title: "prometheus-community/kube-prometheus-stack 85.3.3 - no-crds"
  summary: "A ready-to-use preset for prometheus-community/kube-prometheus-stack@85.3.3. It solves one operating problem for this chart, while keeping the upstream Helm chart and recording the settings, rendered YAML, and evidence."
  sourcePath: "data/helm-catalog-readmes/spaces/prometheus-community-kube-prometheus-stack-85-3-3-no-crds/README.md"
  links:
    - label: "Catalog chart page"
      url: "https://confighub.github.io/helm-expt/site/charts/prometheus-community-kube-prometheus-stack-85-3-3.html"
    - label: "Helm values profile"
      url: "https://github.com/confighub/helm-expt/blob/main/recipes/prometheus-community/kube-prometheus-stack/85.3.3/effective-values-no-crds.yaml"
    - label: "Render intent"
      url: "https://github.com/confighub/helm-expt/blob/main/data/helm-render-intents/intents/prometheus-community-kube-prometheus-stack-85-3-3-no-crds.yaml"
    - label: "Generated guide"
      url: "https://github.com/confighub/helm-expt/blob/main/data/confighub-example-guides/spaces/prometheus-community-kube-prometheus-stack-85-3-3-no-crds/README.md"
  markdown: |-
    <!-- Generated by npm run helm-catalog-readmes. Do not edit by hand. -->

    # prometheus-community/kube-prometheus-stack 85.3.3 - no-crds

    This Space exists to answer one practical question: what is a safe, repeatable way to run `prometheus-community/kube-prometheus-stack@85.3.3` for this operating choice?

    For this Space, the answer is the `no-crds` preset. Use this when your platform, GitOps bootstrap, or another chart owns the CRDs.

    The preset keeps the upstream Helm chart. The catalog records the chart version, values, namespace, release name, Kubernetes capabilities, source lock, rendered YAML, and evidence, so the team can repeat this choice later.

    ## Why this preset exists

    With plain Helm, a values file and a successful install do not explain enough later. It can be hard to tell which values, Secrets, CRDs, hooks, target assumptions, and local edits mattered. A future upgrade can also wipe changes made after install.

    This preset gives the team a named starting point instead of a private guess. You can test it without a ConfigHub account, upload it when you want Hub records and variants, and reuse it as a base for dev, staging, production, regions, or customers.

    ## What this preset contains

    - Preset: `no-crds`.
    - Kubernetes YAML: 114 object(s), mainly PrometheusRule x35, ConfigMap x31, ServiceMonitor x13, Service x11, ServiceAccount x6, ClusterRole x4, ClusterRoleBinding x4, Deployment x3.
    - Needs before install: 10 CRDs, 1 Secret.
    - Extra Helm work: 7 recorded route(s) for hooks or surrounding setup work.

    This is not a new chart language. It is a checked way to use this Helm chart, with the chosen inputs and output kept together.

    ## Where each setting comes from

    There are four places to look. The public preset itself contains no ConfigHub edits: it is the recorded Helm render that later ConfigHub variants start from.

    | Place | What this Space records | Where to change it |
    | --- | --- | --- |
    | Helm values | [The values profile](https://github.com/confighub/helm-expt/blob/main/recipes/prometheus-community/kube-prometheus-stack/85.3.3/effective-values-no-crds.yaml) defines the `no-crds` base together with release `kube-prometheus-stack` and namespace `monitoring`. | Change the values and create or update a base preset when Helm needs to produce different objects. |
    | ConfigHub changes | None in this catalog base. After upload, an edit appears in Unit revision history or in a derived environment variant. | Edit the rendered object in ConfigHub when the base shape is right but a field needs to differ for an environment, region, customer, or policy. |
    | Install work | 10 CRDs, 1 Secret; 7 hook or setup route(s) are recorded. | Follow the prerequisite and route records. Secrets, CRDs, and setup jobs are not hidden as values or ConfigHub edits. |
    | Live cluster | Live state is checked against the reviewed configuration; it does not become the desired setting by itself. | Record an intended fix in ConfigHub, or remove an unintended live change as drift. |

    If a later Helm render and a ConfigHub revision both change the same field, review that overlap before promotion. Do not let two layers silently own one setting.

    ## What to inspect in Hub

    1. Read this page first.
    2. Open the `recipe` Unit for the chart version and setting-source record, then follow its values-profile path to see what Helm was given.
    3. Open the Kubernetes YAML to see what Helm produced.
    4. Open Unit revision history to see any later ConfigHub change.
    5. Open routes or prerequisites when the chart needs CRDs, hooks, Secrets, setup jobs, or target facts.

    ## Try it

    Run without a ConfigHub account:

    ```sh
    bash <(curl -fsSL https://confighub.github.io/helm-expt/site/sh/prometheus-community-kube-prometheus-stack-85-3-3/no-crds/try.sh)
    ```

    Upload to ConfigHub:

    ```sh
    bash <(curl -fsSL https://confighub.github.io/helm-expt/site/sh/prometheus-community-kube-prometheus-stack-85-3-3/no-crds/confighub.sh)
    ```

    ## Evidence and source

    | Item | Link |
    | --- | --- |
    | Catalog chart page | [prometheus-community/kube-prometheus-stack@85.3.3](https://confighub.github.io/helm-expt/site/charts/prometheus-community-kube-prometheus-stack-85-3-3.html) |
    | Helm values profile | [recipes/prometheus-community/kube-prometheus-stack/85.3.3/effective-values-no-crds.yaml](https://github.com/confighub/helm-expt/blob/main/recipes/prometheus-community/kube-prometheus-stack/85.3.3/effective-values-no-crds.yaml) |
    | Render intent | [data/helm-render-intents/intents/prometheus-community-kube-prometheus-stack-85-3-3-no-crds.yaml](https://github.com/confighub/helm-expt/blob/main/data/helm-render-intents/intents/prometheus-community-kube-prometheus-stack-85-3-3-no-crds.yaml) |
    | Rendered YAML | [recipes/prometheus-community/kube-prometheus-stack/85.3.3/revisions/no-crds/r001/rendered/release-objects.yaml](https://github.com/confighub/helm-expt/blob/main/recipes/prometheus-community/kube-prometheus-stack/85.3.3/revisions/no-crds/r001/rendered/release-objects.yaml) |
    | Detailed guide | [data/confighub-example-guides/spaces/prometheus-community-kube-prometheus-stack-85-3-3-no-crds/README.md](https://github.com/confighub/helm-expt/blob/main/data/confighub-example-guides/spaces/prometheus-community-kube-prometheus-stack-85-3-3-no-crds/README.md) |
    | No-account script | [try.sh](https://confighub.github.io/helm-expt/site/sh/prometheus-community-kube-prometheus-stack-85-3-3/no-crds/try.sh) |
    | ConfigHub upload script | [confighub.sh](https://confighub.github.io/helm-expt/site/sh/prometheus-community-kube-prometheus-stack-85-3-3/no-crds/confighub.sh) |

    ## What is proven

    - Render parity: `yes`.
    - Local kind run: `yes`.
    - GitOps OCI live run: `yes`.
    - Live Helm versus ConfigHub comparison: `yes`.

    These claims apply to this preset. They do not mean every possible values combination for the chart has been tested.

    ## Limits

    - This README covers this recorded preset, not every possible values file.
