update

apis/apps/v1/componentdefinition_types.go

@@ -1254,7 +1254,7 @@ type ComponentAvailable struct {
 	// This field is immutable once set.
 	//
 	// +optional
-	WithPhases *string `json:"phases,omitempty"`
+	WithPhases *string `json:"withPhases,omitempty"`
 
 	// Specifies the strategies for determining whether the component is available based on the available probe.
 	//

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

@@ -107,7 +107,7 @@ spec:
 
                   This field is immutable.
                 properties:
-                  phases:
+                  withPhases:
                     description: |-
                       Specifies the phases that the component will go through to be considered available.
 

controllers/apps/transformer_component_status.go

@@ -448,13 +448,13 @@ func (t *componentStatusTransformer) reconcileAvailableCondition(transCtx *compo
 	)
 	status, reason, message := func() (metav1.ConditionStatus, string, string) {
 		if comp.Status.Phase == "" {
-			return metav1.ConditionUnknown, "Unknown", "component phase is unknown"
+			return metav1.ConditionUnknown, "Unknown", "the component phase is unknown"
 		}
 		phases := sets.New[string](strings.Split(strings.ToLower(*policy.WithPhases), ",")...)
 		if phases.Has(strings.ToLower(string(comp.Status.Phase))) {
-			return metav1.ConditionTrue, "Available", fmt.Sprintf("component phase is %s", comp.Status.Phase)
+			return metav1.ConditionTrue, "Available", fmt.Sprintf("the component phase is %s", comp.Status.Phase)
 		}
-		return metav1.ConditionFalse, "Unavailable", fmt.Sprintf("component phase is %s", comp.Status.Phase)
+		return metav1.ConditionFalse, "Unavailable", fmt.Sprintf("the component phase is %s", comp.Status.Phase)
 	}()
 
 	cond := metav1.Condition{

deploy/helm/crds/apps.kubeblocks.io_componentdefinitions.yaml

@@ -107,7 +107,7 @@ spec:
 
                   This field is immutable.
                 properties:
-                  phases:
+                  withPhases:
                     description: |-
                       Specifies the phases that the component will go through to be considered available.
 

docs/developer_docs/api-reference/cluster.md

@@ -4138,7 +4138,7 @@ VarOption
 <tbody>
 <tr>
 <td>
-<code>phases</code><br/>
+<code>withPhases</code><br/>
 <em>
 string
 </em>

pkg/controller/component/available.go

@@ -151,7 +151,7 @@ func (h *AvailableEventHandler) handleEvent(event probeEvent, comp *appsv1.Compo
 	}
 	available, message := h.evalCond(*policy.WithProbe.Condition, comp.Spec.Replicas, events)
 	if available {
-		message = "Component is available"
+		message = "the available conditions are met"
 		if len(policy.WithProbe.Description) > 0 {
 			message = policy.WithProbe.Description
 		}
@@ -557,6 +557,7 @@ func GetComponentAvailablePolicy(compDef *appsv1.ComponentDefinition) appsv1.Com
 						},
 					},
 				},
+				Description: "all replicas are available",
 			},
 		}
 	}