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]>
288 lines
25 KiB
HTML
288 lines
25 KiB
HTML
<!doctype html>
|
||
<html lang="en"><head>
|
||
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
||
<title>hip-0123</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="/hip-0123.md">
|
||
|
||
<link rel="icon" href="/favicon.svg">
|
||
<link rel="canonical" href="https://hanzoskills.com/hip-0123">
|
||
</head>
|
||
<!-- Reading this with a machine? Every page here is also plain markdown.
|
||
This one: https://hanzoskills.com/hip-0123.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>hip-0123</h1><p class="lede">HIP-123: Visor — Fleet & Fabric Autoscaling Across Any Provider. Status Final. Hanzo architectural specification.</p><h1>HIP-0123: Visor — Fleet & Fabric Autoscaling Across Any Provider</h1>
|
||
<h2>Abstract</h2>
|
||
<p><strong>Visor</strong> (<code>hanzoai/visor</code>, <strong>v1.108.11</strong> live in production via the operator CR) is the fleet and fabric control plane: it provisions machines and clusters on any supported provider, watches workloads across the operated fabric, and <strong>scales the nodes</strong> — up on pending demand, down on measured idle — with org/project attribution carried in the same loop that reports billing. Where Kubernetes HPA scales pods within the nodes a cluster already has, visor scales the <em>nodes themselves</em>, across <em>clusters</em>, across <em>providers</em>, including providers the <strong>customer</strong> brings (HIP-0121 BYOC).</p>
|
||
<p>The target model this HIP formalizes: every service, in its plugin-VM shape (HIP-0106), is an independently schedulable unit; visor scales <strong>just the nodes running that service for that tenant</strong> — per-service, per-org, per-project — on whichever provider that tenant's fleet lives. The realized autoscaler already keys its pools by exactly those labels (<code>hanzo.ai/org</code>, <code>hanzo.ai/project</code>, <code>hanzo.ai/pool</code>); the cross-provider per-tenant placement policy is the decided formalization on top of shipped machinery.</p>
|
||
<h2>Motivation</h2>
|
||
<p>An AI cloud's unit economics live and die on node count. Three forces demand one control plane for it:</p>
|
||
<ol><li><strong>The fabric is already plural.</strong> The operated estate spans eight</li></ol>
|
||
<p> Kubernetes clusters across providers this cycle — Kubernetes estates (<code>do-sfo3-hanzo-k8s</code>, <code>do-sfo3-lux-k8s</code>, <code>do-sfo3-bootnode-k8s</code>, the zoo estate, and siblings) plus BYO k3s fleets such as the spark/evo/dbc reference cluster of HIP-0121. No single cluster's autoscaler can see, size, or bill that fabric as one thing.</p>
|
||
<ol><li><strong>Tenancy must reach the node layer.</strong> HIP-0121 gives every org a</li></ol>
|
||
<p> fleet; HIP-0106 makes every service independently packageable. If scaling stays cluster-global, one tenant's burst dilutes into shared pools — unattributable cost, no per-tenant ceiling, no way to scale <em>only</em> the service that is hot. The scaling unit must be <code>(service, org, project)</code>, not "the cluster".</p>
|
||
<ol><li><strong>BYO provider is a product promise, not a special case.</strong> A</li></ol>
|
||
<p> customer connects their own AWS/Azure/GCP/DO/Hetzner/Nebius account or bare metal (HIP-0121); the platform must provision and scale <em>there</em>, on their credentials, with the same loop it uses for managed estates. A second, customer-specific scaling path would be the classic two-ways defect.</p>
|
||
<p>Visor is where this already lives: it is the machine/cluster provisioner and supervisor, it holds the per-owner sealed provider connectors (HIP-0121), and it ships the autoscaler. This HIP names that role and fixes its contract.</p>
|
||
<h2>Specification</h2>
|
||
<h3>The realized machinery (shipped, in-tree)</h3>
|
||
<p>All of the following is real code in <code>hanzoai/visor</code> at v1.108.x:</p>
|
||
<ul><li><strong>Pod-pressure watcher</strong> — <code>autoscaler/watcher.go</code>. A <code>PodWatcher</code></li></ul>
|
||
<p> is constructed over <code>[]ClusterConfig{ClusterID, ProviderName, Owner}</code> — plural clusters, provider-tagged, owner-attributed — and runs the control loop (30 s checks): a pod pending longer than 60 s triggers scale-up; nodes idling below 30 % CPU and 40 % memory for 10 minutes trigger scale-down. Cooldowns (5 m up / 10 m down) and floor/ceiling (min 2 / max 50 nodes per pool) bound oscillation.</p>
|
||
<ul><li><strong>Tenant attribution in the loop</strong> — pending pods are read with</li></ul>
|
||
<p> their <code>hanzo.ai/org</code> and <code>hanzo.ai/project</code> labels; node pools carry <code>hanzo.ai/pool</code>. The scale decision knows <em>whose</em> demand it is serving at the moment it makes the decision — attribution is not a reporting afterthought.</p>
|
||
<ul><li><strong>Best-fit sizing</strong> — <code>autoscaler/sizing.go</code>. <code>SizeForResources</code></li></ul>
|
||
<p> sums the pending pods' requests and picks the smallest node size that fits from an ordered catalog (DO slugs today: standard → general-purpose → CPU-optimized → memory-optimized), defaulting safe. Node count = max(ceil by CPU, ceil by memory). Existing pools of the right size grow; otherwise a new pool is created.</p>
|
||
<ul><li><strong>Provider backends</strong> — `service/{digitalocean,kubernetes,aws,azure,gcp,</li></ul>
|
||
<p> aliyun,hetzner,lightsail,kvm,pve,vmware}.go<code>: machine and cluster provisioning across managed clouds AND on-prem hypervisors (KVM, Proxmox, VMware), plus managed network/chain provisioning (</code>chain/chainmaker.go` — provider-hosted blockchain networks through the same connector discipline). Per-owner cloud credentials are KMS-sealed per HIP-0121.</p>
|
||
<ul><li><strong>Billing in the same plane</strong> — <code>billing/reporter.go</code> batches</li></ul>
|
||
<p> <code>MeterEvent{MeterID, UserID, Value, Idempotency, Dimensions}</code> to the one commerce metering path; the hourly machine meter and its exactly-once leases are specified in HIP-0121. Scaling and metering reading the same objects is what makes per-tenant cost honest.</p>
|
||
<ul><li><strong>Org-scoped authorization</strong> — <code>authz/</code>: fleet calls are org-bound</li></ul>
|
||
<p> per the IAM boundary (HIP-0111); the org is never a client field.</p>
|
||
<h3>The scaling unit — plugin VM × tenant</h3>
|
||
<p>The unit visor scales is the <strong>(service, org, project) pool</strong>:</p>
|
||
<ol><li><strong>Service</strong> — a plugin VM per HIP-0106. Because every Hanzo service</li></ol>
|
||
<p> builds as an independently deployable unit with an identical mount contract, "scale the ML serving plane" never implies "scale the whole cloud binary". The fat SaaS build stays one deployment; any hot subsystem splits out (HIP-0106 hybrid mode) and gets its own pool.</p>
|
||
<ol><li><strong>Org / project</strong> — the tenant shard, from the same labels the</li></ol>
|
||
<p> watcher already reads. One tenant's burst grows one tenant's pool; ceilings and cooldowns apply per pool, so no tenant can starve the fabric.</p>
|
||
<ol><li><strong>Provider</strong> — a property of the pool's fleet source (HIP-0121):</li></ol>
|
||
<p> a managed estate, a BYO cluster, or the customer's own cloud account. <strong>BYO provider scaling</strong> means visor executes the same sizing/watch loop through the org's own sealed credentials — the nodes appear in <em>their</em> account, billed by <em>their</em> cloud, with Hanzo metering only the management plane (HIP-0121 Tier A).</p>
|
||
<p>The placement rule is deliberately boring: a pool belongs to exactly one <code>(service, org, project, provider)</code> tuple; the watcher scales pools, never anonymous global capacity. Cross-provider "fabric" behavior falls out of plural <code>ClusterConfig</code>s rather than a scheduler rewrite.</p>
|
||
<h3>Relationship to the deployment stack</h3>
|
||
<p>| Concern | Owner | |---|---| | What a service IS (shapes, mount contract) | HIP-0106 | | Where a deployment RUNS (serve / cluster init / helm) | HIP-0117 | | What compute a tenant ATTACHED and what it COSTS | HIP-0121 | | Day-2 reconciliation of service estates (CRs, GitOps) | HIP-0400 operator | | <strong>How many nodes exist, where, for whom</strong> | <strong>HIP-0123 (this)</strong> |</p>
|
||
<p>Visor does not reconcile Deployments — that is the operator's job (HIP-0400); it feeds the node layer those Deployments land on. It does not define the fleet registry or billing tiers — that is HIP-0121; it executes against them. It is not the telemetry plane — that is HIP-0132; the autoscaler reads pod and node state from the cluster.</p>
|
||
<h3>Decided vs shipped</h3>
|
||
<p>Honesty section. As of v1.108.11:</p>
|
||
<ul><li><strong>Shipped:</strong> the multi-cluster <code>PodWatcher</code> (thresholds, cooldowns,</li></ul>
|
||
<p> bounds as specified), best-fit sizing + pool grow/create, org and project attribution labels in the scale path, the provider connector set (clouds + on-prem hypervisors), per-owner sealed credentials, the metering reporter, and the eight-cluster operated fabric. Visor runs in production (<code>do-sfo3-hanzo-k8s</code>, operator CR at tag v1.108.11).</p>
|
||
<ul><li><strong>Decided, staged:</strong> the full **per-tenant per-service</li></ul>
|
||
<p> cross-provider placement policy** — i.e. pools uniformly keyed by the complete <code>(service, org, project, provider)</code> tuple across every provider backend, and scale-execution fanned out beyond Kubernetes node-pool APIs to every connector in the set. Today's watcher executes pool changes through the Kubernetes client (<code>Clients map[clusterID]</code>) while reading demand fabric-wide; generalizing the execution seam to the other shipped connectors is mechanical, not architectural — the sizing, attribution, and provider primitives it composes are all in-tree.</p>
|
||
<h2>Rationale</h2>
|
||
<p><strong>Why not "just use cluster-autoscaler / HPA".</strong> Three mismatches. (1) <em>Scope</em>: upstream autoscalers are per-cluster; the fabric is eight-plus clusters on heterogeneous providers, including customer accounts — the decision must sit above any one cluster. (2) <em>Tenancy</em>: upstream scaling is workload-anonymous; Hanzo's unit of both isolation and <em>billing</em> is the org (HIP-0121), so the scaler must know whose pods it is buying nodes for — attribution inside the loop, not derived later from logs. (3) <em>Provisioning</em>: scale-up on a BYO provider is a <em>provisioning</em> act on sealed customer credentials, which is visor's existing competency, not a k8s add-on's.</p>
|
||
<p><strong>Why the pool is the primitive.</strong> A pool keyed by <code>(service, org, project, provider)</code> is the smallest value that answers every operational question at once — capacity (nodes in pool), blast radius (one tenant's service), cost (metered per the same key), and placement (the provider is part of the key, not runtime discovery). One primitive, four concerns, zero braiding.</p>
|
||
<p><strong>Why visor and not the operator.</strong> The operator (HIP-0400) is declarative reconciliation of <em>what should run</em>; node supply is a feedback controller over <em>live demand</em> with money attached. Different cadence, different failure posture (a wrong reconcile is drift; a wrong scale-up is spend). Keeping the feedback controller in visor — which already owns machines, credentials, and metering — keeps each plane complete and independently auditable.</p>
|
||
<p><strong>Why this is the resell story's load-bearing wall.</strong> HIP-0117 gets a customer's cloud running anywhere; HIP-0121 lets any org attach any compute; this HIP is what makes the result <em>elastic</em> per tenant on infrastructure Hanzo does not own. Composed, they are the OSS AI cloud a reseller can operate: bring a provider, get a fabric that sizes itself and bills honestly.</p>
|
||
<h2>References</h2>
|
||
<ul><li>HIP-0106 — Cloud — Unified Hanzo Binary (hybrid split mode; the</li></ul>
|
||
<p> "auto-scaling per-subsystem" non-goal this HIP picks up at the right layer)</p>
|
||
<ul><li>HIP-0106 — Hanzo Plugin & VM Model (the independently schedulable</li></ul>
|
||
<p> service unit)</p>
|
||
<ul><li>HIP-0117 — Cloud-in-a-Box (the topologies whose node supply this</li></ul>
|
||
<p> HIP manages)</p>
|
||
<ul><li>HIP-0121 — BYO Compute Fleet & Metered Billing (the fleet registry,</li></ul>
|
||
<p> sealed providers, and billing tiers this HIP executes against)</p>
|
||
<ul><li>HIP-0132 — One Telemetry Plane (the telemetry plane; this HIP is the</li></ul>
|
||
<p> node plane)</p>
|
||
<ul><li>HIP-0400 — Service CRD (workload reconciliation above this node</li></ul>
|
||
<p> plane)</p>
|
||
<ul><li><code>hanzoai/visor</code> — <code>autoscaler/{watcher,sizing}.go</code>,</li></ul>
|
||
<p> <code>service/{digitalocean,kubernetes,aws,azure,gcp,aliyun,hetzner,lightsail,kvm,pve,vmware}.go</code>, <code>billing/reporter.go</code>, <code>chain/chainmaker.go</code>, <code>authz/</code></p>
|
||
<ul><li><code>universe/infra/k8s/operator/crs/visor.yaml</code> — the live CR</li></ul>
|
||
<p> (tag v1.108.11)</p>
|
||
<h2>Copyright</h2>
|
||
<p>Copyright and related rights waived via <a href="https://creativecommons.org/publicdomain/zero/1.0/">CC0</a>.</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="/hip-0123.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
||
</footer>
|
||
</div></body></html> |