kubernetes-sigs/controller-runtime
Controller Runtime
Ce projet fournit un framework pour construire des opérateurs Kubernetes et des contrôleurs personnalisés. Il offre un ensemble de bibliothèques conçues pour gérer le cycle de vie des ressources de cluster, permettant aux développeurs de synchroniser l'état réel d'un cluster avec une configuration souhaitée via des boucles de réconciliation pilotées par les événements.
Le framework se distingue en fournissant un environnement orchestré par gestionnaire qui coordonne plusieurs contrôleurs et webhooks au sein d'un seul processus. Il inclut un support intégré pour le contrôle de concurrence optimiste afin d'éviter les conflits de mise à jour et utilise la mise en cache en mémoire des informateurs pour maintenir une vue locale synchronisée de l'état du cluster, ce qui réduit la charge sur le serveur API.
Au-delà de la réconciliation de base, le projet inclut des outils pour le mappage de ressources basé sur schéma, permettant l'enregistrement de définitions de ressources personnalisées. Il fournit également des mécanismes pour le contrôle d'admission, permettant la validation et la mutation des requêtes de ressources pour appliquer la conformité avant que les données ne soient persistées. Le framework inclut une suite de test dédiée qui lance des environnements de serveur API éphémères et isolés pour valider la logique du contrôleur par rapport au comportement réel du 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.
