feat: introduce the available probe and condition

apis/apps/v1/componentdefinition_types.go

@@ -1369,6 +1369,13 @@ type ComponentLifecycleActions struct {
 	// +optional
 	RoleProbe *Probe `json:"roleProbe,omitempty"`
 
+	// Defines the procedure which is invoked regularly to assess the availability of the component.
+	//
+	// Note: This field is immutable once it has been set.
+	//
+	// +optional
+	AvailableProbe *Probe `json:"availableProbe,omitempty"`
+
 	// Defines the procedure for a controlled transition of leadership from the current leader to a new replica.
 	// This approach aims to minimize downtime and maintain availability in systems with a leader-follower topology,
 	// during events such as planned maintenance or when performing stop, shutdown, restart, or upgrade operations

apis/apps/v1/deprecated.go

@@ -193,15 +193,13 @@ func GetComponentTerminalPhases() []ClusterComponentPhase {
 		RunningClusterCompPhase,
 		StoppedClusterCompPhase,
 		FailedClusterCompPhase,
-		AbnormalClusterCompPhase,
 	}
 }
 
 func GetReconfiguringRunningPhases() []ClusterPhase {
 	return []ClusterPhase{
 		RunningClusterPhase,
 		UpdatingClusterPhase, // enable partial running for reconfiguring
-		AbnormalClusterPhase,
 		FailedClusterPhase,
 	}
 }

apis/apps/v1/types.go

@@ -44,44 +44,50 @@ const (
 // ClusterComponentPhase defines the phase of a cluster component as represented in cluster.status.components.phase field.
 //
 // +enum
-// +kubebuilder:validation:Enum={Creating,Running,Updating,Stopping,Stopped,Deleting,Failed,Abnormal}
+// +kubebuilder:validation:Enum={Creating,Updating,Stopping,Starting,Deleting,Running,Stopped,Failed}
 type ClusterComponentPhase string
 
 const (
-	// CreatingClusterCompPhase indicates the component is being created.
+	// CreatingClusterCompPhase indicates the component is currently being created.
 	CreatingClusterCompPhase ClusterComponentPhase = "Creating"
 
-	// RunningClusterCompPhase indicates the component has more than zero replicas, and all pods are up-to-date and
-	// in a 'Running' state.
-	RunningClusterCompPhase ClusterComponentPhase = "Running"
-
-	// UpdatingClusterCompPhase indicates the component has more than zero replicas, and there are no failed pods,
-	// it is currently being updated.
+	// UpdatingClusterCompPhase indicates the component is currently being updated.
 	UpdatingClusterCompPhase ClusterComponentPhase = "Updating"
 
-	// StoppingClusterCompPhase indicates the component has zero replicas, and there are pods that are terminating.
+	// StoppingClusterCompPhase indicates the component is currently being stopped.
 	StoppingClusterCompPhase ClusterComponentPhase = "Stopping"
 
-	// StoppedClusterCompPhase indicates the component has zero replicas, and all pods have been deleted.
-	StoppedClusterCompPhase ClusterComponentPhase = "Stopped"
+	// StartingClusterCompPhase indicates the component is currently being started.
+	StartingClusterCompPhase ClusterComponentPhase = "Starting"
 
 	// DeletingClusterCompPhase indicates the component is currently being deleted.
 	DeletingClusterCompPhase ClusterComponentPhase = "Deleting"
 
-	// FailedClusterCompPhase indicates the component has more than zero replicas, but there are some failed pods.
-	// The component is not functioning.
-	FailedClusterCompPhase ClusterComponentPhase = "Failed"
+	// RunningClusterCompPhase indicates all resources of the component are up-to-date and running w/o any failure.
+	RunningClusterCompPhase ClusterComponentPhase = "Running"
+
+	// StoppedClusterCompPhase indicates the component has been stopped, all Pods belonging to the component are terminated.
+	StoppedClusterCompPhase ClusterComponentPhase = "Stopped"
 
-	// AbnormalClusterCompPhase indicates the component has more than zero replicas, but there are some failed pods.
-	// The component is functioning, but it is in a fragile state.
-	AbnormalClusterCompPhase ClusterComponentPhase = "Abnormal"
+	// FailedClusterCompPhase indicates the component encountered some error and did not complete successfully.
+	FailedClusterCompPhase ClusterComponentPhase = "Failed"
 )
 
 const (
-	ConditionTypeProvisioningStarted = "ProvisioningStarted" // ConditionTypeProvisioningStarted the operator starts resource provisioning to create or change the cluster
-	ConditionTypeApplyResources      = "ApplyResources"      // ConditionTypeApplyResources the operator start to apply resources to create or change the cluster
-	ConditionTypeReplicasReady       = "ReplicasReady"       // ConditionTypeReplicasReady all pods of components are ready
-	ConditionTypeReady               = "Ready"               // ConditionTypeReady all components are running
+	// ConditionTypeProvisioningStarted the operator starts resource provisioning to create or change the cluster.
+	ConditionTypeProvisioningStarted = "ProvisioningStarted"
+
+	// ConditionTypeApplyResources the operator start to apply resources to create or change the cluster.
+	ConditionTypeApplyResources = "ApplyResources"
+
+	// ConditionTypeReplicasReady all pods of components are ready.
+	ConditionTypeReplicasReady = "ReplicasReady"
+
+	// ConditionTypeReady all components are running.
+	ConditionTypeReady = "Ready"
+
+	// ConditionTypeAvailable indicates whether the target object is available for serving.
+	ConditionTypeAvailable = "Available"
 )
 
 type ServiceRef struct {

config/crd/bases/apps.kubeblocks.io_clusters.yaml

@@ -15937,13 +15937,13 @@ spec:
                       description: Specifies the current state of the Component.
                       enum:
                       - Creating
-                      - Running
                       - Updating
                       - Stopping
-                      - Stopped
+                      - Starting
                       - Deleting
+                      - Running
+                      - Stopped
                       - Failed
-                      - Abnormal
                       type: string
                   type: object
                 description: Records the current status information of all Components