Skip to content

Make it clear to use latest release branch (not main branch)

Adam Mulvany requested to merge docs-clarify-to-use-release-version into main

Reason for documentation update

A customer in https://gitlab.zendesk.com/agent/tickets/432130 suffered an outage after upgrading their cloud native hybrid environment with GET.

We discovered that there were new roles added to the helm values which were came from !995 (merged).

The customer didn't see this in their staging environment because the when they tested the above MR did not exist in the commit history.

Then as it was an Ansible only update (as in no changes were made to the infrastructure with Terraform), the roles were not applied to the matching AWS resources.

The end result is that the resources couldn't talk to each other which caused the outage.

Regarding the docs, the current wording is to use the "latest" version. But the latest version is currently the main branch. We should instead recommend using the latest release version.

Merge request reports