Build
Connect & operate
Design & teams
Start hereScope a build in one callBring a spec, a wireframe, or a paragraph. You leave with an architecture, a timeline, and a number.Book a scoping call
AI software
LLM & data systems
Vibe coding
Ready to ship?Put AI where the work isAgents, RAG, and private LLMs wired into the systems your team already uses — not a chatbot bolted to a homepage.Discuss an AI project
Domain firstWe learn your workflow before we model itRegulated, operational, or high-volume — the constraints belong in the schema, not in a training doc.Talk about your domain
Plan smarterEstimate before you commitCost ranges, scope templates, and the questions we ask in discovery — free, no form.Open the cost calculator
Real conversationsTalk with a technical leadNo SDR, no discovery gauntlet. The person on the call is the one who scopes the build.Book a call
Open-Source DevOps · werf

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.

Source: GitHub — github.com/werf/kubedog
750
GitHub stars
50
Forks
Go
Primary language
Apache-2.0
License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

FieldValue
Repositorywerf/kubedog
Ownerwerf
Primary languageGo
LicenseApache-2.0 — OSI-approved
Stars750
Forks50
Open issues36
Latest releasev0.13.0 (2025-01-22)
Last updated2026-06-16
Sourcehttps://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.

Quickstart

Get the kubedog source

Clone the repository and explore it locally.

terminalbash
git clone https://github.com/werf/kubedog.gitcd kubedog# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

CI/CD Pipeline Deployment Tracking

Monitor Kubernetes resource rollouts (Deployments, StatefulSets, DaemonSets, Jobs) in real-time during automated deployments, enabling fail-fast detection of stalled or failed updates.

werf Integration

Embed kubedog as a library within werf-based CI/CD pipelines to provide native deployment tracking without additional tooling or observability overhead.

Custom Deployment Orchestration

Build custom deployment validation and rollout verification tools by leveraging the Multitracker API to watch multiple resource types simultaneously.

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.

SignalAssessment
MaintenanceActive
DocumentationAdequate
License clarityClear
Deployment complexityLow
DEV.co fitGood
Assessment confidenceHigh
Security considerations

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.

Software development agency

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.co

Related 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?
Yes. Kubedog is a standalone library; you can integrate it into any Go-based CI/CD tool or orchestrator. The CLI is minimal; use the library API (Multitracker) for custom workflows.
Is the kubedog CLI production-ready?
No. The README explicitly states the CLI is minimal and intended for debug purposes. Use the library API for production deployments.
Does kubedog support monitoring multiple Kubernetes clusters?
Unknown. The provided data does not specify multi-cluster support. Review source code or contact maintainers for clarification.
What is the licensing cost?
Kubedog is open-source under Apache-2.0 (no cost). However, integration and operational support depend on your chosen CI/CD platform or vendor.

Custom software development services

DEV.co pairs senior engineers with teams adopting tools like kubedog. Our software development services span open-source devops architecture, implementation, and the AI development services that increasingly sit alongside them.

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.