Skip to content

PARTIAL SUCCESS: Upgrade Geo HA installation from 12.8.1 to the latest 12.9 package

Versions

Current: 12.8.1 Target: 12.9.10

Upgrade checklist

Preflight - upgrade

  • Create a zoom meeting and schedule a recorded meeting (make sure you have a paid account, otherwise recordings will stop after 40 minutes)
  • Check if the Geo HA update instructions contain version specific changes
  • Check if PostgreSQL is already the latest shipped version. If not, ensure PostgreSQL upgrade instructions are followed.
  • Check if any upgrade warnings exist
  • Verify that the Geo cluster is healthy pre upgrade
  • Find the latest packaged version of GitLab that can be used for zero downtime upgrades
  • Set up the looping test pipeline to run during the upgrade procedure. Prepare to run a new pipeline at the beginning of each upgrade step.

Upgrade

  • Retrieve a beverage of choice within a drinkable temperature range
  • Join Zoom meeting and wait for arrival. Hit the record button
  • Manually trigger the looping test pipeline to start running smoke tests at the beginning of each major upgrade step (choose deploy node, update primary, update secondary, run migrations)
  • Perform upgrade steps described in latest documentation.
  • During the upgrade process, monitor the looping test pipeline for any failures
  • Record any issues encountered during the upgrade
  • Verify cluster health post upgrade
  • Verify PostgreSQL version is correct

Postflight

  • Record the upgrade outcome as SUCCESS (upgrade with zero downtime), FAILED, PARTIAL SUCCESS (upgrade but with downtime or unconfirmed downtime)
  • Open new issues and inform @nhxnguyen and @fzimmer to confirm next steps
  • Create new issue for the next upgrade demo (the next versions) and assign to @nhxnguyen and @fzimmer
Edited by Jennifer Louie