Skip to main content

Upgrades

Zen Mesh uses Helm for upgrades. Always check the changelog before upgrading.

Standard Upgrade

helm repo update
helm upgrade zen-agent zenmesh/zen-agent \
--namespace zen-mesh \
--reuse-values

Rolling Upgrade

Helm performs a rolling upgrade by default. The agent and egress pods are replaced one at a time, ensuring continuous delivery.

Pre-Upgrade Checklist

  • Review the changelog for breaking changes
  • Back up your configuration: helm get values zen-agent -n zen-mesh > values-backup.yaml
  • Verify cluster health: all pods in zen-mesh namespace are Running

Rollback

If an upgrade causes issues:

helm rollback zen-agent <revision> --namespace zen-mesh

To find the previous revision:

helm history zen-agent --namespace zen-mesh

Version Compatibility

zen-agentControl PlaneNotes
0.3.x0.3.xCurrent
0.2.x0.2.xSupported
< 0.2.xUpgrade to 0.2.x first