From 0b85e2a606d0fba63a72541e60fadcea84c123a6 Mon Sep 17 00:00:00 2001 From: Marin Jankovski Date: Mon, 15 Sep 2014 12:01:30 +0200 Subject: [PATCH 1/5] Order of tasks in monthly release doc. --- doc/release/monthly.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/doc/release/monthly.md b/doc/release/monthly.md index 6622b10cea..7a23ed1afc 100644 --- a/doc/release/monthly.md +++ b/doc/release/monthly.md @@ -10,11 +10,8 @@ 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. Update Changelog** - -Any changes not yet added to the changelog are added by lead developer and in that merge request the complete team is asked if there is anything missing. - -### **4. Create an overall issue** +### **3. Create an overall issue** +Name it "Release x.x.x" for easier searching. ``` 15th: @@ -54,6 +51,10 @@ Any changes not yet added to the changelog are added by lead developer and in th * Deploy to GitLab.com (#LINK) ``` +### **4. Update Changelog** + +Any changes not yet added to the changelog are added by lead developer and in that merge request the complete team is asked if there is anything missing. + # **16th - Merge the CE into EE** Do this via a merge request. From 3a9c294ac0c7e61a6b96c9be3dd757fea49e07db Mon Sep 17 00:00:00 2001 From: Marin Jankovski Date: Tue, 16 Sep 2014 13:40:58 +0200 Subject: [PATCH 2/5] Add steps for building and deploying gitlab.com packages to monthly release document. --- doc/release/monthly.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/release/monthly.md b/doc/release/monthly.md index 7a23ed1afc..0191a37259 100644 --- a/doc/release/monthly.md +++ b/doc/release/monthly.md @@ -27,10 +27,11 @@ Name it "Release x.x.x" for easier searching. 17th: * 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: -* Update GitLab.com with rc1 (#LINK) +* 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) From 68bb1701cdf879143a80338eb172049f9cb7f2fd Mon Sep 17 00:00:00 2001 From: Marin Jankovski Date: Thu, 18 Sep 2014 09:40:02 +0200 Subject: [PATCH 3/5] Update monthly release doc that we are not using travis anymore. --- doc/release/monthly.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/release/monthly.md b/doc/release/monthly.md index 0191a37259..a33f328d89 100644 --- a/doc/release/monthly.md +++ b/doc/release/monthly.md @@ -130,9 +130,9 @@ Check if the `init.d/gitlab` script changed since last release: Date: Fri, 19 Sep 2014 10:40:18 +0200 Subject: [PATCH 4/5] Issue name of QA. --- doc/release/monthly.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/release/monthly.md b/doc/release/monthly.md index a33f328d89..14b8f85163 100644 --- a/doc/release/monthly.md +++ b/doc/release/monthly.md @@ -215,7 +215,7 @@ Merge CE into EE before doing the QA. ### **2. QA** -Create issue on dev.gitlab.org `gitlab` repository, named "GitLab X.X release" in order to keep track of the progress. +Create issue on dev.gitlab.org `gitlab` repository, named "GitLab X.X QA" in order to keep track of the progress. Use the omnibus packages of Enterprise Edition using [this guide](https://dev.gitlab.org/gitlab/gitlab-ee/blob/master/doc/release/manual_testing.md). From c108839cb9787b3e08afe12cad8d3f4adf24eccc Mon Sep 17 00:00:00 2001 From: Marin Jankovski Date: Mon, 22 Sep 2014 17:26:18 +0200 Subject: [PATCH 5/5] More updates to release doc. --- doc/release/monthly.md | 54 +++++++++++++++++++++++------------------- 1 file changed, 30 insertions(+), 24 deletions(-) diff --git a/doc/release/monthly.md b/doc/release/monthly.md index 14b8f85163..b4dbfcd610 100644 --- a/doc/release/monthly.md +++ b/doc/release/monthly.md @@ -165,7 +165,7 @@ git checkout -b x-x-stable git push x-x-stable ``` -Now developers can use master for merging new features. +Now developers can use master for merging new features. So you should use stable branch for future code chages related to release. @@ -239,17 +239,26 @@ Note: Merge CE into EE if needed. - Change the GITLAB_SHELL_VERSION file in `master` of the CE repository if the version changed. - Change the GITLAB_SHELL_VERSION file in `master` of the EE repository if the version changed. -- Change the VERSION file in `master` branch of the CE repository and commit and push. -- Change the VERSION file in `master` branch of the EE repository and commit and push. +- Change the VERSION file in `master` branch of the CE repository and commit and push to origin. +- Change the VERSION file in `master` branch of the EE repository and commit and push to origin. -### **2. Push latest changes from x-x-stable branch to the repositories** +### **2. Update installation.md** + +Update [installation.md](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/install/installation.md) to the newest version in master. + +### **3. Push latest changes from x-x-stable branch to dev.gitlab.org** ``` git checkout -b x-x-stable -git push x-x-stable +git push origin x-x-stable ``` -### **3. Create annotated tag vx.x.x** +### **4. Build the Omnibus packages** + +Follow the [release doc in the Omnibus repository](https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/release.md). +This can happen before tagging because Omnibus uses tags in its own repo and SHA1's to refer to the GitLab codebase. + +### **5. Create annotated tag vx.x.x** In `x-x-stable` branch check for the SHA-1 of the commit with VERSION file changed. Tag that commit, @@ -259,18 +268,7 @@ git tag -a vx.x.0 -m 'Version x.x.0' xxxxx where `xxxxx` is SHA-1. -### **4. Push the tag** - -``` -git push origin vx.x.0 -``` - -### **5. Build the Omnibus packages** - -Follow the [release doc in the Omnibus repository](https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/release.md). -This can happen before tagging because Omnibus uses tags in its own repo and SHA1's to refer to the GitLab codebase. - -### **6. Push to remotes** +### **6. Push the tag and x-x-stable branch to the remotes** For GitLab CE, push to dev, GitLab.com and GitHub. @@ -278,29 +276,37 @@ For GitLab EE, push to the subscribers repo. Make sure the branch is marked 'protected' on each of the remotes you pushed to. -### **7. Publish blog for new release** +``` +git push x-x-stable(-ee) +git push vx.x.0 +``` + +### **7. Publish packages for new release** + +Update `downloads/index.html` and `downloads/archive/index.html` in `www-gitlab-com` repository. + +### **8. Publish blog for new release** Merge the [blog merge request](#1-prepare-the-blog-post) in `www-gitlab-com` repository. -### **8. Tweet to blog** +### **9. Tweet to blog** Send out a tweet to share the good news with the world. List the most important features and link to the blog post. Proposed tweet for CE "GitLab X.X is released! It brings *** " -### **9. Send out the newsletter** +### **10. Send out the newsletter** 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." -### **10. Update installation.md** - -Update [installation.md](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/install/installation.md) to the newest version in master and cherry-pick that commit into the stable branch. # **23rd - Optional Patch Release**