kubepug.xyz

What It Is

Kubepug is a PreUpgrade API Deprecation checker for Kubernetes upgrade scenarios. Kubernetes gradually deprecates and eventually removes certain APIs across versions. If cluster administrators still have resources using old APIs during an upgrade, they may run into failures or compatibility issues. Kubepug’s core value is that it scans a running cluster or manifests in advance, identifies deprecated or removed APIs, and provides the relevant version information.

Core Features and Technical Approach

In terms of functionality, Kubepug can check both running Kubernetes clusters and manifest files. Users can specify a target Kubernetes version, since whether an API is deprecated or removed depends on the version being upgraded to. It reports Deprecated APIs and Deleted APIs, and provides information such as replacement APIs, Deprecated at, and Deleted at. Output is available as colored or plain text, JSON, and YAML, which is useful for CI/CD pipelines or automated audits.

Its approach is based on generating a JSON database of deprecated/deleted APIs from Kubernetes API definitions. The documentation states that this store is generated roughly every 30 minutes and downloaded for use at runtime. For air-gapped environments, users can also clone the repository, generate data.json locally via a container, and specify the local file with --database.

Pricing, Open Source, and Ecosystem

The available content shows that the project provides a GitHub repository and can build the generator container locally, so it is positioned as an open-source tool. However, the crawled content does not provide license details, commercial support, or pricing plans. In terms of ecosystem fit, it is built directly around Kubernetes APIs, manifests, and client-go use cases, with JSON/YAML output, making it suitable for integration into pre-upgrade checks, GitOps workflows, or pre-release validation.

Pros, Cons, and Best-Fit Users

Its strengths are its focused use case and direct information: it not only identifies risky APIs, but also indicates the removal version and replacement API. It also supports an offline database, which is useful for enterprise internal-network clusters. The downsides are that the available content does not show full installation steps, permission requirements, or how it handles complex scenarios. It also does not describe enterprise support, reporting, a Web UI, or team collaboration features. Kubepug is best suited for SREs, DevOps engineers, platform engineers, and Kubernetes administrators who need quick risk checks before upgrades.

Access from China and Alternatives

The crawled text does not provide information about access from mainland China, mirror sources, or download availability. GitHub access and database downloads may be affected by network quality in China, so its China accessibility is rated as unknown. If access or maintenance becomes an issue, alternatives to consider include pluto and kubent, or building an internal checking workflow based on the official Kubernetes API change documentation.