Add new template to follow when bumping Ruby/Alpine versions

1 files changed, 45 insertions, 0 deletions

diff --git a/.gitlab/issue_templates/Ruby Alpine versions bump.md b/.gitlab/issue_templates/Ruby Alpine versions bump.md
new file mode 100644
index 00000000..56608ec6
--- /dev/null
+++ b/.gitlab/issue_templates/Ruby Alpine versions bump.md
@@ -0,0 +1,45 @@
+## Ruby or Alpine version upgrade
+
+This issue is to track the work for upgrading:
+
+<!-- Delete either of the following if only upgrading one -->
+
+- Ruby to version `version`
+- Alpine to version `version`
+
+To bump the versions of Ruby or Alpine:
+
+1. Create a merge request to edit hardcoded versions in
+   [`gitlab_kramdown` project](https://gitlab.com/gitlab-org/ruby/gems/gitlab_kramdown). Cut a new release.
+
+1. After the `gitlab_kramdown` merge request is merged, create a merge request to:
+   - Edit the hardcoded versions in these files:
+
+     - [ ] `dockerfiles/single.Dockerfile`
+     - [ ] `.gitpod.Dockerfile`
+     - [ ] `.ruby-version`
+     - [ ] `.tool-versions`
+
+   -  [ ] Roll the version of `gitlab_kramdown` Gem forward.
+
+1. In the same merge request, edit [`.gitlab-ci.yml`](.gitlab-ci.yml) to bump the environment variables:
+   - [ ] `ALPINE_VERSION`
+   - [ ] `RUBY_VERSION`
+1. After the merge request is merged, run the following manual jobs in the next
+   [scheduled pipeline](https://gitlab.com/gitlab-org/gitlab-docs/-/pipelines?page=1&scope=all&source=schedule):
+
+   - [ ] `image:gitlab-docs-base`
+   - [ ] `image:docs-lint-markdown`
+   - [ ] `image:docs-lint-html`
+
+1. [ ] After the new images are built, make sure they work as expected by first updating
+   the `image` entries in `gitlab-docs`: <https://gitlab.com/gitlab-org/gitlab-docs/-/blob/main/.gitlab/ci/test.gitlab-ci.yml>.
+
+1. Update the the `image` entries in the upstream projects:
+
+   - [ ] GitLab (<https://gitlab.com/gitlab-org/gitlab/-/blob/master/.gitlab/ci/docs.gitlab-ci.yml>)
+   - [ ] Omnibus GitLab (<https://gitlab.com/gitlab-org/omnibus-gitlab/-/blob/master/gitlab-ci-config/gitlab-com.yml>)
+   - [ ] GitLab Runner (<https://gitlab.com/gitlab-org/gitlab-runner/-/blob/main/.gitlab/ci/test.gitlab-ci.yml>)
+   - [ ] GitLab Chart (<https://gitlab.com/gitlab-org/charts/gitlab/-/blob/master/.gitlab-ci.yml>)
+   - [ ] GitLab Operator (<https://gitlab.com/gitlab-org/cloud-native/gitlab-operator/-/blob/master/.gitlab-ci.yml>)
+   - [ ] GitLab Development Kit (<https://gitlab.com/gitlab-org/gitlab-development-kit/-/blob/main/.gitlab/ci/test.gitlab-ci.yml>)