Deprecate `gitlab-ctl promote-to-primary-node` and `gitlab-ctl promote-db`

Deprecation Summary

With the introduction of a single-command to promote a secondary node, gitlab-ctl geo promote will replace the previous promotion commands gitlab-ctl promote-to-primary-node and gitlab-ctl promoted-db.

Beginning in 14.5, the previous promotion commands will be deprecated.

In 15.0, we will remove the commands gitlab-ctl promote-to-primary-node and gitlab-ctl promoted-db.

Breaking Change

In 15.0, administrators can no longer use the deprecated commands and will need to use gitlab-ctl geo promote to perform a failover. We recommend that, before upgrading to 15.0, administrators test the new gitlab-ctl promote command and incorporate it into their failover processes.

Affected Topology

This affects self-hosted customers who use Geo for Disaster Recovery.

Affected Tier

Premium and Ultimate

Checklist

• @mention your stage's stable counterparts on this issue. For example, Customer Support, Customer Success (Technical Account Manager), Product Marketing Manager.

  • To see who the stable counterparts are for a product team visit product categories
    • If there is no stable counterpart listed for Sales/CS please mention @timtams
    • If there is no stable counterpart listed for Support please @mention @gitlab-com/support/managers
    • If there is no stable counterpart listed for Marketing please mention @williamchia

• @mention your GPM so that they are aware of planned deprecations. The goal is to have reviews happen at least two releases before the final removal of the feature or introduction of a breaking change.

Deprecation Milestone

14.5

Planned Removal Milestone

15.0

Links