Skip to content

Rollbacks

If an upgrade causes issues, revert to the previous working version by deploying the prior container image.

Rollback Procedure

1. Identify the Previous Version

Check your deployment history or release notes for the last known good version.

2. Deploy the Previous Version

# Azure Container Apps example
az containerapp update \
  --name {app_name} \
  --resource-group {resource_group} \
  --image ghcr.io/caprusai/agentcube-essbase:{previous_version} \
  --revision-suffix "rollback-{timestamp}"

3. Verify

curl https://{connector_hostname}/health

Confirm version shows the previous version and status is healthy.

4. Test

Run a tool call from your AI platform to verify end-to-end functionality.

Notes

  • Rollbacks are safe — connector versions are immutable container images
  • Environment variable changes are independent of image versions. If you changed environment variables as part of the upgrade, you may need to revert those as well
  • Container registries retain previous image versions, so rollback images are always available