kubernetes-sigs/controller-runtime
Controller Runtime
Este proyecto proporciona un framework para construir operadores de Kubernetes y controladores personalizados. Ofrece un conjunto de bibliotecas diseñadas para gestionar el ciclo de vida de los recursos del cluster, permitiendo a los desarrolladores sincronizar el estado real de un cluster con una configuración deseada a través de bucles de reconciliación basados en eventos.
El framework se distingue por proporcionar un entorno orquestado por gestor que coordina múltiples controladores y webhooks dentro de un solo proceso. Incluye soporte incorporado para el control de concurrencia optimista para evitar conflictos de actualización y utiliza el almacenamiento en caché de informadores en memoria para mantener una vista local sincronizada del estado del cluster, lo que reduce la carga en el servidor API.
Más allá de la reconciliación central, el proyecto incluye herramientas para el mapeo de recursos basado en esquemas, permitiendo el registro de definiciones de recursos personalizados. También proporciona mecanismos para el control de admisión, permitiendo la validación y mutación de solicitudes de recursos para aplicar el cumplimiento antes de que los datos se persistan. El framework incluye una suite de pruebas dedicada que pone en marcha entornos de servidor API efímeros y aislados para validar la lógica del controlador contra el comportamiento real del cluster.
Features
- Kubernetes Controllers - Implements a framework for building custom controllers that synchronize cluster state through declarative reconciliation loops.
- Kubernetes Operators - Provides a framework for building custom controllers that watch cluster resources and execute logic to maintain a desired state.
- Reconciliation Loops - Implements continuous control loops that converge cluster resources from their current state toward a desired target state.
- Local Control Plane Testing - Spins up a local API server environment to validate controller logic against real cluster behavior during testing.
- Cluster State Reconciliation - Synchronizes the state of cluster resources by watching for changes and executing custom logic to ensure the actual state matches the desired configuration.
- Admission Controllers - The framework modifies incoming resource requests automatically by injecting or updating fields to ensure compliance with cluster-wide policies or defaults.
- Admission Controllers - Intercepts resource creation or update requests to enforce custom business rules or inject default values before changes are persisted.
- In-Memory Caches - Maintains a synchronized local copy of cluster state in memory to reduce API server load and accelerate reconciliation.
- Optimistic Concurrency Control - Uses resource versioning and conditional updates to prevent conflicts when multiple processes modify the same cluster object.
- Admission Webhooks - Intercepts resource creation and update requests to validate or mutate data before persistence to cluster storage.
- Custom Resource Definitions - Maps data structures to specific API group-version-kinds to allow the system to recognize and manage custom resource definitions.
- Kubernetes API Clients - Provides a comprehensive library for interacting with the Kubernetes API, managing resource schemas, and handling custom business logic.
- Eventual Consistency Orchestrators - Handles potential cache staleness through optimistic locking, deterministic naming, or periodic requeueing to ensure eventual consistency.
- Resource Mapping - Associates Go data structures with specific API group-version-kinds to enable automated serialization and management of custom resources.
- Controller Lifecycle Management - Orchestrates the startup, shared caching, and graceful shutdown of multiple controllers and webhooks within a single process.
- State Reconciliation - Maps multiple related objects to a single root object and enforces the desired state for that entire resource tree during each execution cycle.
- API Testing Frameworks - Provides a testing suite that spins up a local API server to validate controller logic against real cluster behavior.
- Kubernetes - Provides a dedicated testing suite that spins up ephemeral, isolated API server environments to validate controller logic against real cluster behavior.
