2013-11-14 13:40:05 -05:00
# Things to do when creating new monthly minor or major release
2013-10-15 05:51:56 -04:00
NOTE: This is a guide for GitLab developers. If you are trying to install GitLab see the latest stable [installation guide ](install/installation.md ) and if you are trying to upgrade, see the [upgrade guides ](update ).
2013-05-27 03:21:01 -04:00
## Install guide up to date?
* References correct GitLab branch `x-x-stable` and correct GitLab shell tag?
## Make upgrade guide
### From x.x to x.x
2013-07-29 06:46:00 -04:00
#### 0. Any major changes? Database updates? Web server change? File structure changes?
2013-05-27 03:21:01 -04:00
#### 1. Make backup
#### 2. Stop server
#### 3. Do users need to update dependencies like `git`?
#### 4. Get latest code
#### 5. Does GitLab shell need to be updated?
#### 6. Install libs, migrations, etc.
#### 7. Any config files updated since last release?
Check if any of these changed since last release (~22nd of last month depending on when last release branch was created):
* https://github.com/gitlabhq/gitlabhq/commits/master/lib/support/nginx/gitlab
* https://github.com/gitlabhq/gitlab-shell/commits/master/config.yml.example
* https://github.com/gitlabhq/gitlabhq/commits/master/config/gitlab.yml.example
2013-08-19 15:54:12 -04:00
* https://github.com/gitlabhq/gitlabhq/commits/master/config/unicorn.rb.example
2013-05-27 03:21:01 -04:00
* https://github.com/gitlabhq/gitlabhq/commits/master/config/database.yml.mysql
* https://github.com/gitlabhq/gitlabhq/commits/master/config/database.yml.postgresql
#### 8. Need to update init script?
Check if changed since last release (~22nd of last month depending on when last release branch was created): https://github.com/gitlabhq/gitlabhq/commits/master/lib/support/init.d/gitlab
#### 9. Start application
#### 10. Check application status
2013-10-15 05:51:56 -04:00
## Make sure the code quality indicatiors are good
2013-05-27 03:21:01 -04:00
* [](http://ci.gitlab.org/projects/1?ref=master) on ci.gitlab.org (master branch)
* [](https://travis-ci.org/gitlabhq/gitlabhq) on travis-ci.org (master branch)
* [](https://codeclimate.com/github/gitlabhq/gitlabhq)
* [](https://gemnasium.com/gitlabhq/gitlabhq) this button can be yellow (small updates are available) but must not be red (a security fix or an important update is available)
* [](https://coveralls.io/r/gitlabhq/gitlabhq)
2013-10-15 05:51:56 -04:00
## Make a release branch
After making the release branch new commits are cherry-picked from master. When the release gets closer we get more selective what is cherry-picked.
2013-10-29 19:46:42 -04:00
* 5 days before release: feature freeze
* 3 days before release: UI freeze
* 1 day before release: code freeze
# Write a blog post
* Mention what GitLab is on the second line: GitLab is open source software to collaborate on code.
* Select and thank the the Most Valuable Person (MVP) of this release.
* Note if there are security fixes: This release fixes an important security issue and we advise everyone to upgrade as soon as possible.
2013-10-15 05:51:56 -04:00
## Last actions
1. Update VERSION and CHANGELOG
1. Create a git tag vX.X.X
1. Publish the blog post
1. Tweet about the release
