Pre-release

This release is a pre-release and may not be stable for production use.

Pulumi Kubernetes Resource Provider

The Kubernetes resource provider for Pulumi lets you create, deploy, and manage Kubernetes API resources and workloads in a running cluster. For a streamlined Pulumi walkthrough, including language runtime installation and Kubernetes configuration, select "Get Started" below.

Introduction
- Kubernetes API Version Support
- How does API support for Kubernetes work?
References
Prerequisites
Installing
Quick Examples
Contributing
Code of Conduct

Introduction

pulumi-kubernetes provides an SDK to create any of the API resources available in Kubernetes.

This includes the resources you know and love, such as:

Deployments
ReplicaSets
ConfigMaps
Secrets
Jobs etc.

Kubernetes API Version Support

The pulumi-kubernetes SDK closely tracks the latest upstream release, and provides access to the full API surface, including deprecated endpoints. The SDK API is 100% compatible with the Kubernetes API, and is schematically identical to what Kubernetes users expect.

We support Kubernetes clusters with version >=1.13.0.

How does API support for Kubernetes work?

Pulumi’s Kubernetes SDK is manufactured by automatically wrapping our library functionality around the Kubernetes resource OpenAPI spec as soon as a new version is released! Ultimately, this means that Pulumi users do not have to learn a new Kubernetes API model, nor wait long to work with the latest available versions.

Note: Pulumi also supports alpha and beta APIs.

Visit the FAQ for more details.

References

Reference Documentation
API Documentation
- Node.js API
- Python API
All Examples
How-to Guides

Prerequisites

Install Pulumi.
Install a language runtime such as Node.js, Python or .NET.
Install a package manager
- For Node.js, use NPM or Yarn.
- For Python, use pip.
- For .NET, use Nuget which is integrated with the dotnet CLI.
Have access to a running Kubernetes cluster
- If kubectl already works for your running cluster, Pulumi respects and uses this configuration.
- If you do not have a cluster already running and available, we encourage you to explore Pulumi's SDKs for AWS EKS, Azure AKS, and GCP GKE. Visit the API reference docs in the Pulumi Registry for more details.
Install kubectl.

Installing

This package is available in many languages in the standard packaging formats.

For Node.js use either npm or yarn:

npm:

npm install @pulumi/kubernetes

yarn:

yarn add @pulumi/kubernetes

For Python use pip:

pip install pulumi-kubernetes

For .NET, dependencies will be automatically installed as part of your Pulumi deployments using dotnet build.

To use from Go, use go install to grab the latest version of the library

$ go install github.com/pulumi/pulumi-kubernetes/sdk/v4/go/kubernetes@latest

Quick Examples

The following examples demonstrate how to work with pulumi-kubernetes in a couple of ways.

Examples may include the creation of an AWS EKS cluster, although an EKS cluster is not required to use pulumi/kubernetes. It is simply used to ensure we have access to a running Kubernetes cluster to deploy resources and workloads into.

Deploying a YAML Manifest

This example deploys resources from a YAML manifest file path, using the transient, default kubeconfig credentials on the local machine, just as kubectl does.

import * as k8s from "@pulumi/kubernetes";

const myApp = new k8s.yaml.ConfigFile("app", {
    file: "app.yaml"
});

Deploying a Helm Chart

This example creates an EKS cluster with pulumi/eks, and then deploys a WordPress Helm chart from Bitnami's OCI registry using the kubeconfig credentials from the cluster's Pulumi provider.

import * as eks from "@pulumi/eks";
import * as k8s from "@pulumi/kubernetes";

// Create an EKS cluster.
const cluster = new eks.Cluster("my-cluster");

// Deploy Wordpress into our cluster.
const wordpress = new k8s.helm.v3.Chart("wordpress", {
    chart: "oci://registry-1.docker.io/bitnamicharts/wordpress",
    values: {
        wordpressBlogName: "My Cool Kubernetes Blog!",
    },
}, { providers: { "kubernetes": cluster.provider } });

// Export the cluster's kubeconfig.
export const kubeconfig = cluster.kubeconfig;

Deploying a Workload using the Resource API

This example creates a EKS cluster with pulumi/eks, and then deploys an NGINX Deployment and Service using the SDK resource API, and the kubeconfig credentials from the cluster's Pulumi provider.

import * as eks from "@pulumi/eks";
import * as k8s from "@pulumi/kubernetes";

// Create an EKS cluster with the default configuration.
const cluster = new eks.Cluster("my-cluster");

// Create a NGINX Deployment and Service.
const appName = "my-app";
const appLabels = { appClass: appName };
const deployment = new k8s.apps.v1.Deployment(`${appName}-dep`, {
    metadata: { labels: appLabels },
    spec: {
        replicas: 2,
        selector: { matchLabels: appLabels },
        template: {
            metadata: { labels: appLabels },
            spec: {
                containers: [{
                    name: appName,
                    image: "nginx",
                    ports: [{ name: "http", containerPort: 80 }]
                }],
            }
        }
    },
}, { provider: cluster.provider });

const service = new k8s.core.v1.Service(`${appName}-svc`, {
    metadata: { labels: appLabels },
    spec: {
        type: "LoadBalancer",
        ports: [{ port: 80, targetPort: "http" }],
        selector: appLabels,
    },
}, { provider: cluster.provider });

// Export the URL for the load balanced service.
export const url = service.status.loadBalancer.ingress[0].hostname;

// Export the cluster's kubeconfig.
export const kubeconfig = cluster.kubeconfig;

Contributing

If you are interested in contributing, please see the contributing docs.

Code of Conduct

You can read the code of conduct here.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pulumi_kubernetes-4.34.0a1787358163.tar.gz (2.0 MB view details)

Uploaded Aug 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pulumi_kubernetes-4.34.0a1787358163-py3-none-any.whl (3.1 MB view details)

Uploaded Aug 22, 2026 Python 3

File details

Details for the file pulumi_kubernetes-4.34.0a1787358163.tar.gz.

File metadata

Download URL: pulumi_kubernetes-4.34.0a1787358163.tar.gz
Upload date: Aug 22, 2026
Size: 2.0 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/5.0.0 CPython/3.11.15

File hashes

Hashes for pulumi_kubernetes-4.34.0a1787358163.tar.gz
Algorithm	Hash digest
SHA256	`bf1c717f3bd04d015d537abb347c7552c475a6c7b3962f7d72adb6ce261be651`
MD5	`059d44cc778211ce57762d7f0dc319a1`
BLAKE2b-256	`2c248621f9c0848ce4987f51599c258249a090a85b8c3cfa72d7e4dcb1674a5f`

See more details on using hashes here.

File details

Details for the file pulumi_kubernetes-4.34.0a1787358163-py3-none-any.whl.

File metadata

Download URL: pulumi_kubernetes-4.34.0a1787358163-py3-none-any.whl
Upload date: Aug 22, 2026
Size: 3.1 MB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/5.0.0 CPython/3.11.15

File hashes

Hashes for pulumi_kubernetes-4.34.0a1787358163-py3-none-any.whl
Algorithm	Hash digest
SHA256	`ae547876f99b12d36686e3c0a2a4fad16bd5a502ae168a19a05826feda9a45fa`
MD5	`683741fa965b64c71f1779db404f9443`
BLAKE2b-256	`7e6f0bb0374ab5c570216436689d69fe51c00eb4f51db049c97c1b535362b363`