A cli tool to help discover deprecated apiVersions in Kubernetes
Find Kubernetes resources that have been deprecated
Pluto is a utility to help users find deprecated Kubernetes apiVersions in their code repositories and their helm releases.
Documentation
Check out the documentation at docs.fairwinds.com
Purpose
Kubernetes sometimes deprecates apiVersions. Most notably, a large number of deprecations happened in the 1.16 release. This is fine, and it's a fairly easy thing to deal with. However, it can be difficult to find all the places where you might have used a version that will be deprecated in your next upgrade.
You might think, "I'll just ask the api-server to tell me!", but this is fraught with danger. If you ask the api-server to give you deployments.v1.apps
, and the deployment was deployed as deployments.v1beta1.extensions
, the api-server will quite happily convert the api version and return a manifest with apps/v1
. This is fairly well outlined in the discussion in this issue.
So, long story short, finding the places where you have deployed a deprecated apiVersion can be challenging. This is where pluto
comes in. You can use pluto to check a couple different places where you might have placed a deprecated version:
Kubernetes Deprecation Policy
You can read the full policy here
Long story short, apiVersions get deprecated, and then they eventually get removed entirely. Pluto differentiates between these two, and will tell you if a version is DEPRECATED
or REMOVED
GitHub Action Usage
Want to use pluto within your GitHub workflows?
- name: Download Pluto uses: FairwindsOps/pluto/github-action@master
Join the Fairwinds Open Source Community
The goal of the Fairwinds Community is to exchange ideas, influence the open source roadmap, and network with fellow Kubernetes users. Chat with us on Slack or join the user group to get involved!
Other Projects from Fairwinds
Enjoying Pluto? Check out some of our other projects:
Fairwinds Insights
If you're interested in running Pluto in multiple clusters, tracking the results over time, integrating with Slack, Datadog, and Jira, or unlocking other functionality, check out Fairwinds Insights, a platform for auditing and enforcing policy in Kubernetes clusters.
Twice a month we will interview people behind open source businesses. We will talk about how they are building a business on top of open source projects.
We'll never share your email with anyone else.