Troubleshoot Crossplane

This topic explains how you troubleshoot issues related to Crossplane on Tanzu Application Platform (commonly known as TAP).

For the limitations of Crossplane, see Crossplane limitations.

Resource already exists error when installing Crossplane

Symptom:

Installation of Crossplane, or a Tanzu Application Platform profile that includes Crossplane, fails with the error:

Resource already exists

Explanation:

Crossplane is already installed on the cluster. You cannot install the Crossplane package on a cluster that already has Crossplane installed on it by using another method, such as Helm install.

Solution:

Exclude the Crossplane package in the tap-values.yaml file. For more information, see Use your existing Crossplane installation.

---

The validatingwebhookconfiguration is not removed when you uninstall the Crossplane Package

Symptom:

The Crossplane Package deploys a validatingwebhookconfiguration named crossplane during installation. This resource is not deleted when you uninstall the Package.

Solution:

Delete the validatingwebhookconfiguration manually by running:

kubectl delete validatingwebhookconfiguration crossplane

---

Crossplane component fails to reconcile during upgrade

Symptom:

The Crossplane package fails to reconcile when upgrading the package. The providers and function-patch-and-transform fail with error message:

cannot resolve package dependencies: missing node in tree

You can see the error message if you run these commands:

kubectl get provider.pkg -n crossplane-system -o yaml
kubectl get functions -n crossplane-system -o yaml

Explanation:

When upgrading the Crossplane package, this issue can occur if the source of the package has changed without changing its version.

Solution:

As a workaround:

1. Edit the lock and update the package source for provider-helm, provider-kubernetes, and function-patch-and-transform with the new package source as follows:

   kubectl edit locks.pkg.crossplane.io lock
   
   packages:
   - dependencies: []
     name: provider-helm-919772e449f3
     source: tanzu.packages.broadcom.com/tanzu-application-platform/tap-packages:provider-helm
     type: Provider
     version: ...
   - dependencies: []
     name: function-patch-and-transform-7799bf5e4e7f
     source: tanzu.packages.broadcom.com/tanzu-application-platform/tap-packages:function-patch-and-transform
     type: Function
     version: ...
   - dependencies: []
     name: provider-kubernetes-28e95f897554
     source: tanzu.packages.broadcom.com/tanzu-application-platform/tap-packages:provider-kubernetes
     type: Provider
     version: ...
   

2. Verify that the providers and functions are healthy, and that Crossplane package has reconciled by running:

   kubectl get provider.pkg -n crossplane-system
   kubectl get functions -n crossplane-system
   kubectl get packageinstall crossplane -n tap-install