feat: 接入 Database 三资源 API 与分层绑定协调

确定单库单账号、集群级 Database、资源侧先写绑定和凭据定位合同。领域层承载纯规则，service 协調流程，Kubernetes adapter 负责资源呈现与版本保护。验证：全量 make test、三轮 race、真实 API server 并发与重启补写、最小 RBAC/watch、lint 和文档检查通过。供应、凭据交付及删除清理尚未实现，保留 DeletionPending/finalizer 边界。
2026-09-25 04:09:43 +00:00
parent 347a667c0c
commit 7e9e8e828b
33 changed files with 3516 additions and 45 deletions
@@ -0,0 +1,75 @@
+package controller
+
+import (
+	"context"
+
+	databasev1alpha1 "git.ddupan.top/panxiao81/ayatori/api/database/v1alpha1"
+	"git.ddupan.top/panxiao81/ayatori/internal/database/adapter/kubernetes"
+	"k8s.io/apimachinery/pkg/types"
+	ctrl "sigs.k8s.io/controller-runtime"
+	"sigs.k8s.io/controller-runtime/pkg/client"
+	"sigs.k8s.io/controller-runtime/pkg/handler"
+)
+
+const targetDatabaseIndex = "database.bindingTarget"
+
+func (r *BindingReconciler) SetupWithManager(ctx context.Context, manager ctrl.Manager) error {
+	if r.Client == nil {
+		r.Client = manager.GetClient()
+	}
+	if r.Reader == nil {
+		r.Reader = manager.GetAPIReader()
+	}
+	if err := manager.GetFieldIndexer().IndexField(ctx, &databasev1alpha1.PostgreSQLTenant{},
+		targetDatabaseIndex, func(object client.Object) []string {
+			tenant := object.(*databasev1alpha1.PostgreSQLTenant)
+			return []string{kubernetes.BindingTargetName(tenant)}
+		}); err != nil {
+		return err
+	}
+	return ctrl.NewControllerManagedBy(manager).
+		Named("database-binding").
+		For(&databasev1alpha1.PostgreSQLTenant{}).
+		Watches(&databasev1alpha1.PostgreSQLDatabase{}, handler.EnqueueRequestsFromMapFunc(r.requestsForDatabase)).
+		Watches(&databasev1alpha1.PostgreSQLInstance{}, handler.EnqueueRequestsFromMapFunc(r.requestsForInstance)).
+		Complete(r)
+}
+
+func (r *BindingReconciler) requestsForDatabase(ctx context.Context, object client.Object) []ctrl.Request {
+	tenants := &databasev1alpha1.PostgreSQLTenantList{}
+	if err := r.Client.List(ctx, tenants, client.MatchingFields{targetDatabaseIndex: object.GetName()}); err != nil {
+		ctrl.LoggerFrom(ctx).Error(err, "无法映射 Database 事件；等待低频重试")
+		return nil
+	}
+	requests := make([]ctrl.Request, 0, len(tenants.Items))
+	for _, tenant := range tenants.Items {
+		requests = append(requests, ctrl.Request{NamespacedName: client.ObjectKeyFromObject(&tenant)})
+	}
+	return requests
+}
+
+func (r *BindingReconciler) requestsForInstance(ctx context.Context, object client.Object) []ctrl.Request {
+	// 当前只有 homelab 内部申请，使用 cache 列表过滤，不维护另一份实例/租户集合。
+	tenants := &databasev1alpha1.PostgreSQLTenantList{}
+	if err := r.Client.List(ctx, tenants); err != nil {
+		ctrl.LoggerFrom(ctx).Error(err, "无法映射 Instance 事件；等待低频重试")
+		return nil
+	}
+	requests := make([]ctrl.Request, 0, len(tenants.Items))
+	for _, tenant := range tenants.Items {
+		instanceName := ""
+		if tenant.Spec.Provision != nil {
+			instanceName = string(tenant.Spec.Provision.InstanceRef.Name)
+		} else if tenant.Spec.DatabaseRef != nil {
+			database := &databasev1alpha1.PostgreSQLDatabase{}
+			if err := r.Client.Get(ctx, types.NamespacedName{Name: string(tenant.Spec.DatabaseRef.Name)}, database); err != nil {
+				continue
+			}
+			instanceName = string(database.Spec.InstanceRef.Name)
+		}
+		if instanceName == object.GetName() {
+			requests = append(requests, ctrl.Request{NamespacedName: client.ObjectKeyFromObject(&tenant)})
+		}
+	}
+	return requests
+}