Skip to content
Nixifest

Resource options

Resources use this option path:

resources.<group>.<version>.<kind>.<name>

Each segment has a role:

  • <group> selects the Kubernetes API group; use core for ungrouped APIs.
  • <version> selects the API version, such as v1.
  • <kind> selects the resource kind, such as ConfigMap or Deployment.
  • <name> identifies the resource in the Nix module and supplies metadata.name by default.

Set metadata.name explicitly to override the final path key. Other metadata, such as metadata.namespace, is passed through to the generated manifest.

Validation

Section titled “Validation”
validation.strict = true;

Strict validation checks built-in resources and generated CRD resources against their schemas during Nix evaluation. It rejects unknown fields and invalid types, enums, and other schema constraints.

With strict validation disabled, resource attributes remain free-form. This can support APIs not covered by the selected schema, but validation happens later when Kubernetes receives the YAML.

Nixifest adds apiVersion, kind, and default metadata, removes null-valued attributes, and exposes the results through config.build.manifests and config.build.yaml. See Resources for a compact example.