GitLab Runner 13.1.1 release checklist
Previous release checklist issue: #26029 (closed)
GitLab Runner Release manager: @steveazz
13.1.1
Pick into stable branch At this moment, until the next RC creation, we're in the pick into stable phase. The release manager should periodically review the list of merged MRs with a pick into X.Y label:
- GitLab Runner ~"Pick into 13.1" Merge Requests
- GitLab Runner Helm Chart ~"Pick into 0.18" Merge Requests
GitLab Runner MRs:
GitLab Runner's Helm Chart MRs:
For each such Merge Request the release manager should (reveal for details)
-
Find the merge commit for the Merge Request
-
Copy the commit reference
-
Checkout to the branch:
-
git checkout 13-1-stable && git pull
for GitLab Runner, or -
git checkout 0-18-0-stable && git pull
for GitLab Runner's Helm Chart
-
-
Pick the merge commit with:
git cherry-pick -m 1 [merge commit SHA here]
-
Remove the
Pick into X.Y
label from the Merge Request and leave a note that it was picked:
-
for GitLab Runner use this message:
The MR was picked into `13-1-stable` branch and will be released with `v13.1.1` /unlabel ~"Pick into 13.1"
-
for GitLab Runner's Helm Chart use this message:
The MR was picked into `0-18-0-stable` branch and will be released with `v0.18.1` /unlabel ~"Pick into 0.18"
To prepare the `Pick into ...` MRs list execute:
rrhelper \
list-pick-mrs-for-rc \
--non-interactive \
--do-not-create \
--major 13 \
--minor 1 \
--helm-chart-major 0 \
--helm-chart-minor 18 \
26029 2
13.1.1
-
check if Pipeline for 13-1-stable
is passing:-
add all required fixes to make 13-1-stable
Pipeline passing
-
-
git checkout 13-1-stable && git pull
in your local working copy! -
prepare CHANGELOG entries make generate_changelog CHANGELOG_RELEASE=v13.1.1
-
add v13.1.1 CHANGELOG entries and commit git add CHANGELOG.md && \ git commit -m "Update CHANGELOG for v13.1.1" -S
-
tag and push v13.1.1: git tag -s v13.1.1 -m "Version v13.1.1" && \ git push origin v13.1.1
-
push 13-1-stable
branch:git push origin 13-1-stable
-
wait for Pipeline for v13.1.1
to pass-
add all required fixes to make v13.1.1
passing
-
-
update runner helm chart to use v13.1.1
version-
check if Pipeline for 0-18-0-stable
is passing:-
add all required fixes to make 0-18-0-stable
Pipeline passing
-
-
go to your local working copy of https://gitlab.com/gitlab-org/charts/gitlab-runner -
git checkout 0-18-0-stable && git pull
in your local working copy! -
set Helm Chart to use v13.1.1
version of GitLab Runnersed -i".bak" "s/^appVersion: .*/appVersion: 13.1.1/" Chart.yaml && \ rm Chart.yaml.bak && \ git add Chart.yaml && \ git commit -m "Update used GitLab Runner version to 13.1.1" -S
-
bump version of the Helm Chart to 0.18.1
sed -i".bak" "s/^version: .*/version: 0.18.1/" Chart.yaml && \ rm Chart.yaml.bak && \ git add Chart.yaml && \ git commit -m "Bump version to 0.18.1" -S
-
prepare CHANGELOG entries make generate_changelog CHANGELOG_RELEASE=v0.18.1
-
manually add line including GitLab Runner version update information as the first item: - Update GitLab Runner version to 13.1.1
-
-
add v0.18.1 CHANGELOG entries and commit git add CHANGELOG.md && \ git commit -m "Update CHANGELOG for v0.18.1" -S
-
tag and push v0.18.1: git tag -s v0.18.1 -m "Version v0.18.1" && \ git push origin v0.18.1
-
push 0-18-0-stable: git push origin 0-18-0-stable
-
-
update Runner's chart version used by GitLab: gitlab!35712 (merged) -
create branch rrhelper \ --dry-run \ create-branch \ gitlab-org/gitlab \ update-gitlab-runner-helm-chart-to-0.18.1
-
create Merge Request rrhelper \ --dry-run \ create-merge-request \ --release-checklist-issue 26029 \ --replace-link-in-release-checklist-issue link_to_MR__gce_rhcvu \ --milestone 13.2 \ --runner-version 13.1.1 \ --helm-chart-version 0.18.1 \ gitlab-org/gitlab \ update-gitlab-runner-helm-chart-to-0.18.1 \ master \ runner-helm-chart-upgrade-in-gitlab \ "Update GitLab Runner Helm Chart to 0.18.1/13.1.1"
-
Adjust and apply the patch to the GitLab CE sources See the patch draft
-
Adjust the following patch (set proper current version; set the Merge Request ID in the CHANGELOG entry file) and save it at /tmp/patch.gitlab
.cat > /tmp/patch.gitlab << EOF diff --git a/app/models/clusters/applications/runner.rb b/app/models/clusters/applications/runner.rb inde 0c0247da1fb..f17da0bb7b1 100644 --- a/app/models/clusters/applications/runner.rb +++ b/app/models/clusters/applications/runner.rb @@ -3,7 +3,7 @@ module Clusters module Applications class Runner < ApplicationRecord - VERSION = '0.18.0' + VERSION = '0.18.1' self.table_name = 'clusters_applications_runners' diff --git a/changelogs/unreleased/update-gitlab-runner-helm-chart-to-0.18.1.yml b/changelogs/unreleased/update-gitlab-runner-helm-chart-to-0.18.1.yml new file mode 100644 inde 00000000000..7d92929221f --- /dev/null +++ b/changelogs/unreleased/update-gitlab-runner-helm-chart-to-0.18.1.yml @@ -0,0 +1,5 @@ +--- +title: Update GitLab Runner Helm Chart to 0.18.1 +merge_request: XXX +author: +type: other EOF
-
Go to your local GitLab CE working directory: git checkout master && \ git pull && \ git checkout update-gitlab-runner-helm-chart-to-0.18.1 && \ git apply /tmp/patch.gitlab && \ git add . && \ git commit -m "Update GitLab Runner Helm Chart to 0.18.1"
-
Push changes git push -u origin update-gitlab-runner-helm-chart-to-0.18.1
-
-
-
update Runner's chart version used by Cluster Applications: gitlab-org/cluster-integration/cluster-applications!106 (merged) -
create branch rrhelper \ --dry-run \ create-branch \ gitlab-org/cluster-integration/cluster-applications \ update-gitlab-runner-helm-chart-to-0.18.1
-
create Merge Request rrhelper \ --dry-run \ create-merge-request \ --release-checklist-issue 26486 \ --replace-link-in-release-checklist-issue link_to_MR__ghc_rhcvu \ --milestone 13.1 \ --runner-version 13.1.1 \ --helm-chart-version 0.18.1 \ gitlab-org/cluster-integration/cluster-applications \ update-gitlab-runner-helm-chart-to-0.18.1 \ master \ runner-helm-chart-upgrade-in-cluster-applications \ "feat: Update GitLab Runner Helm Chart to 0.18.1/13.1.1"
-
Adjust and apply the patch to the GitLab Helm Chart sources See the patch draft
-
Adjust the following patch (set proper current version; set the Merge Request ID in the CHANGELOG entry file) and save it at /tmp/patch.gitlab-cluster-applications
.cat > /tmp/patch.gitlab-cluster-applications << EOF diff --git a/src/default-data/gitlab-runner/helmfile.yaml b/src/default-data/gitlab-runner/helmfile.yaml inde d839d7f..f358afa 100644 --- a/src/default-data/gitlab-runner/helmfile.yaml +++ b/src/default-data/gitlab-runner/helmfile.yaml @@ -13,7 +13,7 @@ releases: - name: runner namespace: {{ requiredEnv "TILLER_NAMESPACE" }} chart: gitlab/gitlab-runner - version: 0.18.0 + version: 0.18.1 installed: {{ .Values.gitlabRunner.installed }} missingFileHandler: Warn values: EOF
-
Go to your local GitLab Cluster Application working directory: git checkout master && \ git pull && \ git checkout update-gitlab-runner-helm-chart-to-0.18.1 && \ git apply /tmp/patch.gitlab-cluster-applications && \ git add . && \ git commit -m "Update GitLab Runner Helm Chart to 0.18.1"
-
Push changes git push -u origin update-gitlab-runner-helm-chart-to-0.18.1
-
-
-
deploy v13.1.1 Detailed description of Runners deployment for GitLab.com CI fleet can be found in the runbook.
-
at RC2 release day: to prmX
runners-
go to your local chef-repo
working directory and execute:knife ssh -afqdn 'roles:gitlab-runner-prm' -- 'sudo -i systemctl stop chef-client' knife ssh -afqdn 'roles:gitlab-runner-prm' -- 'sudo -i systemctl is-active chef-client' git checkout master && git pull git checkout -b update-prm-runners-to-13-1-1
-
update version $EDITOR roles/gitlab-runner-prm.json
In the role definition prepare the
override_attributes
entry. It should be placed at the top of the file:"override_attributes": { "cookbook-gitlab-runner": { "gitlab-runner": { "repository": "unstable", "version": "13.1.1" } } },
-
git add roles/gitlab-runner-prm.json && git commit -m "Update prmX runners to v13.1.1"
-
git push -u origin update-prm-runners-to-13-1-1
-
after pushing the branch, create and manage to merge the chef-repo
MR -
check the apply to staging
job if it tries to update only the changed role -
start the manual apply to prod
job -
after the job is finished execute: knife ssh -C 1 -afqdn 'roles:gitlab-runner-prm' -- 'sudo -i /root/runner_upgrade.sh' & time wait
-
-
next day (if no problems): to rest of the runners -
go to your local chef-repo
working directory and execute:knife ssh -afqdn 'roles:gitlab-runner-gsrm OR roles:gitlab-runner-srm OR roles:org-ci-base-runner' -- 'sudo -i systemctl stop chef-client' knife ssh -afqdn 'roles:gitlab-runner-gsrm OR roles:gitlab-runner-srm OR roles:org-ci-base-runner' -- 'sudo -i systemctl is-active chef-client' git checkout master && git pull git checkout -b update-runners-to-13-1-1
-
update version for gsrm/srm $EDITOR roles/gitlab-runner-base.json
In the role definition prepare the
gitlab-runner
entry:"cookbook-gitlab-runner": { "gitlab-runner": { "repository": "unstable", "version": "13.1.1" } }
-
update version for org-ci $EDITOR roles/org-ci-base-runner.json
In the role definition prepare the
gitlab-runner
entry:"cookbook-gitlab-runner": { "gitlab-runner": { "repository": "unstable", "version": "13.1.1" } }
-
remove overrides from prmX
runners$EDITOR roles/gitlab-runner-prm.json
-
git add roles/gitlab-runner-prm.json roles/gitlab-runner-base.json roles/org-ci-base-runner.json && git commit -m "Update runners to v13.1.1"
-
git push -u origin update-runners-to-13-1-1
-
after pushing the branch, create and manage to merge the chef-repo
MR -
check the apply to staging
job if it tries to update only the changed role -
start the manual apply to prod
job -
after the job is finished execute (we're not touching prmX
- they are already updated):knife ssh -C1 -afqdn 'roles:gitlab-runner-gsrm' -- 'sudo -i /root/runner_upgrade.sh' & knife ssh -C1 -afqdn 'roles:gitlab-runner-srm' -- 'sudo -i /root/runner_upgrade.sh' & knife ssh -C1 -afqdn 'roles:org-ci-base-runner' -- 'sudo -i /root/runner_upgrade.sh' & time wait
-
-