plugin-example-builder
| Version | 2026.175.0716 |
| Repo | superproject |
| Plugin | yes — see the plugin reference |
Reference OUT-OF-TREE charly plugin proving the BUILD-TIME plugin-execution
BUILDER leg — a standalone Go module (go.mod + main.go) serving the
examplebuilder builder over go-plugin gRPC via the charly plugin SDK
(github.com/opencharly/sdk). At image build, charly’s build-path connect seam
host-builds + connects this plugin out-of-process and Invokes its OpResolve;
the returned BuilderResolveReply (a multi-stage FROM…AS stage baking
/built.txt + a COPY –from pulling it to /opt/examplebuilder-artifact) is
spliced into the generated Containerfile — so the artifact proves the plugin
EXECUTED at build. The BUILDER-leg counterpart of the verb/step
candy/plugin-example-step; consumed by candy/examplebuilder-consumer’s
external_builder: examplebuilder selection.
Acceptance plan
Section titled “Acceptance plan”This candy’s plan: — the runnable spec charly check executes against a live deployment. check: steps are idempotent probes; run: steps change state.
| Intent | Step |
|---|---|
check |
the out-of-tree build-resolve plugin ships a buildable Go module (go.mod + the provider main) the host can build + serve out-of-process at image build |