feat: reconcile PostgreSQLInstance dependencies

internal/controller/postgresqlinstance_controller.go

@@ -18,7 +18,9 @@ package controller
 
 import (
 	"context"
+	"errors"
 	"reflect"
+	"time"
 
 	apierrors "k8s.io/apimachinery/pkg/api/errors"
 	"k8s.io/apimachinery/pkg/runtime"
@@ -32,7 +34,15 @@ import (
 // PostgreSQLInstanceReconciler reconciles a PostgreSQLInstance object
 type PostgreSQLInstanceReconciler struct {
 	client.Client
-	Scheme *runtime.Scheme
+	Scheme      *runtime.Scheme
+	Initializer PostgreSQLInstanceInitializer
+	Timeout     time.Duration
+}
+
+// PostgreSQLInstanceInitializer is the external dependency boundary used by the Instance state machine.
+type PostgreSQLInstanceInitializer interface {
+	Validate(context.Context, *databasev1alpha1.PostgreSQLInstance) (string, error)
+	InitializeRegistry(context.Context, *databasev1alpha1.PostgreSQLInstance) (string, error)
 }
 
 // +kubebuilder:rbac:groups=database.ddupan.top,resources=postgresqlinstances,verbs=get;list;watch;create;update;patch;delete
@@ -62,6 +72,12 @@ func (r *PostgreSQLInstanceReconciler) Reconcile(ctx context.Context, req ctrl.R
 		setReconcilingCondition(&instance.Status.Conditions, instance.Generation, phaseResult.reconcilingMessage)
 	}
 
+	var reconcileErr error
+	if r.Initializer != nil && instance.DeletionTimestamp.IsZero() &&
+		before.Status.Phase != "" && before.Status.Phase != databasev1alpha1.PostgreSQLInstancePhasePending {
+		reconcileErr = r.reconcileDependencies(ctx, instance)
+	}
+
 	if !reflect.DeepEqual(before.Status, instance.Status) {
 		if err := r.Status().Patch(ctx, instance, client.MergeFrom(before)); err != nil {
 			if apierrors.IsConflict(err) {
@@ -71,7 +87,56 @@ func (r *PostgreSQLInstanceReconciler) Reconcile(ctx context.Context, req ctrl.R
 		}
 	}
 
-	return ctrl.Result{}, nil
+	return ctrl.Result{}, reconcileErr
+}
+
+func (r *PostgreSQLInstanceReconciler) reconcileDependencies(
+	ctx context.Context,
+	instance *databasev1alpha1.PostgreSQLInstance,
+) error {
+	if r.Timeout > 0 {
+		var cancel context.CancelFunc
+		ctx, cancel = context.WithTimeout(ctx, r.Timeout)
+		defer cancel()
+	}
+
+	if instance.Status.Phase == databasev1alpha1.PostgreSQLInstancePhaseReady &&
+		instance.Status.ObservedGeneration != instance.Generation {
+		instance.Status.Phase = databasev1alpha1.PostgreSQLInstancePhaseValidating
+		setReconcilingCondition(&instance.Status.Conditions, instance.Generation, "instance dependencies are being validated")
+		return nil
+	}
+
+	var version string
+	var err error
+	switch instance.Status.Phase {
+	case databasev1alpha1.PostgreSQLInstancePhaseValidating:
+		version, err = r.Initializer.Validate(ctx, instance)
+		if err == nil {
+			instance.Status.PostgreSQLVersion = version
+			instance.Status.Phase = databasev1alpha1.PostgreSQLInstancePhaseInitializingRegistry
+			setReconcilingCondition(&instance.Status.Conditions, instance.Generation, "PostgreSQL registry is being initialized")
+		}
+	case databasev1alpha1.PostgreSQLInstancePhaseInitializingRegistry:
+		version, err = r.Initializer.InitializeRegistry(ctx, instance)
+		if err == nil {
+			instance.Status.PostgreSQLVersion = version
+			instance.Status.Phase = databasev1alpha1.PostgreSQLInstancePhaseReady
+			instance.Status.ObservedGeneration = instance.Generation
+			setReadyCondition(&instance.Status.Conditions, instance.Generation, "instance dependencies are ready")
+		}
+	}
+	if err != nil {
+		instance.Status.ObservedGeneration = instance.Generation
+		reason := databasev1alpha1.ReasonDependencyUnavailable
+		var categorized interface{ ConditionReason() string }
+		if errors.As(err, &categorized) {
+			reason = categorized.ConditionReason()
+		}
+		setFailedCondition(&instance.Status.Conditions, instance.Generation, reason,
+			"instance dependency validation failed")
+	}
+	return err
 }
 
 // SetupWithManager sets up the controller with the Manager.