Tanzu RabbitMQ for Kubernetes 3.13.8+ Operator Upgrade Fails with ytt: Error During Reconciliation

Products

• VMware Tanzu RabbitMQ

Issue/Introduction

When upgrading VMware Tanzu RabbitMQ for Kubernetes to 3.13.8 (or later) using Cluster Essentials v1.10.1, the operator upgrade fails with:

kapp: Error: waiting on reconcile packageinstall/tanzu-rabbitmq...  
ytt: Error: Overlaying (overlays/cluster-operator.yml, overlays/namespace.yml, increase-resources.yml):  
Document on line increase-resources.yml:38:  
Expected number of matched nodes to be 1, but was 0

Context:

Your PackageInstall YAML includes the following operators:

• rabbitmq-cluster-operator
• messaging-topology-operator
• standby-replication-operator

Environment

VMWare Tanzu RabbitMQ 3.13.8 and above

Cause

Starting with Tanzu RabbitMQ 3.13.8, the standby-replication-operator is deprecated and unsupported. Its presence in the PackageInstall YAML causes a reconciliation failure in Kapp due to missing resources.

Note: Only rabbitmq-cluster-operator and messaging-topology-operator should be present in the YAML for version 3.13.8 and later.

Resolution

To resolve this issue:

1. Back up your PackageInstall YAML file

2. Edit your PackageInstall YAML file and locate and remove the entire standby-replication-operator section. For example:

# DELETE THIS SECTION (deprecated in 3.13.8+) and any associated configuration for the standby replication operator

#@overlay/match by=overlay.subset({"kind":"Deployment", "metadata": {"name": "standby-replication-operator"}}),expects=1

3. Reapply the updated PackageInstall YAML file to your Kubernetes cluster. The upgrade should now proceed successfully.

4. Verify Operators. After the upgrade, only the following operators should be present. This is expected and aligns with the new operator architecture.

• rabbitmq-cluster-operator
• messaging-topology-operator

 

Additional Information

If you continue to experience issues after making these changes, consult the official documentation or contact VMware support for further assistance.

References:

VMware Tanzu RabbitMQ for Kubernetes Release Notes
How to Install VMware Tanzu RabbitMQ for Kubernetes
Set up and configure Warm Standby Replication