The GitLab support team is here to help. As a part of our Priority Support we offer Live Upgrade Assistance. That is, we'll host a live screen share session to help you through the process and ensure there aren't any surprises.
For support to properly assist you, the earlier you can notify us, the better. Our minimum requirements for notification are:
If you cannot meet our minimum advanced notice period for your planned upgrade, we may not be able to go ahead with a Live Upgrade Assistance call. In this case:
First, confirm that nothing about your instance would make the request out of scope for support.
Then, please provide all the relevant information you can so that we will be best positioned to assist you. At a minimum, we require:
You can do so, however we cannot review the scripts themselves to determine if they are viable. Generally speaking, our upgrade documentation is the single source of truth for how to best carry out an upgrade.
If issues do occur during the upgrade window and you are running a custom script, it is likely the advice from support will be to utilize your rollback plan. It is important to know that should issues arise while using custom scripts, Support will recommend following the exact steps from our documentation on future attempts.
If you don't have a Technical Account Manager, but still have Priority Support - please contact support with the above required information directly to schedule.
A GitLab Engineer will join you for the first 30 minutes of your upgrade, to help kick things off and ensure that you're set up for success by:
At that point, the engineer will drop off the call and watch the ticket for any updates for the duration of the upgrade. If required, they'll rejoin the ongoing call to troubleshoot any issues.
Once the upgrade is complete, and has passed your post-upgrade success criteria, please be sure to send an update to the ticket that was opened so the Engineer knows they can go offline.
If there haven't been any updates for some time, the Engineer assisting may rejoin the call or send an update to the ticket requesting an update.
If the upgrade is taking longer than expected and the shift of the assigned engineer is about to end, they will notify you through the support ticket that they are no longer available. If you need assistance after that point, please page the on-call engineer to help troubleshoot.
As noted in our Statement of Support, we support the current major version and two previous major versions. If you're upgrading from a version of GitLab that is no longer supported, Live Upgrade Assistance may not be an option. If you're in this situation, please discuss options with your Technical Account Manager or your Account Manager for Professional Services options.
As a part of Priority Support, you're also entitled to 24x7 uptime Support. If you encounter any issues that are leading to downtime during your upgrade, you can page the on-call engineer to help troubleshoot.
Please provide as much context as you can, including an upgrade plan when you open your emergency ticket.
Do note, that in some cases the best option available may be to invoke your roll-back plan and reschedule the upgrade.