Update DataHub version

There is no prescribed cadence for updates to DataHub, but new minor versions bumps are typically released every couple of months. Due to the rapid pace of feature development within the platform we aim to be close to the most recent release (without unnecessary exposure to unintended breaking changes).

The upgrade process for DataHub is relatively straightforward as it is handled by a dedicated upgrade job:

1. Check the DataHub ‘Updating DataHub’ page for breaking changes
2. Check the DataHub helm releases to check for the latest release that’s compatible with the destination version
3. Check the DataHub helm release changes from current deployed version to future version for any changes that need to be propagated to the helm chart values files (make sure to set the ‘base’ and ‘compare’ to the correct release values in this view)
4. Submit the upgrade release PR and send an ‘alert’ message to the #data-catalogue-dev channel to let others know that DataHub may be disrupted
5. Deploy to dev and test out the DataHub interface, ensure that Find MoJ Data dev continues to function (run a test deployment)
   • Make sure to test out multiple pages of Find MoJ Data, as we’ve found that previously described changes not considered to be breaking have broken our front end.
6. If there are issues with the upgrade and compatibility with Find MoJ Data, work with the team to determine the best course of action for upgrade, which may involve a temporary rollback.
7. Once there are no issues with the upgrade, merge the PR and roll out the upgrade to higher environments.

This page was last reviewed on 19 April 2024. It needs to be reviewed again on 19 July 2024 by the page owner #data-catalogue .

This page was set to be reviewed before 19 July 2024 by the page owner #data-catalogue. This might mean the content is out of date.