Creating Kubernetes Custom Resource Definitions using the Kubernetes Python SDK

Creating Kubernetes Custom Resource Definitions using the Kubernetes Python SDK

Kubernetes is a widely-used container orchestration platform that automates containerized applications’ deployment, scaling, and management. To interact with Kubernetes clusters programmatically, developers can use the Kubernetes Python client library, which provides a dynamic client for working with custom resources and the Kubernetes API.

This tutorial demonstrates the use of Kubernetes dynamic client library in Python to interact with Kubernetes clusters, covering topics such as authentication, listing resources, creating and deleting custom resources, and more.


Before starting, make sure you have the following installed:

  1. Python 3.6 or higher
  2. The Kubernetes Python client library: pip install kubernetes

Table of Contents

Setting up the Kubernetes Dynamic Client

First, import the necessary modules and create an API client:

from kubernetes import config, client
from kubernetes.dynamic import DynamicClient

# Load the kubeconfig file from the default location (~/.kube/config)

# Create a dynamic client
dyn_client = DynamicClient(client.ApiClient())

Listing Resources using the Dynamic Client

To list resources, you must create a Resource instance for the desired resource type. In this example, we will list all Pods in the default namespace:

from kubernetes.client import V1PodList

# Define the API resource for Pods
pod_resource = dyn_client.resources.get(api_version='v1', kind='Pod')

# List Pods in the "default" namespace
pods: V1PodList = pod_resource.get(namespace='default')

for pod in pods.items:
    print(f"Name: {pod.metadata.name}, Namespace: {pod.metadata.namespace}")

Creating Custom Resource Definitions and Resources

To create custom resources, you must define the Custom Resource Definition (CRD) and create an instance of the custom resource. In this example, we will create a custom resource for a sample CRD:

# Define the custom resource definition
crd = {
    'apiVersion': 'apiextensions.k8s.io/v1',
    'kind': 'CustomResourceDefinition',
    'metadata': {
        'name': 'apps.faizanbashir.me'  # Adjusted according to rule 1
    'spec': {
        'group': 'faizanbashir.me',
        'versions': [  # Added this to satisfy rule 2
                'name': 'v1alpha1',
                'served': True,
                'storage': True,
                'schema': {
                    'openAPIV3Schema': {
                        'type': 'object',
                        'properties': {
                            'spec': {
                                'type': 'object',
                                'properties': {
                                    'message': {
                                        'type': 'string'
        'names': {
            'kind': 'App',
            'plural': 'apps',  # Adjusted according to rule 3
            'singular': 'app',
            'shortNames': [
        'scope': 'Namespaced'
    'status': {  # Added this to satisfy rule 4
        'storedVersions': ['v1alpha1']

# Create the CRD using the dynamic client
crd_resource = dyn_client.resources.get(api_version='apiextensions.k8s.io/v1' kind='CustomResourceDefinition')
created_crd = crd_resource.create(body=crd)
print(f"Created CRD {created_crd.metadata.name}")

# Define the custom resource
crd_spec = {
    'apiVersion': 'faizanbashir.me/v1alpha1',
    'kind': 'App',
    'metadata': {
        'name': 'my-crd',
        'namespace': 'default'
    'spec': {
        'message': 'Hello, Kubernetes!'

# Create the custom resource using the dynamic client
my_resource = dyn_client.resources.get(api_version='faizanbashir.me/v1alpha1', kind='App')
created_resource = my_resource.create(body=crd_spec, namespace='default')
print(f"Created resource mycrd")

Deleting Custom Resources

To delete a custom resource, use the delete method on the Resource instance:

# Delete the custom resource
my_resource = dyn_client.resources.get(api_version='faizanbashir.me/v1alpha1', kind='App')
my_resource.delete(name='my-crd', namespace='default')
print(f"Deleted resource my-crd")

Deleting Custom Resource Definitions

To delete a custom resource, use the delete method on the CRD instance:

# Delete the custom Definition
crd_client = dyn_client.resources.get(api_version="apiextensions.k8s.io/v1", kind="CustomResourceDefinition")
deleted_crd = crd_client.delete(name="apps.faizanbashir.me")
print(f"Deleted CRD apps.faizanbashir.me")


The Kubernetes dynamic client library for Python provides a powerful and flexible way to interact with Kubernetes clusters, making it easy to manage resources and perform various operations on them. This tutorial demonstrated how to set up the dynamic client, list resources, create and delete custom resources, and more.

You can automate tasks and build powerful tools to manage your Kubernetes clusters by leveraging the Kubernetes dynamic client library in your Python projects. As you become more familiar with the library, you can explore other operations and resources, adapting the examples provided here to suit your needs.


Faizan Bashir

Principal Engineer | Architecting and building distributed applications in the Cloud | Adventurer

Read More