From b331f1424832854cfe5f593fb56aa36d36cdae2b Mon Sep 17 00:00:00 2001
From: Sampath Ranasinghe <sranasinghe@gitlab.com>
Date: Wed, 11 May 2022 13:55:54 +0000
Subject: [PATCH] Geo 15.0 removals - remove promote-db

---
 data/removals/15_0/15-0-geo-remove-promote-db.yml | 13 +++++++++++++
 doc/update/removals.md                            | 10 ++++++++++
 2 files changed, 23 insertions(+)
 create mode 100644 data/removals/15_0/15-0-geo-remove-promote-db.yml

diff --git a/data/removals/15_0/15-0-geo-remove-promote-db.yml b/data/removals/15_0/15-0-geo-remove-promote-db.yml
new file mode 100644
index 000000000000..65fa8fdff8ea
--- /dev/null
+++ b/data/removals/15_0/15-0-geo-remove-promote-db.yml
@@ -0,0 +1,13 @@
+- name: "The `promote-db` command is no longer available from `gitlab-ctl`"
+  announcement_milestone: "14.5"
+  announcement_date: "2021-11-22"
+  removal_milestone: "15.0"
+  removal_date: "2022-05-22"
+  breaking_change: true
+  reporter: sranasinghe
+  stage: enablement
+  issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/345207
+  body: |
+    In GitLab 14.5, we introduced the command `gitlab-ctl promote` to promote any Geo secondary node to a primary during a failover. This command replaces `gitlab-ctl promote-db` which is used to promote database nodes in multi-node Geo secondary sites. The `gitlab-ctl promote-db` command has been removed in GitLab 15.0.
+  tiers: [Premium, Ultimate]
+  documentation_url: https://docs.gitlab.com/ee/administration/geo/disaster_recovery/planned_failover.html
diff --git a/doc/update/removals.md b/doc/update/removals.md
index 443704cbb4ea..06e2be2ab441 100644
--- a/doc/update/removals.md
+++ b/doc/update/removals.md
@@ -283,6 +283,16 @@ has been removed.
 To set test coverage parsing, use the project’s `.gitlab-ci.yml` file by providing a regular expression with the
 [`coverage` keyword](https://docs.gitlab.com/ee/ci/yaml/index.html#coverage).
 
+### The `promote-db` command is no longer available from `gitlab-ctl`
+
+WARNING:
+This feature was changed or removed in 15.0
+as a [breaking change](https://docs.gitlab.com/ee/development/contributing/#breaking-changes).
+Before updating GitLab, review the details carefully to determine if you need to make any
+changes to your code, settings, or workflow.
+
+In GitLab 14.5, we introduced the command `gitlab-ctl promote` to promote any Geo secondary node to a primary during a failover. This command replaces `gitlab-ctl promote-db` which is used to promote database nodes in multi-node Geo secondary sites. The `gitlab-ctl promote-db` command has been removed in GitLab 15.0.
+
 ### Update to the Container Registry group-level API
 
 WARNING:
-- 
GitLab