README
¶
Jsonnet-as-a-Service (JaaS)
JaaS evaluates Jsonnet and returns JSON. Run it as a
stateless HTTP renderer (GET /jsonnet/<snippet>), or enable operator mode to
watch JsonnetSnippet and JsonnetLibrary resources and publish the rendered
output as a Flux
ExternalArtifact
that any consumer can deploy — the two flagship pairings are
grafana-operator for dashboards and
stageset-controller for manifest delivery.
📖 Documentation — installation, usage, API reference, tutorials, and contributing — lives at https://jaas.projects.metio.wtf/.
📦 The Helm chart is published at oci://ghcr.io/metio/helm-charts/jaas and
listed on ArtifactHub.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
api
|
|
|
v1
Package v1 holds the JaaS CRD types served at jaas.metio.wtf/v1 when the binary is launched with --enable-flux-integration.
|
Package v1 holds the JaaS CRD types served at jaas.metio.wtf/v1 when the binary is launched with --enable-flux-integration. |
|
hack
|
|
|
flaggen
command
Command flaggen introspects the jaas CLI FlagSet and emits a JSON array describing every flag (name, type, default, usage, group) for the docs site to render.
|
Command flaggen introspects the jaas CLI FlagSet and emits a JSON array describing every flag (name, type, default, usage, group) for the docs site to render. |
|
internal
|
|
|
cliflags
Package cliflags defines the jaas binary's CLI surface in one place so the runtime (main.run) and the documentation generator (hack/flaggen) derive from a single source.
|
Package cliflags defines the jaas binary's CLI surface in one place so the runtime (main.run) and the documentation generator (hack/flaggen) derive from a single source. |
|
eval
Package eval wraps go-jsonnet with the ergonomics JaaS needs: per-call VM construction, deadline-aware evaluation, TLA/ExtVar plumbing, and a pluggable Importer.
|
Package eval wraps go-jsonnet with the ergonomics JaaS needs: per-call VM construction, deadline-aware evaluation, TLA/ExtVar plumbing, and a pluggable Importer. |
|
handler
Package handler implements the HTTP surface: the Jsonnet evaluation endpoint plus the startup, readiness, and liveness probes.
|
Package handler implements the HTTP surface: the Jsonnet evaluation endpoint plus the startup, readiness, and liveness probes. |
|
observability
Package observability holds the OpenTelemetry tracer plumbing the operator opts into via --tracing-endpoint.
|
Package observability holds the OpenTelemetry tracer plumbing the operator opts into via --tracing-endpoint. |
|
operator
Package operator implements the controller-runtime-based reconciler half of JaaS, activated by --enable-flux-integration.
|
Package operator implements the controller-runtime-based reconciler half of JaaS, activated by --enable-flux-integration. |
|
sources
Package sources fetches Flux source artifacts referenced by JaaS CRs.
|
Package sources fetches Flux source artifacts referenced by JaaS CRs. |
|
storage
Package storage holds the on-disk artifact store the operator uses to materialize ExternalArtifact tarballs.
|
Package storage holds the on-disk artifact store the operator uses to materialize ExternalArtifact tarballs. |
|
urlguard
Package urlguard hosts the SSRF-defence checks the operator applies to every URL it follows on behalf of a tenant.
|
Package urlguard hosts the SSRF-defence checks the operator applies to every URL it follows on behalf of a tenant. |
|
webhook/selfsigned
Package selfsigned generates a CA + serving cert for the operator's validating webhook without depending on cert-manager.
|
Package selfsigned generates a CA + serving cert for the operator's validating webhook without depending on cert-manager. |
Click to show internal directories.
Click to hide internal directories.