DEV Community

Cover image for Kubernetes CRDs: The Backbone of Kubernetes Extensibility
Jorge Contreras
Jorge Contreras

Posted on

Kubernetes CRDs: The Backbone of Kubernetes Extensibility

Kubernetes is a highly extensible platform, and at the core of its extensibility lies the concept of Custom Resource Definitions (CRDs). CRDs empower developers to extend Kubernetes' capabilities by creating custom resource types that operate just like native Kubernetes objects. In this article, we’ll explore what CRDs are, why they’re important, and highlight some real-world examples of how they’re used.

What Are CRDs (Custom Resource Definitions)?

Kubernetes is already packed with built-in resources like Pod, Deployment, and Service. But what if you need to manage something Kubernetes doesn’t natively understand—like a database, an application workflow, or a set of cloud resources?

Enter CRDs!

A CRD lets you create and manage custom resource types, allowing Kubernetes to recognize and handle them just like its native objects. By registering a CRD in your cluster, you’re essentially saying:

“Hey Kubernetes, here’s a new resource type. Treat it like one of your own.”

For example, if you define a Database CRD, you can create resources like Postgres or MySQL directly in Kubernetes, complete with their own schemas and validation rules.

Why Should You Care About CRDs?

Alright, here’s the deal: CRDs make Kubernetes amazingly flexible.

With CRDs, you can:

Add New Features: Need Kubernetes to manage your app-specific workflows? No problem.

Stay Declarative: Manage everything using YAML—just like the built-in stuff.

Automate All the Things: Pair your CRD with a custom controller (or operator) to handle the heavy lifting for you.

Basically, CRDs let you turn Kubernetes into your personal Swiss Army knife for app and infrastructure management.

Let's see an example!

Here’s a quick example of a CRD that defines a custom resource type called Database.

apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  name: databases.awesomeproject.com
spec:
  group: awesomeproject.com
  names:
    kind: Database
    plural: databases
    singular: database
  scope: Namespaced
  versions:
    - name: v1
      served: true
      storage: true
      schema:
        openAPIV3Schema:
          type: object
          properties:
            spec:
              type: object
              properties:
                engine:
                  type: string
                version:
                  type: string
                storage:
                  type: integer

Enter fullscreen mode Exit fullscreen mode

After applying this CRD, Kubernetes knows how to handle a Database resource. You can now create custom databases using YAML—how cool is that?

Are they common?

You bet they are! CRDs are everywhere in the Kubernetes ecosystem. Here are some popular ones that you might bump into:

1. Cert-Manager

Automates the boring stuff around TLS certificates.

CRDs: Certificate, Issuer, ClusterIssuer
Example: Automatically get certificates from Let’s Encrypt.

2. ArgoCD

Powers your GitOps workflows (syncing Git to your cluster).

CRDs: Application, AppProject
Example: Define an application that ArgoCD will deploy from Git.

3. Prometheus Operator

Makes monitoring a breeze by automating Prometheus setup.

CRDs: ServiceMonitor, PodMonitor, Alertmanager
Example: Define which services Prometheus should monitor.

CRDs in Action: How They Work

When you combine CRDs with a custom controller or operator, things get really exciting. Imagine this:

You define a Database custom resource to manage your Postgres instance.
A controller watches for changes to Database resources.
The controller handles all the nitty-gritty details—provisioning storage, creating users, setting up backups, you name it!
This is how tools like ArgoCD and Cert-Manager work behind the scenes. CRDs let Kubernetes handle the what, while the controller handles the how.

Wrapping Up

CRDs are what make Kubernetes extensibility easy and fun. They let you manage almost anything: databases, certificates, cloud resources, with Kubernetes’ familiar declarative style. Whether you’re using popular tools like Istio and Prometheus Operator, or building your own custom workflows, CRDs are a must-know feature.

Top comments (0)