✨ add a new field that reports errors in case resource was incompatible

config/crds/workload.kcp.io_synctargets.yaml

@@ -197,6 +197,10 @@ spec:
                         on APIExport and APIResourceSchema's status. It will be empty
                         for core types.
                       type: string
+                    message:
+                      description: A human readable message indicating details about
+                        the compatibility errors. This field may be empty.
+                      type: string
                     resource:
                       description: 'resource is the name of the resource. Note: it
                         is worth noting that you can not ask for permissions for resource

config/root-phase0/apiexport-workload.kcp.io.yaml

@@ -5,5 +5,5 @@ metadata:
   name: workload.kcp.io
 spec:
   latestResourceSchemas:
-  - v230109-773b219c.synctargets.workload.kcp.io
+  - v230329-eaa109f2.synctargets.workload.kcp.io
 status: {}

config/root-phase0/apiresourceschema-synctargets.workload.kcp.io.yaml

@@ -2,7 +2,7 @@ apiVersion: apis.kcp.io/v1alpha1
 kind: APIResourceSchema
 metadata:
   creationTimestamp: null
-  name: v230109-773b219c.synctargets.workload.kcp.io
+  name: v230329-eaa109f2.synctargets.workload.kcp.io
 spec:
   group: workload.kcp.io
   names:
@@ -192,6 +192,10 @@ spec:
                       on APIExport and APIResourceSchema's status. It will be empty
                       for core types.
                     type: string
+                  message:
+                    description: A human readable message indicating details about
+                      the compatibility errors. This field may be empty.
+                    type: string
                   resource:
                     description: 'resource is the name of the resource. Note: it is
                       worth noting that you can not ask for permissions for resource

pkg/reconciler/workload/synctargetexports/synctargetcompatible_reconcile.go

@@ -123,11 +123,15 @@ func (e *apiCompatibleReconciler) reconcile(ctx context.Context, syncTarget *wor
 				field.NewPath(gvr.String()), upstreamSchema, downStreamSchema, false)
 			if err != nil {
 				syncTarget.Status.SyncedResources[i].State = workloadv1alpha1.ResourceSchemaIncompatibleState
+				syncTarget.Status.SyncedResources[i].Message = err.Error()
 				continue
 			}
 
 			// since version is ordered, so if the current version is comptaible, we can skip the check on other versions.
 			syncTarget.Status.SyncedResources[i].State = workloadv1alpha1.ResourceSchemaAcceptedState
+			if syncTarget.Status.SyncedResources[i].Message != "" {
+				syncTarget.Status.SyncedResources[i].Message = ""
+			}
 			break
 		}
 	}

sdk/apis/workload/v1alpha1/synctarget_types.go

@@ -136,6 +136,11 @@ type ResourceToSync struct {
 	// +kubebuilder:default=Pending
 	// +optional
 	State ResourceCompatibleState `json:"state,omitempty"`
+
+	// A human readable message indicating details about the compatibility errors.
+	// This field may be empty.
+	// +optional
+	Message string `json:"message,omitempty"`
 }
 
 type ResourceCompatibleState string