kube-rs/kube

kube-rs is a Rust library for interacting with Kubernetes. Kubernetes is a system for running and managing containerized applications across a cluster of machines. This library gives Rust programs a way to talk to a Kubernetes cluster: listing pods and other resources, modifying them, watching for changes, and building automated controllers that respond when things change. The library has three main layers. The first is the API layer, which covers the basics: get, create, update, patch, and delete any Kubernetes resource. It is generic, meaning you use the same interface whether you are working with built-in resource types like pods and services, or with custom resource definitions you define yourself. A derive macro generates the Kubernetes-specific boilerplate for custom types automatically from a Rust struct, similar to how kubebuilder works in Go. The second layer is the runtime, which adds higher-level abstractions. A watcher gives you a continuous stream of change events from the cluster without you needing to manage connection restarts or pagination yourself. A reflector is a watcher that also maintains a local in-memory cache of current state, so you can query what resources exist at any point without making a fresh API request. The third layer is the controller runtime. It builds on watchers and reflectors to help you write Kubernetes operators: programs that monitor resources and take action when they change. You provide a reconcile function and an error policy, and the controller handles scheduling, retry logic, and watching both primary and related child resources. kube-rs is hosted by the Cloud Native Computing Foundation (CNCF) as a Sandbox project and supports Kubernetes v1.31 and above. Full documentation is available at kube.rs.