Kubernetes backend for Pants

This release targets Pants 2.31.0. Install it with pants-backend-k8s==0.7.0 in [GLOBAL].plugins in pants.toml.

Warning This plugin is in development. No stability is guaranteed! Contributions welcome.

This backends implements targets for working with Kubernetes clusters using raw YAML.

• kubectl for cluster operations

Tool versions

The default is kubectl v1.37.1, with v1.36.5, v1.35.9, and v1.34.12 also recorded for Linux/macOS on x86-64 and ARM64. Select a version with --kubectl-tool-version=v1.35.9 or [kubectl-tool].version in pants.toml. Follow the Kubernetes release/EOL dates when choosing a minor; kubectl must be within one minor of the API server. The 1.34 entries are due for removal after their 2026-10-27 EOL.

Targets

There's currently three targets for pants-backend-k8s:

• k8s_source
• k8s_object
• k8s_objects

k8s_source

A file that can be passed into other k8s fields that are not source fields. For example, k8s_object.template.

k8s_source(
    name="namespace.yaml",
    source="namespace.yaml",
)

This'll eventually be automated like other rules once a suitable heuristic for generation with tailor is found. PRs welcome!

k8s_object

Input for a kubernetes command, either generated via kustomize or via k8s_source.

k8s_object(
    name="k8s",
    description="the chat backend"
    template=[":kustomize"],
    namespace="chat-app",
    cluster="prod",
)

k8s_object is a generator for kubernetes target parametrized by the potential commands that are available: apply, create, get, describe, replace, and delete.

k8s_objects

A collection of kubernetes objects that should be managed together.

k8s_objects(
    name="my-service",
    description="all components of service-x"
    objects=[":namespace", ":deployment"],
)

Like k8s_object, k8s_objects is a generator for parametrized targets for the commands that are available: apply, create, get, describe, replace, and delete.