mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
305 lines
20 KiB
HTML
305 lines
20 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hanzo-operator</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/hanzo-operator.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-operator">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-operator.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>hanzo-operator</h1><p class="lede">Hanzo Operator is a unified Kubernetes operator that manages all Hanzo production infrastructure declaratively via 7 CRDs under the hanzo.ai/v1alpha1 API group.</p><h1>Hanzo Operator - Kubernetes Operator for Hanzo Infrastructure</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-charts.md</code>, <code>hanzo/hanzo-universe.md</code>, <code>hanzo/hanzo-platform.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>Hanzo Operator is a <strong>unified Kubernetes operator</strong> that manages all Hanzo production infrastructure declaratively via 7 CRDs under the <code>hanzo.ai/v1alpha1</code> API group. Built with Kubebuilder v4 and controller-runtime, it reconciles high-level Hanzo resource specs into the full set of underlying K8s objects (Deployments, StatefulSets, Services, Ingress, HPA, PDB, NetworkPolicy, CronJobs, KMSSecret CRs).</p>
|
|
<h3>Why Hanzo Operator?</h3>
|
|
<ul><li><strong>Declarative infrastructure</strong>: Define an entire Hanzo service, datastore, or network in one CR</li><li><strong>7 CRDs</strong>: HanzoService, HanzoDatastore, HanzoGateway, HanzoMPC, HanzoNetwork, HanzoIngress, HanzoPlatform</li><li><strong>Idempotent reconciliation</strong>: Uses <code>ctrl.CreateOrUpdate</code> with <code>MutateFuncFor</code> for safe convergence</li><li><strong>KMS integration</strong>: Automatically creates <code>kms.hanzo.ai/v1alpha1 KMSSecret</code> CRs for secret management</li><li><strong>Owner references</strong>: Full GC cascade -- deleting the parent CR cleans up all children</li><li><strong>Phase lifecycle</strong>: Pending, Creating, Running, Degraded, Deleting</li></ul>
|
|
<h3>Tech Stack</h3>
|
|
<ul><li><strong>Language</strong>: Go 1.26</li><li><strong>Framework</strong>: Kubebuilder v4, controller-runtime v0.23.1</li><li><strong>K8s API</strong>: k8s.io/* v0.35.0</li><li><strong>Image</strong>: <code>ghcr.io/hanzoai/operator:latest</code></li><li><strong>Namespace</strong>: <code>hanzo-operator-system</code></li><li><strong>Stats</strong>: 28 Go source files, ~7,400 lines, 13,022 lines CRD YAML</li></ul>
|
|
<h2>When to use</h2>
|
|
<ul><li>Deploying Hanzo services to Kubernetes declaratively</li><li>Managing API gateways (KrakenD-based) via HanzoGateway</li><li>Provisioning datastores (PostgreSQL, Redis, MongoDB) via HanzoDatastore</li><li>Running blockchain validator networks via HanzoNetwork</li><li>Managing multi-party computation infrastructure via HanzoMPC</li><li>Orchestrating a full Hanzo platform stack via HanzoPlatform</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>Kubernetes</strong> v1.11.3+ cluster with CRD support</li><li><strong>cert-manager</strong> for TLS (used by HanzoIngress)</li><li><strong>KMS operator</strong> (<code>kms.hanzo.ai</code>) for KMSSecret reconciliation</li><li><strong>RBAC permissions</strong>: core, apps, autoscaling, batch, networking, policy, hanzo.ai/<em>, kms.hanzo.ai/</em></li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | Language | Go 1.26 | | Framework | Kubebuilder v4, controller-runtime v0.23.1 | | API Group | <code>hanzo.ai/v1alpha1</code> | | CRD Count | 7 | | Image | <code>ghcr.io/hanzoai/operator:latest</code> | | Namespace | <code>hanzo-operator-system</code> | | Repo | <code>github.com/hanzoai/operator</code> | | Branch | <code>main</code> | | License | Apache 2.0 |</p>
|
|
<h2>CRD Reference</h2>
|
|
<p>| CRD | Short Name | Creates | |-----|------------|---------| | <strong>HanzoService</strong> | <code>hsvc</code> | Deployment, Service, Ingress, HPA, PDB, NetworkPolicy, KMSSecret | | <strong>HanzoDatastore</strong> | <code>hds</code> | StatefulSet, headless Service, PVC, CronJob (backup), KMSSecret | | <strong>HanzoGateway</strong> | <code>hgw</code> | Deployment, Service, ConfigMap (KrakenD config), Ingress | | <strong>HanzoMPC</strong> | <code>hmpc</code> | StatefulSet, headless Service, Dashboard Deployment, Cache Deployment, Ingress | | <strong>HanzoNetwork</strong> | <code>hnet</code> | StatefulSet (validators), Deployments (bootnode/indexer/explorer/bridge), Services, ConfigMaps | | <strong>HanzoIngress</strong> | <code>hing</code> | Multiple Ingress resources with cert-manager TLS | | <strong>HanzoPlatform</strong> | <code>hplat</code> | Child CRDs (composes all of the above) |</p>
|
|
<h2>Repository Structure</h2>
|
|
<pre><code>api/v1alpha1/
|
|
common_types.go # Shared types (ContainerSpec, IngressSpec, etc.)
|
|
hanzoservice_types.go # HanzoService CRD spec
|
|
hanzodatastore_types.go # HanzoDatastore CRD spec
|
|
hanzogateway_types.go # HanzoGateway CRD spec
|
|
hanzompc_types.go # HanzoMPC CRD spec
|
|
hanzonetwork_types.go # HanzoNetwork CRD spec
|
|
hanzoingress_types.go # HanzoIngress CRD spec
|
|
hanzoplatform_types.go # HanzoPlatform CRD spec
|
|
types.go # Additional shared types
|
|
zz_generated.deepcopy.go # Generated DeepCopy methods
|
|
cmd/
|
|
main.go # Manager entry point
|
|
internal/
|
|
controller/
|
|
hanzoservice_controller.go # HanzoService reconciler
|
|
hanzodatastore_controller.go # HanzoDatastore reconciler
|
|
hanzogateway_controller.go # HanzoGateway reconciler
|
|
hanzompc_controller.go # HanzoMPC reconciler
|
|
hanzonetwork_controller.go # HanzoNetwork reconciler
|
|
hanzoingress_controller.go # HanzoIngress reconciler
|
|
hanzoplatform_controller.go # HanzoPlatform reconciler
|
|
predicates.go # Event filters (createOrUpdatePred, etc.)
|
|
helpers.go # Shared controller utilities
|
|
manifests/ # K8s object builders (builder, labels, mutate)
|
|
status/ # Condition management
|
|
metrics/ # Prometheus metrics
|
|
config/ # Feature gates
|
|
config/
|
|
crd/bases/ # Generated CRD YAML (13k lines)
|
|
rbac/ # ClusterRole, bindings
|
|
manager/ # Deployment template
|
|
samples/ # Sample CRs for all 7 CRDs
|
|
Dockerfile # Multi-stage Go build (Alpine)
|
|
Makefile # Build, test, deploy targets</code></pre>
|
|
<h2>Build and Deploy</h2>
|
|
<pre><code class="lang-bash"># Regenerate CRDs and DeepCopy
|
|
make manifests generate
|
|
|
|
# Build local binary
|
|
make build
|
|
|
|
# Run tests
|
|
make test
|
|
|
|
# Build Docker image
|
|
make docker-build IMG=ghcr.io/hanzoai/operator:latest
|
|
|
|
# Build and push (multi-platform)
|
|
docker buildx build --platform linux/amd64 --push -t ghcr.io/hanzoai/operator:latest .
|
|
|
|
# Install CRDs into cluster
|
|
make install
|
|
|
|
# Deploy operator
|
|
make deploy IMG=ghcr.io/hanzoai/operator:latest
|
|
|
|
# Apply sample CRs
|
|
kubectl apply -k config/samples/</code></pre>
|
|
<h3>Production Deployment</h3>
|
|
<p>Universe manifests at <code>~/work/hanzo/universe/infra/k8s/hanzo-operator/</code>:</p>
|
|
<pre><code class="lang-bash">kubectl apply -k universe/infra/k8s/hanzo-operator/</code></pre>
|
|
<h2>Key Patterns</h2>
|
|
<ul><li><strong>Predicate filtering</strong>: <code>createOrUpdatePred</code>, <code>updateOrDeletePred</code>, <code>statusChangePred</code> control which events trigger reconciliation</li><li><strong>CreateOrUpdate with MutateFuncFor</strong>: Idempotent object reconciliation -- creates if missing, patches if changed</li><li><strong>Owner references</strong>: All child objects have owner refs for automatic garbage collection</li><li><strong>Phase lifecycle</strong>: Resources transition through Pending, Creating, Running, Degraded, Deleting</li><li><strong>KMSSecret delegation</strong>: Operator creates <code>kms.hanzo.ai/v1alpha1 KMSSecret</code> CRs; the existing KMS operator handles actual secret sync from kms.hanzo.ai</li></ul>
|
|
<h2>Troubleshooting</h2>
|
|
<p>| Issue | Cause | Solution | |-------|-------|----------| | RBAC errors on deploy | Missing cluster-admin | Grant cluster-admin or use <code>make deploy</code> | | CRD not found | CRDs not installed | <code>make install</code> first | | KMSSecret not syncing | KMS operator not running | Deploy KMS operator to cluster | | Reconcile loop | Spec drift | Check object mutate functions in manifests/ | | Image pull errors | GHCR auth | Ensure imagePullSecrets configured |</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-charts.md</code> - Helm charts (alternative to operator CRDs)</li><li><code>hanzo/hanzo-universe.md</code> - Universe manifests (where operator is deployed)</li><li><code>hanzo/hanzo-kms.md</code> - KMS for secret management (KMSSecret CRs)</li><li><code>hanzo/hanzo-platform.md</code> - PaaS platform (managed by HanzoPlatform CRD)</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: kubernetes, operator, crds, kubebuilder, infrastructure, go <strong>Prerequisites</strong>: Kubernetes, Go, Kubebuilder concepts</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/hanzo-operator.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |