kube-rs/kube
Kube
Kube-rs is a Rust client library and runtime for interacting with the Kubernetes API server. It provides a type-safe interface for managing cluster resources and state, including a toolkit for defining custom resource definitions and a framework for building admission webhooks to validate or mutate API requests.
The project distinguishes itself through a dedicated controller runtime that implements event-driven reconciliation loops to align actual cluster state with desired configurations. It utilizes a streaming system to monitor resource changes and synchronize remote states into a local queryable cache, supported by macro-based mapping to translate API resources into strongly typed structures.
The library also covers remote execution capabilities via bidirectional streams for pod attachment and port forwarding. It includes flexible security options with a pluggable TLS provider stack and supports routing API traffic through HTTP or SOCKS5 proxies.
Features
- Kubernetes API Clients - Offers a type-safe Rust client library for interacting with the Kubernetes API server.
- Kubernetes Controllers - Provides a dedicated runtime for building Kubernetes controllers with declarative reconciliation loops.
- Reconciliation Loops - Implements control loops that automatically align the actual cluster state with the desired configuration.
- Admission Webhooks - Includes a framework for implementing admission webhooks to validate or mutate API requests before cluster persistence.
- Cluster Resource CRUD Operations - Provides type-safe create, read, update, and delete operations for Kubernetes cluster resources.
- Custom Resource Definitions - Provides tools to generate boilerplate and schemas for managing custom resource definitions.
- Local Resource Caches - Maintains in-memory mirrors of server-side resources for high-performance local queries.
- Cluster State Caching - Synchronizes a local queryable cache with cluster state using an event-driven streaming system.
- Type-Safe API Clients - Implements a type-safe interface for sending requests to a Kubernetes cluster.
- Event-Driven State Mirrors - Implements a streaming system that monitors cluster events and synchronizes remote states into a local cache.
- Remote Command Execution - Enables bidirectional streams for executing commands in pods and forwarding network ports.
- Bidirectional Stream Proxying - Establishes long-lived socket connections to the API server for remote command execution and port forwarding.
- Resource Structure Mappings - Maps custom resources to strongly typed Rust structures using macros for safer data manipulation.
- Macro-Based Mappings - Uses Rust macros to map Kubernetes API resources into strongly typed structures.
- Continuous Resource Streamers - Offers continuous streaming of resource changes with automatic reconnection and relisting capabilities.
- Resource Change Monitors - Provides event-driven monitoring of Kubernetes resource changes to trigger reconciliation or automation.
- Resource Ownership Monitoring - Schedules parent resource reconciliation automatically when owned child resources are modified.
