From 6c476a8dac8411f9a9d5a2cbf9ff088dc55369d9 Mon Sep 17 00:00:00 2001 From: Valery Sizov Date: Tue, 21 Oct 2014 12:04:09 +0300 Subject: [PATCH 1/3] Improved release documentation --- doc/release/monthly.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/doc/release/monthly.md b/doc/release/monthly.md index c46a3ed9c9..f972fd2036 100644 --- a/doc/release/monthly.md +++ b/doc/release/monthly.md @@ -11,7 +11,7 @@ NOTE: This is a guide for GitLab developers. A release manager is selected that coordinates the entire release of this version. The release manager has to make sure all the steps below are done and delegated where necessary. This person should also make sure this document is kept up to date and issues are created and updated. ### **3. Create an overall issue** -Name it "Release x.x.x" for easier searching. +Create issue for GitLab CE project(internal). Name it "Release x.x.x" for easier searching. ``` 15th: @@ -156,6 +156,12 @@ Create an annotated tag that points to the version change commit: git tag -a vx.x.0.rc1 -m 'Version x.x.0.rc1' ``` +Tags should be created for both GitLab CE and GitLab EE. Don't forget to push tags to all remotes. + +``` +git push remote_name vx.x.0.rc1 +``` + ### **6. Create stable branches** For GitLab EE, append `-ee` to the branch. From 6e9fb7facce76999b0a13fd676a701ea5580b76c Mon Sep 17 00:00:00 2001 From: Sytse Sijbrandij Date: Thu, 23 Oct 2014 16:24:44 +0200 Subject: [PATCH 2/3] Added relative dates, removed packages for GitLab.com. --- doc/release/monthly.md | 46 ++++++++++++++---------------------------- 1 file changed, 15 insertions(+), 31 deletions(-) diff --git a/doc/release/monthly.md b/doc/release/monthly.md index f972fd2036..36fc0b1dea 100644 --- a/doc/release/monthly.md +++ b/doc/release/monthly.md @@ -2,7 +2,7 @@ NOTE: This is a guide for GitLab developers. -# **15th - Code Freeze & Release Manager** +# **7 workdays before release - Code Freeze & Release Manager** ### **1. Stop merging in code, except for important bugfixes** @@ -12,30 +12,31 @@ A release manager is selected that coordinates the entire release of this versio ### **3. Create an overall issue** Create issue for GitLab CE project(internal). Name it "Release x.x.x" for easier searching. +Replace the dates with actual dates based on the number of workdays before the release. ``` -15th: +Xth: * Update the changelog (#LINK) * Triage the omnibus-gitlab milestone -16th: +Xth: * Merge CE in to EE (#LINK) * Close the omnibus-gitlab milestone -17th: +Xth: * Create x.x.0.rc1 (#LINK) * Build package for GitLab.com (https://dev.gitlab.org/cookbooks/chef-repo/blob/master/doc/administration.md#build-a-package) -18th: +Xth: * Update GitLab.com with rc1 (#LINK) (https://dev.gitlab.org/cookbooks/chef-repo/blob/master/doc/administration.md#deploy-the-package) * Regression issue and tweet about rc1 (#LINK) * Start blog post (#LINK) -21th: +Xth: * Do QA and fix anything coming out of it (#LINK) @@ -43,13 +44,10 @@ Create issue for GitLab CE project(internal). Name it "Release x.x.x" for easier * Release CE and EE (#LINK) -23rd: +Xth: -* Prepare package for GitLab.com release (#LINK) +* * Deploy to GitLab.com (#LINK) -24th: - -* Deploy to GitLab.com (#LINK) ``` ### **4. Update Changelog** @@ -60,11 +58,11 @@ Any changes not yet added to the changelog are added by lead developer and in th Ensure that there is enough time to incorporate the findings of the release candidate, etc. -# **16th - Merge the CE into EE** +# **6 workdays before release- Merge the CE into EE** Do this via a merge request. -# **17th - Create RC1** +# **5 workdays before release - Create RC1** The RC1 release comes with the task to update the installation and upgrade docs. Be mindful that there might already be merge requests for this on GitLab or GitHub. @@ -179,7 +177,7 @@ Now developers can use master for merging new features. So you should use stable branch for future code chages related to release. -# **18th - Release RC1** +# **4 workdays before release - Release RC1** ### **1. Update GitLab.com** @@ -217,7 +215,7 @@ Tweet about the RC release: > GitLab x.x.0.rc1 is out. This release candidate is only suitable for testing. Please link regressions issues from LINK_TO_REGRESSION_ISSUE -# **21st - Preparation** +# **1 workdays before release - Preparation** ### **1. Pre QA merge** @@ -309,22 +307,8 @@ List the most important features and link to the blog post. Proposed tweet for CE "GitLab X.X is released! It brings *** " -### **10. Send out the newsletter** +# **1 workday after release - Update GitLab.com** -Send out an email to the 'GitLab Newsletter' mailing list on MailChimp. -Replicate the former release newsletter and modify it accordingly. -**Do not forget to edit `Subject line` and regenerate `Plain-Text Email` from HTML source** - -Include a link to the blog post and keep it short. - -Proposed email text: -"We have released a new version of GitLab. See our blog post() for more information." - - -# **23rd - Optional Patch Release** - -# **24th - Update GitLab.com** - -Merge the stable release into GitLab.com. Once the build is green deploy the next morning. +Update GitLab.com from RC1 to the released package. # **25th - Release GitLab CI** From fd44d0b6c23443cc899316926e4f8a3a9d9ad032 Mon Sep 17 00:00:00 2001 From: Valery Sizov Date: Mon, 27 Oct 2014 16:02:21 +0200 Subject: [PATCH 3/3] update release doc --- doc/release/monthly.md | 25 +++++++++++++++++++++---- 1 file changed, 21 insertions(+), 4 deletions(-) diff --git a/doc/release/monthly.md b/doc/release/monthly.md index 36fc0b1dea..b9b4b0082d 100644 --- a/doc/release/monthly.md +++ b/doc/release/monthly.md @@ -11,6 +11,7 @@ NOTE: This is a guide for GitLab developers. A release manager is selected that coordinates the entire release of this version. The release manager has to make sure all the steps below are done and delegated where necessary. This person should also make sure this document is kept up to date and issues are created and updated. ### **3. Create an overall issue** + Create issue for GitLab CE project(internal). Name it "Release x.x.x" for easier searching. Replace the dates with actual dates based on the number of workdays before the release. @@ -179,7 +180,11 @@ So you should use stable branch for future code chages related to release. # **4 workdays before release - Release RC1** -### **1. Update GitLab.com** +### **1. Determine QA person + +Notify person of QA day. + +### **2. Update GitLab.com** Merge the RC1 EE code into GitLab.com. Once the build is green, create a package. @@ -187,18 +192,19 @@ If there are big database migrations consider testing them with the production d Try to deploy in the morning. It is important to do this as soon as possible, so we can catch any errors before we release the full version. -### **2. Prepare the blog post** +### **3. Prepare the blog post** - Start with a complete copy of the [release blog template](https://gitlab.com/gitlab-com/www-gitlab-com/blob/master/doc/release_blog_template.md) and fill it out. - Check the changelog of CE and EE for important changes. - Create a WIP MR for the blog post - Ask Dmitriy to add screenshots to the WIP MR. -- Decide with team who will be the MVP user. +- Decide with team who will be the MVP user. +- Create WIP MR for adding MVP to MVP page on website - Add a note if there are security fixes: This release fixes an important security issue and we advise everyone to upgrade as soon as possible. - Assign to one reviewer who will fix spelling issues by editing the branch (can use the online editor) - After the reviewer is finished the whole team will be mentioned to give their suggestions via line comments -### **3. Create a regressions issue** +### **4. Create a regressions issue** On [the GitLab CE issue tracker on GitLab.com](https://gitlab.com/gitlab-org/gitlab-ce/issues/) create an issue titled "GitLab X.X regressions" add the following text: @@ -312,3 +318,14 @@ Proposed tweet for CE "GitLab X.X is released! It brings *** " Update GitLab.com from RC1 to the released package. # **25th - Release GitLab CI** + +- Create the update guid `doc/x.x-to-x.x.md`. +- Update CHANGELOG +- Bump version +- Create annotated tags `git tag -a vx.x.0 -m 'Version x.x.0' xxxxx` +- Create stable branch `x-x-stable` +- Create GitHub release post +- Post to blog about release +- Post to twitter + +