Hook Route Candidates

A repository document, rendered for the site. View source markdown.

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.

Generated at: 2026-07-30T12:38:02.000Z UTC · source: committed helm-expt evidence for this rendered repository document.

UNOFFICIAL/EXPERIMENTAL - candidate route plans, 2026-06-11.

These are candidates for the maintained hook lifecycle queue, not members of it. Each file is a HookLifecycleRouteCandidate with result: candidate-route-plan - a deliberately different kind from the maintained HookLifecycleRouteReceipt, so a candidate can never be mistaken for an observed receipt. Nothing here executes a hook, observes runtime behavior, or claims production readiness.

Per-chart plans: kong · kubernetes-dashboard · gitlab · airflow-helm · kafka · minio · datadog · thanos · airflow. Compact table: candidates.csv. Assignable next work: work-orders.md · work-orders.csv. Live/rehearsal evidence added so far: bitnami/minio provisioning rendered the values-conditional hook route, applied desired state to a fresh kind cluster, and blocked before hook execution because the pinned upstream image tags no longer resolved from Docker Hub.

Why These Nine

The source top-100 has 11 hook-bearing charts; the maintained queue models 5. The reviewed delta is in data/hook-lifecycle-review/. These nine rows cover the reviewed source-hook and hook-like routes that are not yet maintained lifecycle receipts. Eight rows cover source top-100 hook charts; the apache-airflow row covers hook-like migration jobs even though the source scan did not find Helm hook annotations for that chart row.

PatternCharts hereRoute
Database migration pair (pre-upgrade + post-upgrade, delete policies)kong; kubernetes-dashboard (vendored kong)upgrade action with receipt; Argo CD PreSync/PostSync for GitOps
Migration and sync hooks (post-install + post-upgrade, weights/delete policies)airflow-helmexplicit managed action with receipt; Argo CD PostSync for GitOps
Provisioning Job (post-install, post-upgrade, values-conditional)kafka; minio (and thanos via its vendored minio)explicit managed action with receipt; Argo CD PostSync for GitOps
Vendored lifecycle hookgitlab (vendored traefik)Argo/Flux lifecycle hook after serious-chart review decides the supported base
Environment-conditional hook setdatadogtarget-class preflight plus upgrade/install action with receipt
Hook-like migration Jobs without hook annotationsairflowrecipe-time lifecycle verification before any hook-free claim

Dependency-provided hooks are recorded as such: the dashboard's hooks come from its vendored kong subchart, and the minio plan explicitly covers the thanos-vendored instance. Chart-level review that skips the dependency closure undercounts hooks.

Promotion Path (Per Chart, Exact)

  1. kong/kong - create the cub installer recipe with a DB-less base and a database base; confirm which bases render the migration pair; model the pair as ordered upgrade actions; admit to the maintained queue with a route receipt. Observed status requires a live run, which no candidate claims.
  2. kubernetes-dashboard - create the recipe; render the default base and determine whether the vendored kong migration hooks materialize at all. If not rendered, record a hook-inert-under-default-values fact for that base instead of a route, and keep the route plan for any database-enabled base.
  3. bitnami/kafka - recipe with a provisioning-off default base (hook-free render) and a provisioning-enabled base; route the Job as an explicit managed post-install action with a receipt.
  4. airflow-helm/airflow - create the recipe and decide whether the migration/sync hooks render for the supported base. If they render, route them as explicit managed actions with receipts; if they do not render, record a hook-inert fact for that base.
  5. gitlab/gitlab - treat as a serious-chart review first; confirm whether the vendored Traefik lifecycle hook renders in the supported base; then write a maintained route receipt or a hook-inert fact for that base.
  6. bitnami/minio - same as kafka, reusing one shared route receipt shape for the whole bitnami provisioning pattern. A live rehearsal now proves the render shape and desired-state apply, but blocks on stale upstream image tags before the provisioning Job can run.
  7. datadog/datadog - split target scopes: normal targets where the GKE Autopilot hooks are inert, GKE Autopilot targets where the allowlist work is preflight, and upgrade paths where the migration Job gets a receipt.
  8. bitnami/thanos - record the vendored MinIO provisioning hook as dependency-provided and reuse the MinIO provisioning route shape when a provisioning-enabled base renders it.
  9. apache-airflow/airflow - verify values-conditional lifecycle Jobs at recipe time. A zero Helm-hook annotation count is not a hook-free claim.

Boundaries