Available unit drivers
A unit driver implements one unit kind. A unit is the named instance in an environment DAG; the driver supplies the behavior for that instance. Drivers can expose independent capabilities:
- planning previews external work without changing external state;
- materialization produces files in the desired tree;
- reconciliation applies the desired state and publishes a receipt;
- verification checks external state without writing a receipt.
Every driver is registered by its full kind (unit.gitopsctr.io/v1/<Kind>) and
publishes resource schemas for its authored unit, desired unit, and receipt.
Use the pinned authored schema in source repositories and keep the generated
desired and receipt documents under controller ownership.
These are the drivers bundled with the current alpha release, not a complete set. Plugins can register additional unit and artifact kinds; see Resources and API kinds.
Built-in drivers
| Driver | Kind | Capabilities | Typical effect |
|---|---|---|---|
| Terraform | Terraform |
plan, reconcile, verify | plans and applies Terraform configurations |
| OCI images | OciImages |
plan, reconcile | builds and publishes container images |
| Vite OCI bundle | ViteOciBundle |
plan, reconcile | builds a Vite site and publishes an OCI bundle |
| Frontend S3/CloudFront | FrontendS3Cloudfront |
plan, reconcile | pulls a bundle and publishes it to S3/CloudFront |
| Kubernetes manifests | KubernetesManifests |
materialize, plan, reconcile, verify | renders manifests and optionally delivers them |