---
id: pulumi-kubernetes
version: "4.33.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pulumi-kubernetes — A Pulumi package for creating and managing Kubernetes resources.

License: permissive · Maintenance: active · Downloads: 1.4M/mo

## What it is and what it does

Pulumi Kubernetes is a resource provider that bridges Pulumi's infrastructure-as-code framework with Kubernetes, letting you define cluster workloads and resources in Python instead of YAML. It wraps the Kubernetes OpenAPI specification automatically, so the SDK stays synchronized with upstream Kubernetes releases and exposes the full API surface—Deployments, Services, ConfigMaps, Secrets, Jobs, and all other resource types—in a programmatic, type-aware interface.

You use it to deploy manifests from files, install Helm charts, or construct individual Kubernetes resources using the SDK's resource classes. It respects your local kubeconfig, so it works with any running cluster (EKS, AKS, GKE, or self-managed). The package depends on pulumi as its core orchestration engine, plus parver, semver, requests, and typing-extensions for version handling and HTTP operations.

Use it for:

- Deploy YAML manifests from files into a running cluster without writing kubectl commands.
- Install and configure Helm charts programmatically with custom values and cluster-specific providers.
- Define Kubernetes Deployments, Services, and ConfigMaps as Python objects with full IDE autocomplete and type checking.
- Manage multi-cluster or multi-environment Kubernetes resources using Pulumi's stack and configuration system.
- Combine Kubernetes resource definitions with other cloud infrastructure (e.g., EKS cluster creation) in a single Pulumi program.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Pulumi Kubernetes Resource Provider lets you define, deploy, and manage Kubernetes API resources and workloads programmatically using Python, with full API coverage including Deployments, Services, ConfigMaps, and other Kubernetes primitives.

Yes. This package is actively maintained, has no known vulnerabilities, installs cleanly with low friction, and is the standard way to manage Kubernetes resources from Pulumi. Install it if you are already using Pulumi and need to deploy or manage Kubernetes workloads programmatically; it is not a standalone Kubernetes tool and requires Pulumi CLI and a running cluster.

## Install

pip install pulumi-kubernetes
uv add pulumi-kubernetes
poetry add pulumi-kubernetes

## Installing pulumi-kubernetes

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release (38 days ago) and an active repository. Five runtime dependencies are all well-established packages.

License in practice: Apache-2.0 permissive license allows use in commercial and proprietary projects with minimal restrictions; you must retain license notices and provide a copy of the license.

Quickstart:

pip install pulumi-kubernetes

import pulumi_kubernetes as k8s

deployment = k8s.apps.v1.Deployment(
    "my-app",
    spec={
        "replicas": 2,
        "selector": {"matchLabels": {"app": "nginx"}},
        "template": {
            "metadata": {"labels": {"app": "nginx"}},
            "spec": {"containers": [{"name": "nginx", "image": "nginx"}]}
        }
    }
)

Requires a running Kubernetes cluster accessible via kubeconfig, and Pulumi CLI installed and configured.

Verify before relying:

- Whether the package works with Kubernetes versions older than 1.13.0 despite the stated support floor.
- Performance characteristics when managing large numbers of resources or complex API objects.
- Whether alpha and beta Kubernetes APIs are fully stable or carry additional risk in production.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

kubernetes infrastructure as code, pulumi kubernetes provider, deploy kubernetes resources python, kubernetes resource management, infrastructure automation kubernetes, kubernetes declarative deployment, pulumi k8s sdk, infrastructure-as-code, kubernetes, pulumi

[View on SkillFed](https://skillfed.io/packages/pulumi-kubernetes) · [View on PyPI](https://pypi.org/project/pulumi-kubernetes/)