kubernetes-client/java
Java
This is a Java client library for interacting with the Kubernetes API server. It provides a programmatic interface and a set of typed models to manage cluster resources, orchestrate state reconciliation, and administer pods and namespaces within a Kubernetes environment.
The library enables the development of custom controllers by providing frameworks for implementing automated control loops that reconcile the actual state of resources with a desired target state. It supports the generation of strongly-typed Java classes from OpenAPI specifications and custom resource definitions to ensure type safety for resource requests.
The project covers cluster management capabilities including resource listing, patching, and deletion, as well as container-level operations such as command execution, file transfers, port forwarding, and log retrieval. It includes synchronization primitives for real-time event streaming, shared informer caching, and leader election coordination.
Client access is established through service accounts or external configuration files.
Features
- Kubernetes API Providers - Provides a set of typed models and methods for sending REST and WebSocket requests to the Kubernetes API.
- Kubernetes Cluster Management - Provides a comprehensive Java library for programmatically managing and operating Kubernetes clusters.
- OpenAPI Model Generators - Generates strongly-typed Java classes from the server API specification to ensure type safety.
- Control Loops - Provides a framework for implementing reconciliation loops that align actual resource state with a desired target state.
- Model Generators - Provides mechanisms to generate strongly-typed Java classes from custom resource definitions.
- Resource Lifecycle Automation - Implements automated creation, deletion, and patching of cluster objects using strongly typed Java models.
- Kubernetes API Clients - Provides a Java-based client library for interacting with the Kubernetes control plane.
- Kubernetes Controllers - Provides frameworks for implementing automated control loops and declarative reconciliation for Kubernetes operators.
- State Reconciliation Orchestrators - Enables the implementation of control loops that reconcile the desired state of Kubernetes objects programmatically.
- Remote Cluster Access - Provides programmatic access to control and operate remote cluster environments via a centralized API.
- Cluster Object Watches - Maintains persistent connections to receive real-time notifications about resource changes via API watches.
- Informer Caches - Synchronizes a local memory cache with the server by combining initial list requests with continuous event updates.
- YAML and Protobuf Serialization - Translates resource objects between Java representations and standard YAML or Protobuf wire formats.
- Container Command Executors - Enables the execution of arbitrary commands and interactive shells inside running containers.
- Client Connection Configurations - Enables establishing secure cluster connections using service accounts or external configuration files.
- Resource Listing and Filtering - Provides capabilities for querying and retrieving lists of resource objects across namespaces.
- Cluster Resource Deletions - Provides the capability to remove various objects from a cluster using high-level API calls.
- Distributed Leader Election - Includes coordination mechanisms to ensure only one instance performs specific control operations.
- Container Interaction - Enables executing commands, transferring files, and forwarding ports to interact with containers within a cluster.
- Local Resource Caches - Maintains in-memory mirrors of server-side resources by combining initial listings with continuous watch events.
- Resource Patches - Allows updating specific fields of a resource using partial patch formats without replacing the entire object.
- Kubernetes Pod Port Forwarding - Maps local TCP ports to pod containers by establishing a tunnel through the Kubernetes API server proxy.
- Resource Serialization Systems - Provides a system for loading or dumping resource definitions using YAML or Protobuf protocols.
- Container File Transfers - Provides utilities for copying files and directories between a local filesystem and a running container.
- Container Log Retrieval - Allows fetching stdout and stderr output streams from running containers for debugging and monitoring.
- Real-Time Event Watchers - Implements mechanisms for subscribing to real-time resource change events to maintain synchronized local caches.
- Resource Change Monitors - Supports watching resource event streams to trigger automated operations based on cluster changes.
