Skip to content
Browse Configs

Deep Dives

AI: Claude and Codex patterns

ConfigHub: Deploy and manage

Configs
Stacks
Apps
Plugins
Guides
Docs

jetstack/cert-manager

Runs on your laptop

Choose a tested starting configuration for jetstack/cert-manager@v1.20.2. Read its exact Kubernetes objects, required setup, and current evidence before you deploy it.

Start with crds-enabled. The page also shows other recorded choices. The page does not claim every possible values combination.

Evidence labels: Pass has a linked result. Watch names a limit to check. Blocked means do not use that path yet.

Upstream: the Catalog fetched chart cert-manager from the Helm repository https://charts.jetstack.io at version v1.20.2. find this chart on Artifact Hub · Helm documentation. This page adds checked configurations and test results.

Catalog readiness: Ready to try.

Licenses: chart Apache-2.0 (the chart's own Chart.yaml license metadata, read 2026-08-08). This describes the chart templates, not the packaged application images.

Check this chart and version Try the package Plan an upgrade or promotion

Already reviewed the result? Keep it in ConfigHub when you need history, variants, approvals, or delivery.

Use this entry in ConfigHub in five steps, from fetching its exact objects to promoting a change.

What it is. jetstack/cert-manager v1.20.2, as 48 Kubernetes objects in its crds-enabled preset. The Catalog holds 2 presets of this version.

Install it. curl -fsSL -o try-objects.sh https://confighub.github.io/helm-expt/site/sh/jetstack-cert-manager-v1-20-2/crds-enabled/try-objects.sh && bash try-objects.sh

OCI bundle. oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/bundles/catalog-jetstack-cert-manager-v1-20-2-crds-enabled:latest@sha256:91811b77df497d4dcd9db3e2e7ec5e2ea8dc87a9a5f54351439e5335ebc88713

Needs first. Nothing. The script applies any CRDs first.

How it works. How the model works, and Helm in the Catalog.

What this page gives you

Every chart page follows the same order. Choose a configuration, inspect its objects and setup work, then read the tests that have run. Open the worked examples.

Most choices are made before you install

The package fixes and checks almost everything at build time. What you set is small and typed.

You can read the test results

Open the saved results for the Helm comparison, live install, and delivery checks.

See hooks, CRDs, and setup work

The page names the work and says which delivery path has actually run.

What To Use

crds-enabled configuration: 48 rendered objects · 3 images · 0 target prerequisites · 0 hook or setup steps · 7/7 checks passing. These counts come from the linked test records.

crds-enabledRecommended first base variant
2Supported base variants
Recommended first pathFirst-configuration status
BlockedProduction status

Use the public catalog entry, then check the exact configuration and its tests before making a production claim.

QuestionAnswer
Catalog readinessReady to try
Chart versionv1.20.2
Exact installer packageoci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2@sha256:b688d5ef7ae759bd73d2970528a7192e14058bc593a8601b6af12157270c6d2c
OCI publication statuspublication receipt recorded
Publisher signaturepublisher signature recorded and verified
Latest upstream seenv1.20.2
Supported base variantsdefault;crds-enabled
Not yet availableNo specific missing capability is recorded. The first configuration still needs review.
Namespacecert-manager

Four Separate Questions

Inspecting a source, producing objects, checking a destination, and checking a live result are different jobs. A Catalog match is useful for comparison but is not required. A missing destination or deployment is shown as not run or blocked, not as a failed configuration.

QuestionCurrent answerWhat it needsStatus
What do I have?Inspect the helm source, choices, locks, and any existing output before selecting a destination.Destination access: no
Selected configuration deployed: no
Available to inspect
evidence recorded
What will it produce?Run the recorded Helm render step to produce the exact Kubernetes objects for this configuration.Destination access: no
Selected configuration deployed: no
Checked: passed
evidence recorded
Can this destination accept it?The destination has not been checked for this exact configuration. A recorded source or render result is not a destination pass.Destination access: yes
Selected configuration deployed: no
Not run
no run recorded
Did it work?No post-deployment result is recorded for this exact configuration. Publication, upload, or rendering is not proof that it ran correctly.Destination access: yes
Selected configuration deployed: yes
Not run
no run recorded

Open the complete assessment, source, lifecycle, and evidence record.

Where This Chart's Settings Come From

Base variantHelm valuesConfigHub changesInstall work
defaulteffective-values.yamlNone in the catalog base. Later edits appear in ConfigHub Unit revision history or a derived variant.6 prerequisites recorded.
crds-enabledeffective-values-crds-enabled.yamlNone in the catalog base. Later edits appear in ConfigHub Unit revision history or a derived variant.No separate install work is required.

Upgrade rule: if a new Helm render and a ConfigHub revision both change the same field, review the overlap before promotion. The values profile shows the Helm side; Unit revision history shows the ConfigHub side.

Read the full values-versus-ConfigHub rule. For the staging commands behind each prerequisite, open the prerequisite action packets.

What This Chart Contains

Shipping a chart as plain rendered YAML is faster and simpler, and it silently drops anything Helm was going to do afterwards. This section reports what a scan of the packaged chart found, across 51 files.

ConstructFoundWhy it matters when a chart ships as plain YAML
Helm hooks3Hook Jobs never fire, or fire under a different hook dialect.
Keep policy7A reconciler prunes what Helm promised to keep.
Webhook configuration2An empty certificate bundle makes admission fail closed.
Custom resource definitions6Per-file delivery can race the definitions the resources depend on.

A flattening-safety verdict has decided this version: crds-enabled:flatten-with-routes; default:flatten-with-routes. The verdict records one disposition per construct and names any companion artifact a flattened bundle must ship. What the flattening verdict means.

A construct being present does not make a chart unflattenable. Most are switched on or off by values, and a verdict records which ones the base you choose actually reaches. Read the catalog-wide evidence for how common each one is.

What The Starting Configuration Records

A base variant is a starting configuration we have already rendered and checked. Pick the one whose trade-off you want; the table below shows what each one changes. How the values for each are chosen.

The crds-enabled base-variant record connects those Helm inputs to the Kubernetes objects, remaining requirements, hooks, CRDs, checks, and OCI status. Open it when you need the complete starting record rather than only the rendered YAML.

Open the full rendered YAML to read the actual manifest output. The render record and setup section explain the inputs, tests, CRDs, hooks, and other work around it.

If new Helm values create a useful starting configuration, record another base variant with its own inputs and checks. If one environment changes a field after rendering, record that change in a ConfigHub variant.

KeyWhere to look firstWhat it means
Package users pulloci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2@sha256:b688d5ef7ae759bd73d2970528a7192e14058bc593a8601b6af12157270c6d2cThe exact installer package for this chart version. The version tag is readable, and the manifest digest makes a published pull immutable. Public catalog package refs are published in Google Artifact Registry with anonymous read access. No ConfigHub account or Google registry login is needed for the local setup path.
Required before applyNone recorded for the recommended base variant.
No separate setup command recorded.
External resources the recommended base variant expects, such as an existing Secret, namespace, CRD, or target fact.
Kubernetes objectsfull rendered YAMLThe full YAML captured from this base variant. It is the output of the render.
Render recordcrds-enabled render intentThe Helm inputs and evidence links that explain how the output was produced.
Complete starting recordcrds-enabled base-variant recordThe record that connects the Helm inputs, Kubernetes objects, remaining requirements, setup work, checks, and OCI status.
Hooks, CRDs, and setup workthis page's setup sectionInstructions and decisions for hooks, CRDs, generated Secrets, setup jobs, cluster requirements, or blockers.

Choose base variant

Pick the supported Helm configuration for this chart: default, no-CRDs, existing Secret, HA, server-only, or another listed option.

Record inputs

Keep the values, namespace, release name, source lock, crds-enabled render intent, full YAML output, package base, test results, and setup instructions together.

Handle chart extras

CRDs, hooks, setup jobs, external Secrets, target facts, and webhook certificates are recorded as chart-specific choices. Some are included in a base variant, some need a setup step, and some are blocked until there is a safe path.

How render intents work · All generated render intents · All base variant records

Try This Chart

Start with crds-enabled. If a card says review or preparation is needed, treat that as a real limit rather than a ready install.

Package image

Exact package: oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2@sha256:b688d5ef7ae759bd73d2970528a7192e14058bc593a8601b6af12157270c6d2c
publication receipt recorded · open the exact publication receipt

Readable version tag: oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2. The package is pinned so a republished tag cannot change what you get. The command below uses the exact manifest digest, so cub installer refuses different package bytes.

Check the package identity

cub installer inspect oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2@sha256:b688d5ef7ae759bd73d2970528a7192e14058bc593a8601b6af12157270c6d2c --json

Read how each configuration was made

cub installer pull 'oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2@sha256:b688d5ef7ae759bd73d2970528a7192e14058bc593a8601b6af12157270c6d2c' --work-dir ./package-review
less ./package-review/package/records/README.md

The package's records/ directory connects every base to its source choices, Helm render intent, Kubernetes objects, prerequisites, lifecycle work, and checks. These are supporting records, not Kubernetes objects.

Verify the package publisher

Run this command with cosign. It checks the expected publisher, the exact manifest digest, and the package annotations.

cosign verify --certificate-identity helm-expt-package-signer@nth-fort-499605-q5.iam.gserviceaccount.com --certificate-oidc-issuer https://accounts.google.com --annotations confighub.com/package-path=packages/jetstack/cert-manager/v1.20.2 --annotations confighub.com/package-sha256=63ad0e0f931fcb9fab89af1c5e78297bc3a32bee841d13413211b612818606f9 europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2@sha256:b688d5ef7ae759bd73d2970528a7192e14058bc593a8601b6af12157270c6d2c

A valid signature identifies who signed these package bytes. It does not show that the configuration is suitable for your cluster; use this page's checks and setup instructions for that decision.

Signature receipt · Sigstore bundle · How signature verification works

Public catalog package refs are published in Google Artifact Registry with anonymous read access. No ConfigHub account or Google registry login is needed for the local setup path.

Recommended first command

cub installer setup --pull oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2@sha256:b688d5ef7ae759bd73d2970528a7192e14058bc593a8601b6af12157270c6d2c --base crds-enabled --work-dir ./jetstack-cert-manager-v1-20-2-crds-enabled --non-interactive --namespace cert-manager

Advanced: apply it or upload it

Run the whole sequence as one script, prerequisites included: try.sh renders and applies to Kubernetes without an account; confighub.sh renders and uploads to your ConfigHub Space.

Before you run try.sh: it changes your current kubectl context. It runs the named prerequisites and applies the rendered objects. Read it first and use a disposable test cluster. confighub.sh does not apply anything to Kubernetes.

You should see something like this

Here is what the command does. cub installer is an open-source plugin for the cub CLI. cub installer setup pulls a catalog package and writes its Kubernetes files locally, leaving delivery to kubectl, Argo CD or Flux. The generated scripts stop before doing any work when the plugin or kustomize is missing.

cub installer setup ...
rendered manifests written under <work-dir>
use the chart option cards below to check pass, watch, blocked, and prerequisites

Current status: Available in the catalog · Reason: Promotion was tested and recorded in ConfigHub.

Use this entry in ConfigHub

Every Catalog entry page carries these five steps in this order. Each step says what the Catalog has run for this entry, and a step with a missing precondition gives no command.

Steps 1 and 2 need no account. Install the cub CLI before any cub command. Step 2 uses cub config diff, which cub plugin install confighub/cub-workshop@v0.6.61 adds. This page covers 2 entries, so open the one you want. A live walk on 2026-10-08 ran steps 3 to 5 for bitnami-nginx-24-0-2-http-clusterip and nvidia-gpu-operator-v26-3-3-default. These commands carry the changes that walk needed. It is a dated log and no receipt, so no state on this page rests on it.

Helm chart, base crds-enabled, version v1.20.2
What is fixed, and what you supply

Fixed when this entry was built. These went into the build, so the objects already carry them. To change one, build the entry again from its source.

  • chart is jetstack/cert-manager
  • version is v1.20.2
  • base is crds-enabled
  • valuesProfile is recipes/jetstack/cert-manager/v1.20.2/effective-values-crds-enabled.yaml
  • namespace is cert-manager
  • releaseName is cert-manager
  • capabilityProfile is {"apiVersions":[],"kubeVersion":"1.30.0"}

Yours to supply or check. The listing records no input for the destination. The Catalog has not ruled one out for your cluster.

This entry's plan, and how to test it

These are the steps that plain objects cannot carry. ConfigHub stores them and does not carry them out. The words in italics say what the Catalog knows about each.

  • When you deliver. CRD ordering declaration for the 6 CustomResourceDefinition(s) this base renders. Who: selected destination actor. Written down. Not run by the Catalog.
  • Once the destination is known. Prune protection for the 6 keep-annotated object(s) this base renders. Who: selected destination actor. Written down. Not run by the Catalog.
  • After you deliver. Route to cert-manager or a certgen lifecycle route for the 2 webhook configuration(s) this base renders. The cert-manager webhook makes its own CA Secret after it starts and the cainjector copies it into both webhook configurations, so you do nothing for this step. Who: the cert-manager webhook and cainjector. Seen in a recorded run.
  • After you deliver. Lifecycle route for the packaged chart's 3 non-test hook occurrence(s). The chart's hooks all belong to one Job that only checks the cert-manager API after an install, and the retained file leaves it out, so check the API yourself afterwards. Who: delivery runtime. Written down. Not run by the Catalog.

Test the install steps yourself. This script carries them out with kubectl on a cluster you choose, with no account. Read it first and use a throwaway cluster. The Catalog has no recorded run of this script.

Test the plain objects. A second script tests the retained objects themselves with kubectl, and it needs no cub and no account. The Catalog has no recorded run of this script.

Compared with plain Helm. The Catalog installed this base beside plain Helm on two local clusters, and the two matched. Read the receipt.

Read what a plan is, and why some entries have one.

1. Get the exact objects Run for this entry

The Catalog rendered this entry and retains its 48 objects in one file.

An upload can create more Units than the objects counted here. The installer renders a Namespace, and the upload adds an installer-record Unit.

# fetch the retained objects for this entry
$ curl -fsSL -o jetstack-cert-manager-v1-20-2-crds-enabled.yaml https://raw.githubusercontent.com/confighub/helm-expt/main/recipes/jetstack/cert-manager/v1.20.2/revisions/crds-enabled/r001/rendered/release-objects.yaml

# check the bytes against the listing
$ shasum -a 256 jetstack-cert-manager-v1-20-2-crds-enabled.yaml
e288b2413bd1919173bee6afcd823be61399f101cfe2cf61f8e0df56740fefe0  jetstack-cert-manager-v1-20-2-crds-enabled.yaml

# render this base from the signed package; step 3 uploads this directory
$ cub installer setup --pull oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2@sha256:b688d5ef7ae759bd73d2970528a7192e14058bc593a8601b6af12157270c6d2c --base crds-enabled --work-dir ./jetstack-cert-manager-v1-20-2-crds-enabled --non-interactive --namespace cert-manager

2. Compare with another version or base Not run for this entry

The listing records no comparison for this entry. The commands run on the retained files, with no account. This version has one other base in the Catalog, default. The Catalog holds 2 other versions, v1.21.0 and v1.21.1.

# fetch the default base of the same version
$ curl -fsSL -o jetstack-cert-manager-v1-20-2-default.yaml https://raw.githubusercontent.com/confighub/helm-expt/main/recipes/jetstack/cert-manager/v1.20.2/revisions/default/r001/rendered/release-objects.yaml

# list what differs between the two bases
$ cub config diff jetstack-cert-manager-v1-20-2-crds-enabled.yaml jetstack-cert-manager-v1-20-2-default.yaml --summary

# fetch the crds-enabled base at version v1.21.0
$ curl -fsSL -o jetstack-cert-manager-v1-21-0-crds-enabled.yaml https://raw.githubusercontent.com/confighub/helm-expt/main/recipes/jetstack/cert-manager/v1.21.0/revisions/crds-enabled/r001/rendered/release-objects.yaml

# list what changes from v1.20.2 to v1.21.0
$ cub config diff jetstack-cert-manager-v1-20-2-crds-enabled.yaml jetstack-cert-manager-v1-21-0-crds-enabled.yaml --summary

3. Upload it as a variant Run for this entry

The Catalog saved this entry in ConfigHub. The commands use its signed installer package. Read the log of the live walk on 2026-10-08 · Read the record that states this.

Replace each value in angle brackets with a name of your own. The entry id may already exist as a Space in your organization, and the package name as a Component.

In the live walk, a Space named for the nginx entry's id and a Component named bitnami-nginx already existed, so the walk chose its own names. The --component flag sets the Component label the upload writes on the Space, which is the package name when you omit it.

The cub installer plugin reads your organization from CUB_CONTEXT and ignores --context. If you use a context other than your default, export CUB_CONTEXT first, or the plugin works in your default organization.

# sign in; steps 3 to 5 write to your ConfigHub organization
$ cub auth login

# upload step 1's directory as a Space of Units, under names you choose
$ cub installer upload --work-dir ./jetstack-cert-manager-v1-20-2-crds-enabled --space <your-space> --component <your-component>

# list the Units the upload created
$ cub unit list --space <your-space>

4. Deploy it Not run for this entry

No delivery run is recorded for this entry. Argo CD has not run, Flux has not run, and kubectl has not run. The commands name the Target workshop/target, which cub cluster up --name workshop creates on a local kind cluster with Argo CD. Use your own Target for a real destination. The coverage lanes record a local Kubernetes run and a GitOps OCI run for this base. They are separate from the delivery record this step reads. Read the log of the live walk on 2026-10-08.

Use the Space name you chose in step 3. The delete command is needed because the cloned installer-record Unit carries the Target and Argo CD v3.5.4 cannot read it, a defect seen on cub v0.8.7 and server v0.8.9.

Without that line the walk deployed nothing and Argo CD showed Unknown, while every cub command exited 0. The walk ran the four commands in this order and did not try them without the first publish.

ConfigHub shows nothing when Argo CD fails to read a Release. Run kubectl -n argocd get applications.argoproj.io and read the Sync column, because Healthy alone is not a pass. Argo CD took between 18 seconds and about 5 minutes to read a Release on a cluster made without argobot.

The walk made its cluster with cub cluster up --no-argobot. That command creates two Spaces, a Worker, a Target and a Trigger, opens ports 30010 to 30019 on the machine, and installs Argo CD from an unpinned upstream manifest.

Removing the ConfigHub side does not remove the workload. In the walk, deleting the Application Unit and the Spaces left the Application and its pods running, because the root Application does not prune.

# clone the base onto a Target as a dev variant
$ cub variant create dev <your-space> --target workshop/target --space-pattern "template:<your-space>-dev"

# publish the Release that the cluster's Argo CD pulls
$ cub release publish <your-space>-dev

# delete the installer record, which Argo CD cannot read
$ cub unit delete --space <your-space>-dev installer-record

# publish again without it
$ cub release publish <your-space>-dev

5. Promote a change Partly run for this entry

A promotion ran for this entry. It ran the preview and the promote. The delete and the publish below have no recorded run for this entry. Promotion carries a change in the base to the dev variant. The base changes when you edit a Unit or upload a newer version into the same Space. Read the log of the live walk on 2026-10-08 · Read the record that states this.

The promotion changes the dev Space and publishes nothing. It also adds the installer-record Unit back with the Target. The change reaches the cluster only after the delete and the publish.

The preview lists the whole installer record as added. In the walk, the preview of a one-label change to gpu-operator ran to 405 lines, and about 400 of them were that record.

# preview what the dev variant would take from the base
$ cub variant promote <your-space>-dev --dry-run -o mutations

# promote once you have read the preview
$ cub variant promote <your-space>-dev --change-desc "Pull the reviewed base forward"

# delete the installer record that the promotion adds back
$ cub unit delete --space <your-space>-dev installer-record

# publish the Release that carries the change
$ cub release publish <your-space>-dev
Helm chart, base default, version v1.20.2
What is fixed, and what you supply

Fixed when this entry was built. These went into the build, so the objects already carry them. To change one, build the entry again from its source.

  • chart is jetstack/cert-manager
  • version is v1.20.2
  • base is default
  • valuesProfile is recipes/jetstack/cert-manager/v1.20.2/effective-values.yaml
  • namespace is cert-manager
  • releaseName is cert-manager
  • capabilityProfile is {"apiVersions":[],"kubeVersion":"1.30.0"}

Yours to supply or check. The destination must have these before the objects are applied. The words in italics say what the Catalog knows about each.

  • cert-manager CRD managed outside this default base. Apply the crds-enabled base CRDs or install cert-manager CRDs before applying this base Declared. Not checked on any destination.
  • cert-manager CRD managed outside this default base. Apply the crds-enabled base CRDs or install cert-manager CRDs before applying this base Declared. Not checked on any destination.
  • cert-manager CRD managed outside this default base. Apply the crds-enabled base CRDs or install cert-manager CRDs before applying this base Declared. Not checked on any destination.
  • cert-manager CRD managed outside this default base. Apply the crds-enabled base CRDs or install cert-manager CRDs before applying this base Declared. Not checked on any destination.
  • cert-manager CRD managed outside this default base. Apply the crds-enabled base CRDs or install cert-manager CRDs before applying this base Declared. Not checked on any destination.
  • cert-manager CRD managed outside this default base. Apply the crds-enabled base CRDs or install cert-manager CRDs before applying this base Declared. Not checked on any destination.
This entry's plan, and how to test it

These are the steps that plain objects cannot carry. ConfigHub stores them and does not carry them out. The words in italics say what the Catalog knows about each.

  • Before you deliver. The installer package includes these CRDs as prerequisites/target-facts/default-crds.yaml. Apply the missing CRDs server-side and leave existing CRDs under their current owner. The listing gives the rest. Who: delivery workflow. Written down. Not run by the Catalog.

Test the install steps yourself. This script carries them out with kubectl on a cluster you choose, with no account. Read it first and use a throwaway cluster. The Catalog has no recorded run of this script.

Test the plain objects. A second script tests the retained objects themselves with kubectl, and it needs no cub and no account. The Catalog has no recorded run of this script.

Compared with plain Helm. The Catalog installed this base beside plain Helm on two local clusters, and the two matched. Read the receipt.

Read what a plan is, and why some entries have one.

1. Get the exact objects Run for this entry

The Catalog rendered this entry and retains its 42 objects in one file.

An upload can create more Units than the objects counted here. The installer renders a Namespace, and the upload adds an installer-record Unit.

# fetch the retained objects for this entry
$ curl -fsSL -o jetstack-cert-manager-v1-20-2-default.yaml https://raw.githubusercontent.com/confighub/helm-expt/main/recipes/jetstack/cert-manager/v1.20.2/revisions/default/r001/rendered/release-objects.yaml

# check the bytes against the listing
$ shasum -a 256 jetstack-cert-manager-v1-20-2-default.yaml
45029db19d75e578bec74b82a0476a6580d1f7193239a210bf4873156ac725ce  jetstack-cert-manager-v1-20-2-default.yaml

# render this base from the signed package; step 3 uploads this directory
$ cub installer setup --pull oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2@sha256:b688d5ef7ae759bd73d2970528a7192e14058bc593a8601b6af12157270c6d2c --base default --work-dir ./jetstack-cert-manager-v1-20-2-default --non-interactive --namespace cert-manager

2. Compare with another version or base Not run for this entry

The listing records no comparison for this entry. The commands run on the retained files, with no account. This version has one other base in the Catalog, crds-enabled. The Catalog holds 2 other versions, v1.21.0 and v1.21.1.

# fetch the crds-enabled base of the same version
$ curl -fsSL -o jetstack-cert-manager-v1-20-2-crds-enabled.yaml https://raw.githubusercontent.com/confighub/helm-expt/main/recipes/jetstack/cert-manager/v1.20.2/revisions/crds-enabled/r001/rendered/release-objects.yaml

# list what differs between the two bases
$ cub config diff jetstack-cert-manager-v1-20-2-default.yaml jetstack-cert-manager-v1-20-2-crds-enabled.yaml --summary

# fetch the default base at version v1.21.0
$ curl -fsSL -o jetstack-cert-manager-v1-21-0-default.yaml https://raw.githubusercontent.com/confighub/helm-expt/main/recipes/jetstack/cert-manager/v1.21.0/revisions/default/r001/rendered/release-objects.yaml

# list what changes from v1.20.2 to v1.21.0
$ cub config diff jetstack-cert-manager-v1-20-2-default.yaml jetstack-cert-manager-v1-21-0-default.yaml --summary

3. Upload it as a variant Run for this entry

The Catalog saved this entry in ConfigHub. The commands use its signed installer package. Read the log of the live walk on 2026-10-08 · Read the record that states this.

Replace each value in angle brackets with a name of your own. The entry id may already exist as a Space in your organization, and the package name as a Component.

In the live walk, a Space named for the nginx entry's id and a Component named bitnami-nginx already existed, so the walk chose its own names. The --component flag sets the Component label the upload writes on the Space, which is the package name when you omit it.

The cub installer plugin reads your organization from CUB_CONTEXT and ignores --context. If you use a context other than your default, export CUB_CONTEXT first, or the plugin works in your default organization.

# sign in; steps 3 to 5 write to your ConfigHub organization
$ cub auth login

# upload step 1's directory as a Space of Units, under names you choose
$ cub installer upload --work-dir ./jetstack-cert-manager-v1-20-2-default --space <your-space> --component <your-component>

# list the Units the upload created
$ cub unit list --space <your-space>

4. Deploy it Not run for this entry

No delivery run is recorded for this entry. Argo CD has not run, Flux has not run, and kubectl has not run. The commands name the Target workshop/target, which cub cluster up --name workshop creates on a local kind cluster with Argo CD. Use your own Target for a real destination. The listing records 6 inputs that the destination must supply, so read them before you deploy. The coverage lanes record a local Kubernetes run and a GitOps OCI run for this base. They are separate from the delivery record this step reads. Read the log of the live walk on 2026-10-08.

Use the Space name you chose in step 3. The delete command is needed because the cloned installer-record Unit carries the Target and Argo CD v3.5.4 cannot read it, a defect seen on cub v0.8.7 and server v0.8.9.

Without that line the walk deployed nothing and Argo CD showed Unknown, while every cub command exited 0. The walk ran the four commands in this order and did not try them without the first publish.

ConfigHub shows nothing when Argo CD fails to read a Release. Run kubectl -n argocd get applications.argoproj.io and read the Sync column, because Healthy alone is not a pass. Argo CD took between 18 seconds and about 5 minutes to read a Release on a cluster made without argobot.

The walk made its cluster with cub cluster up --no-argobot. That command creates two Spaces, a Worker, a Target and a Trigger, opens ports 30010 to 30019 on the machine, and installs Argo CD from an unpinned upstream manifest.

Removing the ConfigHub side does not remove the workload. In the walk, deleting the Application Unit and the Spaces left the Application and its pods running, because the root Application does not prune.

# clone the base onto a Target as a dev variant
$ cub variant create dev <your-space> --target workshop/target --space-pattern "template:<your-space>-dev"

# publish the Release that the cluster's Argo CD pulls
$ cub release publish <your-space>-dev

# delete the installer record, which Argo CD cannot read
$ cub unit delete --space <your-space>-dev installer-record

# publish again without it
$ cub release publish <your-space>-dev

5. Promote a change Partly run for this entry

A promotion ran for this entry. It ran the preview and the promote. The delete and the publish below have no recorded run for this entry. Promotion carries a change in the base to the dev variant. The base changes when you edit a Unit or upload a newer version into the same Space. Read the log of the live walk on 2026-10-08 · Read the record that states this.

The promotion changes the dev Space and publishes nothing. It also adds the installer-record Unit back with the Target. The change reaches the cluster only after the delete and the publish.

The preview lists the whole installer record as added. In the walk, the preview of a one-label change to gpu-operator ran to 405 lines, and about 400 of them were that record.

# preview what the dev variant would take from the base
$ cub variant promote <your-space>-dev --dry-run -o mutations

# promote once you have read the preview
$ cub variant promote <your-space>-dev --change-desc "Pull the reviewed base forward"

# delete the installer record that the promotion adds back
$ cub unit delete --space <your-space>-dev installer-record

# publish the Release that carries the change
$ cub release publish <your-space>-dev

After You Render It

The first command writes files and does not apply them. Read the objects and setup requirements, then choose the next job.

JobNext step
Render and inspect without applyingRun the recommended cub installer setup command above.
Run shared local configuration checkscub plugin install confighub/homebrew-tap@cub-scan-v0.7.3 --name scan
cub check --format json --output cub-check.json <work-dir>/out/manifests. The check is advisory and does not apply anything.
Apply the rendered manifests with kubectl, or publish reviewed objects as OCIPublish reviewed objects as OCI or apply the manifests with kubectl.
Save the reviewed result for a teamSave and upload the reviewed result to ConfigHub for shared history, exact diffs, and approvals.
Compare development and production, audit an exact diff, promote, or roll backBuild a promotion review or read the bounded rollback example.
Assign the configuration to clusters and operate a small fleetChoose targets, preview a wave, and inspect every result.
Check delivery limitsRead the current limits before choosing kubectl, Argo CD, or Flux.
Handle CRDs on the first installRead the CRD ordering risk and first-install guide, then check this chart's recorded owner and plan.

Available Configurations

Each card is one available way to use this chart in the catalog. Some cards are runnable base variants. Others are candidate paths, derived variants, or review notes that explain what still has to be prepared.

Checks: Each card names what was checked and says whether it passed, needs review, was blocked, was not run, or was not needed.

3 matrix rows for jetstack/cert-manager@v1.20.2 · open the full matrix

F1 · Source chart

(source)

Source

Pinned upstream chart and version

Status
Available in the catalog
How to run
This is the upstream chart source. Choose a base card below before running the installer.
Evidence
Pinned chart source and dependency lock
Hooks/actions
No separate hook or action for this row.
Who runs actions?
No separate action runner for this row.
Next
Choose a chart configuration before rendering or deploying
Reason
This is the chart source. Choose a configuration before checking deployment or promotion
Helm outputNot neededSaved in ConfigHubNot neededLocal clusterNot neededSetup stepNot neededGitOps and OCINot neededLive Helm comparisonNot neededTwo clustersNot neededPromotionNot needed
F2a · Chart default

default

Base

Runnable base variant made from the chart defaults

Status
Available in the catalog
Helm values
effective-values.yaml
ConfigHub changes
None in this catalog base. After upload, read Unit revision history or the derived variant.
How to run
cub installer setup --pull oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2@sha256:b688d5ef7ae759bd73d2970528a7192e14058bc593a8601b6af12157270c6d2c --base default --work-dir ./jetstack-cert-manager-v1-20-2-default --non-interactive --namespace cert-manager
Scripts
try.sh renders, settles the prerequisites in order, and applies with kubectl; confighub.sh renders and uploads to your ConfigHub Space.
Evidence
Live helm vs confighub parity
Hooks/actions
No separate hook or action for this row.
Who runs actions?
No separate action runner for this row.
Lifecycle record
The current review found no separate hook or setup step for this base. Open the full record.
Prerequisites
6 prerequisites are declared for this base. Each prerequisite says whether it must be checked before render or before apply.
Next
Write or fix the receipt for cluster requirement checks before deployment
Reason
Promotion was tested and recorded in ConfigHub.
Helm outputPassedSaved in ConfigHubPassedLocal clusterPassedSetup stepPassedGitOps and OCIPassedLive Helm comparisonPassedTwo clustersPassedPromotionPassed
F2b · Helm-rendered base

crds-enabled

Base

Runnable base variant made with different Helm values

Status
Available in the catalog
Helm values
effective-values-crds-enabled.yaml
ConfigHub changes
None in this catalog base. After upload, read Unit revision history or the derived variant.
How to run
cub installer setup --pull oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2@sha256:b688d5ef7ae759bd73d2970528a7192e14058bc593a8601b6af12157270c6d2c --base crds-enabled --work-dir ./jetstack-cert-manager-v1-20-2-crds-enabled --non-interactive --namespace cert-manager
Scripts
try.sh renders, settles the prerequisites in order, and applies with kubectl; confighub.sh renders and uploads to your ConfigHub Space.
Evidence
Live helm vs confighub parity
Hooks/actions
No separate hook or action for this row.
Who runs actions?
No separate action runner for this row.
Lifecycle record
The current review found no separate hook or setup step for this base. Open the full record.
Prerequisites
The support review found no separate target prerequisite for the supported crds-enabled base for the recorded cub-lk-kind-vanilla test target in namespace cert-manager, delivered from ConfigHub OCI through Argo CD. Evidence: Support decision · Target evidence.
Next
Write or fix the receipt for cluster requirement checks before deployment
Reason
Promotion was tested and recorded in ConfigHub.
Helm outputPassedSaved in ConfigHubPassedLocal clusterPassedSetup stepPassedGitOps and OCIPassedLive Helm comparisonPassedTwo clustersPassedPromotionPassed

Local Configuration Checks

We ran cub check v0.7.3 against the exact rendered objects for every configuration below. The result is advisory: read each finding and decide whether it matters for your target.

Scanner and ruleset identity

Pattern bundle: v0.7.3
Bundle manifest: sha256:0405f6ffe21e567adf5d6a732d181c7f228194920456d046b4338baeb14de1a8
Risk catalog: sha256:7ff79a126ad99bba2505fec8b2b7711c03f50eb362141128ec1c83e27a5036ba

ConfigurationAdvisory resultExact inputCheckedEvidence
crds-enabled20 advisory findings
6 critical, 11 warning, 3 info
ClusterRole grants secrets read permissions
Deployment containers omit resource limits
Deployment containers omit resource requests
48 objects
sha256:c8ae0512bdca51da1f120f0cd1dab8ce424991ad42d04a7f8b9c7b9e9d4df7dd
2026-09-16Full cub check result
Exact YAML
Separate Catalog review
default20 advisory findings
6 critical, 11 warning, 3 info
ClusterRole grants secrets read permissions
Deployment containers omit resource limits
Deployment containers omit resource requests
42 objects
sha256:2e055ddce147a4ebd296757180bf793e29321489d831a9e076587e3ad678f063
2026-09-16Full cub check result
Exact YAML
Separate Catalog review

What this does not check: hook execution, CRD readiness, target Secrets and cloud services, admission behavior, workload health, or rollback. The linked Catalog review covers chart-specific source and operating questions. ConfigHub validation and approval are separate managed controls.

Read all shared check results and the mapping to Catalog rules.

Images This Chart Pulls

Every reference below comes from the reviewed rendered output. What you see is what the cluster pulls. These references are data: you can change a registry or pin a digest with a recorded edit, and prove the change landed in every environment.

Base variantImages
defaultquay.io/jetstack/cert-manager-cainjector:v1.20.2
quay.io/jetstack/cert-manager-controller:v1.20.2
quay.io/jetstack/cert-manager-webhook:v1.20.2
crds-enabledquay.io/jetstack/cert-manager-cainjector:v1.20.2
quay.io/jetstack/cert-manager-controller:v1.20.2
quay.io/jetstack/cert-manager-webhook:v1.20.2

First-Run Caveats

Some chart paths need a small preparation step before the cub path feels as smooth as Helm. We show those steps here so the first run does not surprise you.

CaveatWhat to do
Universal caveatsUse declared inputs or bases instead of Helm --set. For direct delivery, define pruning and field-conflict behavior. Use Argo CD or Flux when that controller path and its pruning settings are recorded for the selected preset.
Shared placeholder passwordNo shared placeholder password caveat recorded for this chart.
CRD first-orderingYes. 6 CRD object(s) are recorded. Follow the base's recorded plan: apply CRDs first and wait, use a controller-specific ordering rule, or choose the separable CRD base when one is available.

Open the all-chart adoption caveats · Helm to cub migration · cub deployment path

Advice And Current Status

Use this section to see which chart-specific guides apply, what you must provide, and what work remains.

PlaybookWhy it applies
Serious Chart Playbooksa named hard chart, or one that combines CRDs and admission webhooks
Large App Evidence Funnelrenders many Units, so a single pass/fail can hide where an operation is stuck
Live Parityhas live, GitOps/OCI, or two-cluster parity work
QuestionCurrent answer
User statusReady to try
Can I use it?Use the public catalog entry, then check the exact configuration and its tests.
First basecrds-enabled
Exact installer packageoci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/jetstack-cert-manager:v1.20.2@sha256:b688d5ef7ae759bd73d2970528a7192e14058bc593a8601b6af12157270c6d2c
Tests completedCatalog supported with live evidence (render parity 2/2; Local live 2/2; Live parity 2/2)
CoverageCovered
You must providenothing beyond a cluster and namespace
What the tools recordexact rendered objects with render parity and receipts; optional chart inputs handled by reviewed base configurations
Next actionwrite or fix the receipt for cluster requirement checks before deployment

The source data lives in chart skills and chart evidence router.

What Has Been Tested

Choose the question you care about. Not checked means this catalog has no version-specific result; it is not a pass.

QuestionStatusEvidence
Can I pull these exact package bytes again? Checked Package receipt
What does this chart contain? Checked Source lock · Chart guide · Render result · All 6 evidence links
Does the recorded render match Helm? Checked Render result 1 · Render record · Render result 2 · All 4 evidence links
Did the supplied values change the render? Not checked No linked result
Were hooks, CRDs, or setup steps checked? Checked Version results below
Did this version run on a local Kubernetes cluster? Checked Version results below
Did an OCI delivery through GitOps run? Checked Version results below
Did Helm and ConfigHub reach the same live result? Checked Live comparison 1 · Live comparison 2
Was the result compared on separate clusters? Checked Version results below
Was a ConfigHub promotion tested? Checked Promotion receipt 1 · Promotion receipt 2
Did this version string point at changed upstream bytes? Not checked No linked result

How much is proven, and what more testing would add: Fully proven: Render parity, ConfigHub proof, Local live, GitOps/OCI live, Live Helm-vs-ConfigHub, Two-cluster kind.

BaseReadinessRenderConfigHubLocal liveGitOps/OCILive parityTwo-cluster kind
crds-enabledstart-herepasspasspasspasspasspass
defaultstart-herepasspasspasspasspasspass

What You Must Provide

exact rendered objects with render parity and receipts; optional chart inputs handled by reviewed base configurations

FieldValue
Known quirksoptional chart inputs
You must providenothing beyond a cluster and namespace
What ConfigHub recordsexact rendered objects with render parity and receipts; optional chart inputs handled by reviewed base configurations
Optional chart inputsRaw/extra manifests; Tpl powered values
How optional inputs are handledKeep empty in supported bases; Or make a reviewed installer base when populated

Hooks, CRDs, And Setup Work

Some Helm charts need work before, during, or after apply: CRDs, hooks, setup jobs, webhook certificates, migrations, generated Secrets, or checks. For each chart, the catalog should make the choice clear: include it in the base variant, split it into a separate base variant, run a setup step, use a GitOps action where evidence exists, require an existing target resource, or block it when there is no safe default.

What each base needs before apply

These requirements come from the same base definition as the rendered objects. The render intent keeps the chart inputs, required Secrets or CRDs, lifecycle steps, and evidence together.

Base variantRequired resourceHow to provide itFull record
default6 CRDsIncluded in the OCI package as prerequisites/target-facts/default-crds.yaml. It applies missing CRDs server-side. The generated try script leaves existing CRDs under their current owner and waits for them before the workload.full render intent

If no plan is shown, that does not prove the upstream chart has no hooks. It means the public catalog has no chart-specific action to show yet; check the matrix or send a problem chart if hook behavior should be modeled. Direct apply, Argo CD, Flux, and upgrade implementations are tracked separately. One passing implementation does not prove the others.

Modeled action areaCurrent status
Checks and policies already reviewedCRD lifecycle and upgrade policy; cluster RBAC review; optional input sources and scan policy; hook and setup order; warning review and apply-gate policy; webhook readiness and failure policy
Checks and policies still opencluster requirement checks before deployment
Why this lifecycle status is shownThe recipe records no separate Helm hooks, and 2 of 2 lifecycle checks passed.
Lifecycle test recordsOpen lifecycle record 1
Open lifecycle record 2
Production review recordsOpen review record 1
Open review record 2
Open review record 3
Open review record 4
Open review record 5
Open review record 6

Before Production

A green render or local live result is not a production support claim. Production support is target-scoped and uses the support-decision artifact when present.

FieldValue
Production review statusBlocked
Target-scoped support decisionsupported
Supported basecrds-enabled
Target scopevanilla kind (historical receipt); namespace=cert-manager; delivery=confighub-oci; controller=argo
Accepted limitsCRD lifecycle and upgrade policy; cluster RBAC review; optional input sources and scan policy; hook and setup order; warning review and apply-gate policy; webhook readiness and failure policy
Open policy decisionscluster requirement checks before deployment
Next actionKeep the target-scoped evidence fresh before using this supported scope as a production-support example; create separate issuer, certificate, provider, or hardened resource bases for real customer certificate workloads.

Source And Evidence Files

Technical notes and disclaimers

  • crds-enabled. The plain-objects script applies the objects and ends. It does not wait for the workloads to start. Neither script runs the steps the plan names for an upgrade or a delete.
  • default. The plain-objects script stops before it applies anything. One step of the plan is yours to do first, and it prints it. When you run it again it applies the objects and ends. It does not wait for the workloads to start. Neither script runs the steps the plan names for an upgrade or a delete.

Generated from the catalog data and linked test results. Check the current evidence before using a configuration in production.