Kubling CLI KDV v26.3+
The Kubling CLI, invoked as kdv, creates and manages version-controlled
Kubling projects. A project keeps its runtime configuration, Modules, Compose
services and tests together.
Use the Quickstart to evaluate Kubling. Use KDV when the configuration, tests and deployment inputs must become a maintained project. Start with Install KDV, then create a project using the container-based workflow shown in this documentation.
Scope
KDV provides the Kubling-specific project workflow:
- create projects from maintained starters
- validate and build configuration, descriptors and Modules
- run isolated JavaScript tests and Compose-based integration tests
- manage named development instances through Docker Compose
- prepare deployment artifacts, TLS material and an optional Helm scaffold
SQL terminal KDV v26.5+
The KDV SQL terminal runs interactive or one-shot SQL through Kubling’s client gRPC transport.
KDV does not embed or replace the Kubling runtime. It uses the project environment’s selected image for local workflows and exports the artifacts needed by the production delivery model.
Tool boundaries
| Tool | Responsibility |
|---|---|
| KDV | Kubling project validation, builds, tests and local instance lifecycle |
| Docker Compose | Kubling, providers, supporting services, volumes and integration-test services |
| Make | Optional shortcuts for the local and CI workflow |
| Docker | Optionally build and publish a project-specific runtime image |
| Helm or GitOps | Deploy and reconcile the generated Kubernetes resources |
| Artifact repository | Publish versioned Modules and externally delivered runtime bundles |
KDV is available through multiple distribution channels. Generated projects
include a container-backed launcher pinned to the KDV version used to create
them, which is why the remaining guides use ./kdv for project commands.
Choose the next guide
| Goal | Guide |
|---|---|
| Install the CLI | Install KDV |
| Create and run a complete project | Create a project |
| Query a Virtual Database from a terminal | KDV SQL terminal |
| Move from the former CLI workflow | Migrate to KDV 26.3+ |
| Understand the manifest and generated files | Project structure |
| Manage local environments and instances | Development workflow |
| Test scripts and running services | Testing |
| Prepare production artifacts and Kubernetes resources | Build and deploy |
| Build standalone Modules | Modules |
| Generate TLS material | Certificates |
| Find commands, options and exit codes | Command reference |