Kubernetes Spec Compare
Compare Kubernetes OpenAPI specifications side-by-side across different Kubernetes versions. See what changed between versions, including new fields, deprecated fields, and schema modifications. Also compare deprecation notices and changelog entries from GitHub. Perfect for understanding API changes when upgrading Kubernetes clusters or migrating configurations.
Compare Kubernetes Specs
v1.33.0 Documentation
v1.34.0 Documentation
When to use this tool
You are upgrading Kubernetes and need to check API changes.
You want to verify deprecated fields before rollout.
Examples
Deployment diff
Input
From: v1.28 To: v1.30 Resource: Deployment
Output
Highlighted changes for added/removed fields
Check deprecation notes before upgrading clusters.
Developer use cases
Compare Deployments between v1.28 and v1.30.
Review breaking changes in core resources.
Common mistakes to avoid
Assuming minor version upgrades are always backward compatible.
Comparing resources without checking deprecation notices.
Format and behavior notes
Data is fetched from official Kubernetes OpenAPI specs.
All comparisons are performed locally in the browser.
Related guides
Related Tools
Frequently Asked Questions
How do I compare Kubernetes API specifications?
Select two Kubernetes versions from the dropdown menus, choose a Kubernetes object type (like Pod, Deployment, Service, or ConfigMap), and the tool will automatically fetch and display the OpenAPI specifications side-by-side with differences highlighted in color. You can also expand sections to view deprecation notices and changelog entries from GitHub.
What Kubernetes versions are supported?
The tool supports all Kubernetes versions that have published OpenAPI specifications, typically from v1.15 onwards. Popular versions like v1.28, v1.29, v1.30, v1.31, v1.32, v1.33, and v1.34 are readily available. The tool fetches specs directly from the official Kubernetes GitHub repository.
What information is shown in the Kubernetes spec comparison?
The comparison displays the complete OpenAPI schema for the selected object type, including all properties, their data types, descriptions, and whether fields are required or optional. Differences between versions are highlighted with color coding: green for added fields, red for removed fields, and yellow for modified fields. Additionally, you can view deprecation notices and changelog entries from GitHub CHANGELOG files.
Can I compare custom resources (CRDs)?
Currently, the tool focuses on core Kubernetes API objects like Pods, Deployments, Services, ConfigMaps, Secrets, and other standard Kubernetes resources. Custom Resource Definitions (CRDs) are not included as they vary by cluster configuration and are not part of the core Kubernetes API specification.
How is the Kubernetes spec data fetched?
The tool fetches OpenAPI specifications and CHANGELOG files directly from the official Kubernetes GitHub repository (raw.githubusercontent.com). All processing happens in your browser for privacy and security. No authentication or API keys are required. The tool uses CORS-allowed sources to ensure reliable access.
Is my data secure when using this tool?
Yes, your data is completely secure. All processing happens locally in your browser. The tool only fetches public OpenAPI specifications from GitHub - no data is sent to any server, and no authentication is required. Your Kubernetes configurations and cluster information never leave your device.
What can I use this tool for?
This tool is perfect for understanding API changes when upgrading Kubernetes clusters, planning migrations between versions, identifying deprecated fields, reviewing breaking changes, and learning about new features in different Kubernetes versions. It helps developers and DevOps engineers prepare for version upgrades.