How yannicksiewe/k8s-iam-operator works
k8s-iam-operator reconciles Kubernetes User, Group, and Role custom resources into ServiceAccounts, namespaces, RBAC bindings, optional quotas and network policies, and kubeconfigs. The principal workflow runs from Kubernetes events through Kopf handlers and domain services to Kubernetes API repositories. Separate branches cover namespace-triggered reconciliation, health and metrics endpoints, audit logging, and tracing. The README documents the layer structure; source excerpts confirm selected service-to-repository calls. Several subsystems are represented from documented capabilities and the source index, not inspected implementation details.
Main entry points: user_service.py User lifecycle · container.py Dependency container · base.py Kubernetes client base · user_handlers.py User handler
Components 29
Operator events
- User handler
app/kopf_handlers/user_handlers.py - Group handler
app/kopf_handlers/group_handlers.py - Role handler
app/kopf_handlers/role_handlers.py - Namespace handler
app/kopf_handlers/namespace_handlers.py - Dependency container
app/container.py - Operator configuration
app/config.py - Error handling
app/exceptions.py
IAM domain
- User lifecycle
app/services/user_service.py - Group access
app/services/group_service.py - Role definitions
app/services/role_service.py - RBAC bindings
app/services/rbac_service.py - Kubeconfig generation
app/services/kubeconfig_service.py - User resource model
app/models/user.py - Group resource model
app/models/group.py - Role resource model
app/models/role.py - CRD validation
app/validators.py
Kubernetes access
- Namespace repository
app/repositories/namespace_repository.py - ServiceAccount repository
app/repositories/serviceaccount_repository.py - RBAC repository
app/repositories/rbac_repository.py - Quota repository
app/repositories/resource_quota_repository.py - Network policy repository
app/repositories/network_policy_repository.py - Kubernetes client base
app/repositories/base.py
Operations
- Audit logging
app/utils/audit.py - Prometheus metrics
app/api/metrics.py - Health endpoint
app/api/health.py - Tracing
app/utils/tracing.py
Other components
- Kubernetes events
- Kubernetes API
- Prometheus
Connections 37
- Kubernetes events → User handler: dispatches
README.md - Kubernetes events → Group handler: dispatches
README.md - Kubernetes events → Role handler: dispatches
README.md - Kubernetes events → Namespace handler: dispatches
app/kopf_handlers/namespace_handlers.py - User handler → User lifecycle: handles via
README.md - Group handler → Group access: handles via
README.md - Role handler → Role definitions: handles via
README.md - Namespace handler → RBAC bindings: reconciles through
app/kopf_handlers/namespace_handlers.py - User lifecycle → RBAC bindings: creates bindings
app/services/user_service.py - User lifecycle → Kubeconfig generation: generates config
app/services/user_service.py - Group access → RBAC bindings: uses
app/services/group_service.py - Role definitions → RBAC repository: manages roles
app/services/role_service.py - RBAC bindings → RBAC repository: creates bindings
app/services/rbac_service.py - User lifecycle → ServiceAccount repository: creates accounts
app/services/user_service.py - User lifecycle → Namespace repository: provisions namespace
app/services/user_service.py - User lifecycle → Quota repository: sets quotas
app/services/user_service.py - User lifecycle → Network policy repository: sets policies
app/services/user_service.py - Kubernetes client base → Kubernetes API: configures client
app/repositories/base.py - RBAC repository → Kubernetes client base: inherits
app/repositories/rbac_repository.py - Namespace repository → Kubernetes client base: inherits
app/repositories/namespace_repository.py - Quota repository → Kubernetes client base: inherits
app/repositories/resource_quota_repository.py - Network policy repository → Kubernetes client base: inherits
app/repositories/network_policy_repository.py - ServiceAccount repository → Kubernetes client base: inherits
app/repositories/serviceaccount_repository.py - User handler → Dependency container: gets services
app/kopf_handlers/user_handlers.py - Group handler → Dependency container: gets services
app/kopf_handlers/group_handlers.py - Role handler → Dependency container: gets services
app/kopf_handlers/role_handlers.py - Namespace handler → Dependency container: gets services
app/kopf_handlers/namespace_handlers.py - Dependency container → Audit logging: wires logger
app/container.py - User lifecycle → CRD validation: validates input
app/services/user_service.py - User handler → User resource model: parses resource
app/kopf_handlers/user_handlers.py - Group handler → Group resource model: parses resource
app/kopf_handlers/group_handlers.py - Role handler → Role resource model: parses resource
- Prometheus metrics → Prometheus: exposes metrics
README.md - User lifecycle → Audit logging: records events
app/services/user_service.py - RBAC bindings → Audit logging: records changes
app/services/rbac_service.py - User handler → Tracing: instrumented by
- Dependency container → Operator configuration: configures services