As the Kubernetes ecosystem evolves so have the APIs provided which has lead to deprecations and removals. If you have moved to Kubernetes 1.22 or OpenShift 4.9 you might have already felt some of that pain.
For those of whom have not upgraded or are thinking of upgrading in the coming months, Pluto which is an open-source project, that is not sponsored by Red Hat nor is it supported under a Red Hat subscription, is here to help:
Pluto is a utility to help users find deprecated Kubernetes apiVersions in their code repositories and their helm releases.
In simple terms; it is a command-line tool that scans the Group Version Kind (GVK) of resources and validates against a version file, such as the below:
deprecated-versions:
- version: extensions/v1beta1
kind: Deployment
deprecated-in: v1.9.0
removed-in: v1.16.0
replacement-api: apps/v1
component: k8s
target-versions:
k8s: v1.22.0
OK, but why do I need pluto?
If you've been using k8s/OCP for a while, it should be easy to imagine the following:
You have multiple teams with multiple applications on the platform. Some of those applications use an auxiliary service, such as MongoDB, which is provided by another team or external partner via a helm chart. A spiders web of YAML dependencies has inadvertently been created. Do you know what
apiVersion
theDeployment
of MongoDB uses?
Of course not, your concern should be the business value created by your application. But that MongoDB service is within the remit of your team to run which means it is down to your team to fix and mitigate any issues.
This is where pluto
helps. Once it is integrated into your CI/CD pipeline, you can scan your resources against the latest k8s version via:
helm template {chart dir} | pluto detect -
Or, by specifying a target version for the component, if you want to pin against a specific version or look-ahead:
$ helm template charts/v1 | pluto detect --target-versions k8s=v1.20.0 -
Cool, so how do I check my OCP resources?
As Pluto uses a simple version.yaml
to determine what resource should be triggered against, it is possible to write a versions file, like the below, which would work for DeploymentConfigs
. The strength of Pluto is that it is not tied to any single stack or component, if your YAML file contains a GVK, you can use Pluto against it.
deprecated-versions:
- version: v1
kind: DeploymentConfig
deprecated-in: v3.11.0
removed-in: v4.9.0
replacement-api: apps.openshift.io/v1
component: ocp
target-versions:
ocp: v4.9.0
$ helm template charts/v1 | pluto detect --additional-versions ocp-versions.yaml -
So how do I include this in my workflow?
As it's a binary, you just need an extra stage/step that executes the binary. If you are using Jenkins
:
stage("Run pluto against chart") {
sh "helm template chart/ | pluto detect -"
}
If you are using GitHub workflows:
- name: Download Pluto
uses: FairwindsOps/pluto/github-action@master
- name: Run pluto against chart
run: |
helm template chart/ | pluto detect -
What is next?
The next step for me is to contribute a tekton
task when I have some downtime.
I am interested in exploring the possibility of programmatically creating a versions.yaml
file based on the APIServer output. If anyone has any suggestions, I am all ears.
About the author
Gareth Healy has extensive experience developing enterprise applications on both desktop and web systems, working in a variety of market sectors such as ecommerce, procurement, utilities, banking and finance. Healy is currently specialising in middleware integrations based on Red Hat Fuse running on a container platform based on Red Hat OpenShift Container Platform.
Browse by channel
Automation
The latest on IT automation that spans tech, teams, and environments
Artificial intelligence
Explore the platforms and partners building a faster path for AI
Open hybrid cloud
Explore how we build a more flexible future with hybrid cloud
Security
Explore how we reduce risks across environments and technologies
Edge computing
Updates on the solutions that simplify infrastructure at the edge
Infrastructure
Stay up to date on the world’s leading enterprise Linux platform
Applications
The latest on our solutions to the toughest application challenges
Original shows
Entertaining stories from the makers and leaders in enterprise tech
Products
- Red Hat Enterprise Linux
- Red Hat OpenShift
- Red Hat Ansible Automation Platform
- Cloud services
- See all products
Tools
- Training and certification
- My account
- Developer resources
- Customer support
- Red Hat value calculator
- Red Hat Ecosystem Catalog
- Find a partner
Try, buy, & sell
Communicate
About Red Hat
We’re the world’s leading provider of enterprise open source solutions—including Linux, cloud, container, and Kubernetes. We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.
Select a language
Red Hat legal and privacy links
- About Red Hat
- Jobs
- Events
- Locations
- Contact Red Hat
- Red Hat Blog
- Diversity, equity, and inclusion
- Cool Stuff Store
- Red Hat Summit