plugin-k8sgen

Placement	compiled-in (in-process)
Source	github.com/opencharly/plugin-k8sgen/candy/plugin-k8sgen
Version	2026.181.0001
Candy	plugin-k8sgen

This plugin is listed in charly/charly.yml’s compiled_plugins:, so its providers are compiled into the charly binary and register in-process.

Providers

The reserved words this plugin serves:

• k8sgen — verb class

What it does

KUSTOMIZE GENERATOR plugin (C8/M13) — the pure manifest generation that turns a deployment node + a kind:kubernetes cluster template + the image’s ports/uid/gid into a Kustomize base/ + overlays// tree (Deployment/StatefulSet/DaemonSet/Job/ CronJob/Pod, Service, PVCs, Ingress, kustomization wiring). Carved out of charly core (the former charly/k8s_generate.go is DELETED, K-wave 2); GenerateKubernetesKustomize (candy/plugin-fleet/deploy_from_box.go) extracts ports/uid/gid from the image Capabilities, Invokes this plugin’s OpEmit, then does the disk I/O + the host-side egress gate before the bytes hit disk. Compiled-in (the deploy + from-box paths call it).

Parameter schema

The CUE schema below is the authoritative grammar for this plugin’s input. It is the same single source that generates the plugin’s Go parameter types and answers the runtime Describe RPC, so this page cannot disagree with either.

schema/k8sgen.cue

// plugin-k8sgen's OWN self-contained CUE schema — the plugin's declaration
// surface, served over Describe exactly like every other
// plugin's schema (there is no schema-less plugin):
//
//  1. SERVE over Describe — the host splices `base ++ plugin` at the load gate
//     (registerPluginUnitSchema), so the plugin's declarations travel WITH it and
//     a self-contained schema that will not splice is a LOUD load failure.
//  2. DOCUMENT — `charly docs generate` renders this plugin's page from its
//     providers + this schema + the candy `description:`.
//
// verb:k8sgen's authored input is NOT a plugin_input: peers resolve the word and
// Invoke OpEmit with a structured spec.KubernetesGenInput, so this schema DOCUMENTS
// the verb contract (no #*Input def). SELF-CONTAINED: it references no base def, so
// it compiles STANDALONE (the property that lets the SDK compile it serve-side).
#K8sgenPlugin: {
  // The capability word the plugin serves.
  verb: "k8sgen"

  // What the verb does, in one line (the public-docs surface): generate the
  // relative-pathed Kubernetes / Kustomize manifest tree a deploy emits.
  contract: string & !=""
}

---

See also the candy reference for this candy’s install surface.