kubedog
Kubedog is a Go library for monitoring and tracking Kubernetes resource deployments in CI/CD pipelines. It provides real-time visibility into rollout progress and is actively used by the werf CI/CD platform.
Key facts
Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.
| Field | Value |
|---|---|
| Repository | werf/kubedog |
| Owner | werf |
| Primary language | Go |
| License | Apache-2.0 — OSI-approved |
| Stars | 750 |
| Forks | 50 |
| Open issues | 36 |
| Latest release | v0.13.0 (2025-01-22) |
| Last updated | 2026-06-16 |
| Source | https://github.com/werf/kubedog |
What kubedog is
Kubedog exposes a library API (Multitracker) for watching Kubernetes resources during deployment, with a minimal CLI interface for debugging. Written in Go, it integrates with kubectl and Helm-based workflows to track resource state changes in CI/CD contexts.
Get the kubedog source
Clone the repository and explore it locally.
git clone https://github.com/werf/kubedog.gitcd kubedog# follow the project's README for install & configurationNeed it deployed, integrated, or customized instead? DEV.co ships production installs.
Best use cases
Implementation considerations
- Kubedog is a library first; plan to integrate it into your CI/CD orchestration code rather than use it as a standalone tool.
- Requires direct Kubernetes API access and valid kubeconfig context; ensure CI/CD runner has appropriate RBAC permissions to watch resources.
- Latest release (v0.13.0, Jan 2025) is recent; review changelog and breaking changes when upgrading in production pipelines.
- CLI is minimal and debug-oriented; do not build production automation around CLI parsing or output formats.
- Dependency on trdl (werf's release distribution tool) for recommended installation; evaluate if acceptable in your CI/CD environment.
When to avoid it — and what to weigh
- Standalone CLI Dependency — Do not rely on the CLI for production workflows; it is explicitly marked as minimal and for debug purposes only. Use the library API instead.
- Long-Term Resource Observation — Not designed for continuous monitoring or alerting; intended for short-lived deployment tracking within CI/CD contexts only.
- Multi-Cluster or Fleet Management — Designed for single-cluster deployments; no evident support for cross-cluster or fleet-wide resource tracking.
- Complex Observability Requirements — Lacks built-in metrics export, historical data retention, or integration with observability platforms; supplement with separate monitoring if needed.
License & commercial use
Licensed under Apache License 2.0, a permissive OSI-approved open-source license. Allows commercial use, modification, and distribution with attribution and liability disclaimer.
Apache-2.0 permits commercial use in closed-source products. No commercial licensing restrictions evident. However, confirm compliance with your license audit process for production deployments.
DEV.co evaluation signals
Editorial assessment — not user reviews. Directional, with an explicit confidence level.
| Signal | Assessment |
|---|---|
| Maintenance | Active |
| Documentation | Adequate |
| License clarity | Clear |
| Deployment complexity | Low |
| DEV.co fit | Good |
| Assessment confidence | High |
Kubedog operates with Kubernetes API permissions; ensure least-privilege RBAC bindings for CI/CD service accounts that invoke it. Relies on kubeconfig authentication; rotate credentials regularly. No security audit or vulnerability disclosure policy evident in data. Review dependencies for known CVEs before production use.
Alternatives to consider
kubectl rollout status
Lightweight CLI command for basic rollout tracking; lacks programmatic integration and multiresource support.
Flux CD or ArgoCD
Full GitOps platforms with native rollout tracking, drift detection, and observability; heavier than kubedog but more feature-complete.
Helm hooks or custom shell scripts
Simple, ad-hoc deployment validation; lack structured resource watching and are difficult to scale across complex deployments.
Build on kubedog with DEV.co software developers
Evaluate kubedog for your CI/CD pipeline. Review the library API documentation and assess fit with your orchestration tool before adoption.
Talk to DEV.coRelated open-source tools
Surfaced by semantic similarity across the DEV.co open-source index.
Related on DEV.co
Explore the category and the services that help you build with it.
kubedog FAQ
Can I use kubedog in non-werf CI/CD systems?
Is the kubedog CLI production-ready?
Does kubedog support monitoring multiple Kubernetes clusters?
What is the licensing cost?
Custom software development services
DEV.co is a software development agency delivering custom software development services to companies building on open source. Our software developers and web developers design, integrate, and ship production systems — spanning web development, APIs, AI, data, and cloud. If kubedog is part of your open-source devops roadmap, our team can implement, customize, migrate, and maintain it.
Ready to integrate Kubernetes deployment tracking?
Evaluate kubedog for your CI/CD pipeline. Review the library API documentation and assess fit with your orchestration tool before adoption.