kubernetes-sigs/controller-runtime
Controller Runtime
Dieses Projekt bietet ein Framework für den Aufbau von Kubernetes-Operatoren und benutzerdefinierten Controllern. Es bietet eine Reihe von Bibliotheken, die darauf ausgelegt sind, den Lebenszyklus von Cluster-Ressourcen zu verwalten, und ermöglicht es Entwicklern, den tatsächlichen Status eines Clusters mit einer gewünschten Konfiguration durch ereignisgesteuerte Abgleichsschleifen (Reconciliation Loops) zu synchronisieren.
Das Framework zeichnet sich dadurch aus, dass es eine manager-orchestrierte Umgebung bereitstellt, die mehrere Controller und Webhooks innerhalb eines einzigen Prozesses koordiniert. Es enthält integrierte Unterstützung für optimistische Nebenläufigkeitskontrolle, um Update-Konflikte zu verhindern, und nutzt In-Memory-Informer-Caching, um eine synchronisierte lokale Sicht auf den Cluster-Status zu wahren, was die Last auf dem API-Server reduziert.
Über den Kern-Abgleich hinaus enthält das Projekt Tools für schema-basiertes Ressourcen-Mapping, was die Registrierung benutzerdefinierter Ressourcendefinitionen ermöglicht. Es bietet zudem Mechanismen für Admission-Control, was die Validierung und Mutation von Ressourcenanfragen ermöglicht, um Compliance durchzusetzen, bevor Daten persistiert werden. Das Framework enthält eine dedizierte Testsuite, die ephemere, isolierte API-Server-Umgebungen hochfährt, um Controller-Logik gegen reales Cluster-Verhalten zu validieren.
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.
