GitLab Runner 10.0 release checklist

GitLab Runner Release manager: @tmaczukin

Release blog post MR: gitlab-com/www-gitlab-com!7022

Runner entries need to be added to blog post until: 2017-09-14

Before 7th

• chose a release manager
• link release blog post's MR
• set a proper date for BLOG_POST_DEADLINE_HERE
• Update the X.Y. and X-Y- to a specific release version
• Add the release label to the issue
• Add the %10.0 milestone to the issue

First working day after 7th - v10.0.0-rc.1 release

• check if Pipeline for master is passing:
  • add all required fixes to make master Pipeline passing
• add v10.0.0-rc.1 CHANGELOG entries
  • add the note in CHANGELOG about change in default behavior of gitlab-runner register (https://gitlab.com/gitlab-org/gitlab-runner/issues/2615#note_35892362)
• tag and push v10.0.0-rc.1
• create and push 10-0-stable branch
• checkout to master, update VERSION file to 10.1.0 and push master
• deploy v10.0.0-rc.1 (https://gitlab.com/gitlab-com/runbooks/blob/master/howto/update-gitlab-runner-on-managers.md)

New features window is closed - things not merged into master up to this day, will be released with next release.

7 working days before 22th (2017-09-14)

• add entries to release blog post

  • add note about changing GitLab Runner's repository path to https://gitlab.com/gitlab-org/gitlab-runner
  • add deprecation note about docker-ssh and docker-ssh+machine executors (#2732 (closed))
  • add deprecation note about exec and service management commands (#2710 (closed))
  • add note about change in default behavior of gitlab-runner register (https://gitlab.com/gitlab-org/gitlab-runner/issues/2615#note_35892362)
  • add release entry:

  Add description to the SECONDARY FEATURES list using following template:

  - name: GitLab Runner 10.0
    available_in: [ce, ees, eep]
    documentation_link: 'https://docs.gitlab.com/runner'
    documentation_text: "Read through the documentation on GitLab Runner"
    description: |
      We're also releasing GitLab Runner 10.0 today!
  
      ##### Most interesting changes:
  
      * __Title__ ([merge request](https://gitlab.com/gitlab-org/gitlab-runner/merge_requests/__ID__))
  
      List of all changes can be found in GitLab Runner's [CHANGELOG](https://gitlab.com/gitlab-org/gitlab-runner/blob/v10.0.0/CHANGELOG.md).

At 20th - next RC release

At this day we should release an RC version, if there was no RC recently - especially if the only RC version was the RC1 released near 7th day of month.

• check if Pipeline for 10-0-stable is passing:
  • add all required fixes to make 10-0-stable Pipeline passing
• add v10.0.0-rc.Z CHANGELOG entries
• tag v10.0.0-rc.Z
• deploy v10.0.0-rc.Z (https://gitlab.com/gitlab-com/runbooks/blob/master/howto/update-gitlab-runner-on-managers.md)

At 22th - the release day

• Before 12:00 UTC
  • add last entries to changelog
  • merge all RC.x CHANGELOG entries into release entry
  • tag v10.0.0 version
• Before 15:00 UTC
  • deploy stable version to all production Runners

RC release template

There should be at least one RC version between RC.1 and stable release. If there are any important changes merged into stable branch (like bug/security fixes) the RC should be prepared and deployed as soon as possible. For a less important changes (documentation, simple fixes of typos etc.) the RC can wait a little.

When deciding to release a new RC version, please update the checklist using the following template:

## At _day here_ - **v10.0.0-rc.Z** release

- [ ] check if Pipeline for `10-0-stable` is passing: [![pipeline status](https://gitlab.com/gitlab-org/gitlab-runner/badges/10-0-stable/pipeline.svg)](https://gitlab.com/gitlab-org/gitlab-runner/commits/10-0-stable)
    - [ ] add all required fixes to make `10-0-stable` Pipeline passing
- [ ] add **v10.0.0-rc.Z** CHANGELOG entries
- [ ] tag **v10.0.0-rc.Z**
- [ ] deploy **v10.0.0-rc.Z** (https://gitlab.com/gitlab-com/runbooks/blob/master/howto/update-gitlab-runner-on-managers.md)

/fyi @ayufan @nolith

changed the description

changed the description

changed the description

marked the checklist item check if Pipeline for master is passing: as completed

marked the checklist item add all required fixes to make master Pipeline passing as completed

marked the checklist item add all required fixes to make master Pipeline passing as incomplete

marked the checklist item check if Pipeline for master is passing: as incomplete

marked the checklist item add v10.0.0-rc.1 CHANGELOG entries as completed

marked the checklist item add the note in CHANGELOG about change in default behavior of gitlab-runner register (https://gitlab.com/gitlab-org/gitlab-runner/issues/2615#note_35892362) as completed

marked the checklist item check if Pipeline for master is passing: as completed

marked the checklist item add all required fixes to make master Pipeline passing as completed

marked the checklist item tag v10.0.0-rc.1 as completed

marked the checklist item create and push 10-0-stable branch as completed

changed the description

marked the checklist item checkout to master, update VERSION file to 10.1.0 and push master as completed

marked the checklist item add note about change in default behavior of gitlab-runner register (https://gitlab.com/gitlab-org/gitlab-runner/issues/2615#note_35892362) as completed

marked the checklist item add note about changing GitLab Runner's repository path to https://gitlab.com/gitlab-org/gitlab-runner as completed

marked the checklist item add deprecation note about docker-ssh and docker-ssh+machine executors (#2732 (closed)) as completed

marked the checklist item add deprecation note about exec and service management commands (#2710 (closed)) as completed

marked the checklist item add release entry: as completed

marked the checklist item add entries to release blog post as completed

marked the checklist item deploy v10.0.0-rc.1 (https://gitlab.com/gitlab-com/runbooks/blob/master/howto/update-gitlab-runner-on-managers.md) as completed

added Deliverable label

marked the checklist item add last entries to changelog as completed

marked the checklist item merge all RC.x CHANGELOG entries into release entry as completed

marked the checklist item tag v10.0.0 version as completed

@tmaczukin Is this done?

marked the checklist item Before 12:00 UTC as completed

changed the description

closed

removed Deliverable label