Move release instructions into issue template

1 files changed, 59 insertions, 0 deletions

diff --git a/.gitlab/issue_templates/release.md b/.gitlab/issue_templates/release.md
new file mode 100644
index 00000000..7adaa21c
--- /dev/null
+++ b/.gitlab/issue_templates/release.md
@@ -0,0 +1,59 @@
+- [ ] Set the milestone on this issue
+- [ ] Review the list of changes since the last release and fill below:
+    - [ ] **In the changelog**
+    - [ ] **Not in the changelog**
+- Decide on the version number by reference to
+    the [Versioning](https://gitlab.com/gitlab-org/gitlab-pages/blob/master/PROCESS.md#versioning)
+    * Typically if you want to release code from current `master` branch you will update `MINOR` version, e.g. `1.12.0` -> `1.13.0`. In that case you **don't** need to create stable branch
+    * If you want to backport some bug fix or security fix you will need to update stable branch `X-Y-stable`
+- [ ] Create an MR for [gitlab-pages project](https://gitlab.com/gitlab-org/gitlab-pages).
+    You can use [this MR](https://gitlab.com/gitlab-org/gitlab-pages/merge_requests/217) as an example.
+    - [ ] Update `VERSION`
+    - [ ] Update `CHANGELOG`
+    - [ ] Assign to reviewer
+- [ ] Once `gitlab-pages` is merged create a signed+annotated tag pointing to the **merge commit** on the **stable branch**
+    In case of `master` branch:
+    ```shell
+    git fetch origin master
+    git fetch dev master
+    git tag -a -s -m "Release v1.0.0" v1.0.0 origin/master
+    ```
+    In case of `stable` branch:
+    ```shell
+    git fetch origin 1-0-stable
+    git fetch dev 1-0-stable
+    git tag -a -s -m "Release v1.0.0" v1.0.0 origin/1-0-stable
+    ```
+- [ ] Verify that you created tag properly:
+    ```shell
+    git show v1.0.0
+    ```
+    it should include something like:
+    * ```(tag: v1.0.0, origin/master, dev/master, master)``` for `master`
+    * ```(tag: v1.0.1, origin/1-0-stable, dev/1-0-stable, 1-0-stable)``` for `stable` branch
+- [ ] Push this tag to origin(**Skip this for security release!**)
+    ```shell
+    git push origin v1.0.0
+    ```
+- [ ] Wait for tag to be mirrored to `dev` or push it:
+    ```shell
+    git push dev v1.0.0
+    ```
+- [ ] Create an MR for [gitlab project](https://gitlab.com/gitlab-org/gitlab).
+    You can use [this MR](https://gitlab.com/gitlab-org/gitlab/merge_requests/23023) as an example.
+    - [ ] Update `GITLAB_PAGES_VERSION`
+    - [ ] Create a changelog entry
+    - [ ] Assign to a reviewer
+
+### In the changelog
+```
+- some change
+- some change
+```
+### Not in the changelog
+```
+- some change
+- some change
+```
+
+/label ~backend ~backstage ~"Category:Pages" ~"devops::release" ~"group::release management"