feat(argocd): configure resource tracking and health checks for Crossplane

Add patch for Argo CD ConfigMap to enable annotation-based tracking, health checks for Upbound
resources, and exclusions for ProviderConfigUsage. Also patch Argo CD server during bootstrap.

Author: wnqueiroz

.bootstrap/argocd/manifests/argocd-cm-patch.yaml

@@ -0,0 +1,49 @@
+# @see https://docs.crossplane.io/latest/guides/crossplane-with-argo-cd
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: argocd-cm
+  namespace: argocd-system
+data:
+  application.resourceTrackingMethod: annotation
+  resource.customizations: |
+    "*.upbound.io/*":
+      health.lua: |
+        health_status = {
+          status = "Progressing",
+          message = "Provisioning ..."
+        }
+
+        local function contains (table, val)
+          for i, v in ipairs(table) do
+            if v == val then
+              return true
+            end
+          end
+          return false
+        end
+
+        local has_no_status = {
+          "ProviderConfig",
+          "ProviderConfigUsage"
+        }
+
+        if obj.status == nil or next(obj.status) == nil and contains(has_no_status, obj.kind) then
+          health_status.status = "Healthy"
+          health_status.message = "Resource is up-to-date."
+          return health_status
+        end
+
+        if obj.status == nil or next(obj.status) == nil or obj.status.conditions == nil then
+          if obj.kind == "ProviderConfig" and obj.status.users ~= nil then
+            health_status.status = "Healthy"
+            health_status.message = "Resource is in use."
+            return health_status
+          end
+          return health_status
+        end
+  resource.exclusions: |
+    - apiGroups:
+      - "*"
+      kinds:
+      - ProviderConfigUsage

.bootstrap/argocd/up.sh

@@ -11,7 +11,7 @@ if [[ "$(kubectl config current-context)" != "kind-platform" ]]; then
 fi
 
 NS=argocd-system
-BASE_DIR=./argocd
+BASE_DIR="$(dirname "$0")"
 MANIFESTS_DIR="$BASE_DIR/manifests"
 PORT=8080
 ARGO_PWD_NEW="12345678"
@@ -32,6 +32,10 @@ kubectl wait --for=condition=available --timeout=120s deployment/argocd-server -
     exit 1
 }
 
+kubectl patch configmap argocd-cm -n $NS --patch-file $MANIFESTS_DIR/argocd-cm-patch.yaml
+kubectl rollout restart deployment argocd-server -n $NS
+kubectl rollout status deployment argocd-server -n $NS
+
 # Start port-forward only if not already active
 if ! lsof -i TCP:$PORT >/dev/null 2>&1; then
     if kubectl get svc/argocd-server -n "$NS" >/dev/null 2>&1; then
@@ -81,6 +85,6 @@ fi
 
 # Apply Argo CD applications or configs
 echo "Applying Argo CD manifests..."
-kubectl apply -f "$BASE_DIR/crossplane-claims.yaml"
+kubectl apply -f "./argocd/crossplane-claims.yaml"
 
 echo "✅ Argo CD setup completed successfully!"

.bootstrap/backstage/up.sh

@@ -28,13 +28,18 @@ else
     echo "✅ Namespace $NS already exists."
 fi
 
-echo "Building Backstage image $IMAGE..."
-cd ./backstage
-docker rmi -f $IMAGE
-yarn build:all
-yarn build-image --tag "$IMAGE" --no-cache
+echo "Checking if Backstage image '$IMAGE' already exists..."
+if ! docker image inspect "$IMAGE" >/dev/null 2>&1; then
+    echo "🔨 Building Backstage image $IMAGE..."
+    cd ./backstage
+    yarn build:all
+    yarn build-image --tag "$IMAGE" --no-cache
+    cd ..
+else
+    echo "✅ Docker image $IMAGE already exists. Skipping build."
+fi
+
 kind load docker-image "$IMAGE" --name "$CLUSTER_NAME"
-cd ..
 
 # Apply manifests to the cluster (idempotent)
 echo "Applying manifests from $MANIFESTS_DIR..."

argocd/crossplane-claims.yaml

@@ -18,3 +18,9 @@ spec:
     automated:
       prune: true
       selfHeal: true
+  # ignoreDifferences:
+  #   - group: platform.hooli.tech
+  #     kind: XQueue
+  #     jsonPointers:
+  #       - /spec
+  #       - /status