granicus.if.org Git - icinga2/blob - RELEASE.md

   1 # Quality Assurance
   2
   3 Review and test the changes and issues for this version.
   4 https://dev.icinga.org/projects/i2/roadmap
   5
   6 # Release Workflow
   7
   8 ## Authors
   9
  10 Update the [.mailmap](.mailmap) and [AUTHORS](AUTHORS) files:
  11
  12     $ git log --use-mailmap | grep ^Author: | cut -f2- -d' ' | sort | uniq > AUTHORS
  13
  14 ## Version
  15
  16 Update the version number in the following files:
  17
  18 * [icinga2.spec]: Version: (.*)
  19 * [icinga2.nuspec]: <version>(.*)</version>
  20 * [tools/chocolateyInstall.ps1]: Icinga2-v(.*).exe
  21
  22 ## Changelog
  23
  24 Update the [ChangeLog](ChangeLog), [doc/1-about.md](doc/1-about.md) files using
  25 the changelog.py script. Also generate HTML for the wordpress release announcement.
  26
  27 Changelog:
  28
  29     $ ./changelog.py --version 2.3.5 --project i2
  30
  31 Docs:
  32
  33     $ ./changelog.py --version 2.3.5 --project i2 --links
  34
  35 Wordpress:
  36
  37     $ ./changelog.py --version 2.3.5 --project i2 --html --links
  38
  39 ## Git Tag
  40
  41 Commit these changes to the "master" branch:
  42
  43     $ git commit -v -a -m "Release version <VERSION>"
  44
  45 For minor releases: Cherry-pick this commit into the "support" branch.
  46
  47 Create a signed tag (tags/v<VERSION>) on the "master" branch (for major
  48 releases) or the "support" branch (for minor releases).
  49
  50 GB:
  51
  52     $ git tag -u EE8E0720 -m "Version <VERSION>" v<VERSION>
  53
  54 MF:
  55
  56     $ git tag -u D14A1F16 -m "Version <VERSION>" v<VERSION>
  57
  58 Push the tag.
  59
  60     $ git push --tags
  61
  62 For major releases: Create a new "support" branch:
  63
  64     $ git checkout master
  65     $ git checkout -b support/2.3
  66     $ git push -u origin support/2.3
  67
  68 For minor releases: Push the support branch and cherry-pick the release commit into master:
  69
  70     $ git push -u origin support/2.3
  71     $ git checkout master
  72     $ git cherry-pick support/2.3
  73     $ git push origin master
  74
  75 # External Dependencies
  76
  77 ## Build Server
  78
  79 ### Linux
  80
  81 * Build the newly created git tag for Debian/RHEL/SuSE.
  82 * Provision the vagrant boxes and test the release packages.
  83 * Start a new docker container and install/run icinga2
  84
  85 Example for CentOS7:
  86
  87     $ sudo docker run -ti centos:latest bash
  88
  89     # yum -y install http://packages.icinga.org/epel/7/release/noarch/icinga-rpm-release-7-1.el7.centos.noarch.rpm
  90     # yum -y install icinga2
  91     # icinga2 daemon -C
  92
  93     # systemctl start icinga2
  94     # tail -f /var/log/icinga2/icinga2.log
  95
  96 ### Windows
  97
  98 * Build the newly created git tag for Windows.
  99 * Test the [setup wizard](http://packages.icinga.org/windows/) inside a Windows VM.
 100
 101 ## Github Release
 102
 103 Create a new release from the newly created git tag.
 104 https://github.com/Icinga/icinga2/releases
 105
 106 ## Online Documentation
 107
 108 Ssh into the web box, navigate into `icinga2-latest/module/icinga2`
 109 and pull the current icinga2 revision to update what's new".
 110
 111 ## Announcement
 112
 113 * Create a new blog post on www.icinga.org/blog
 114 * Send announcement mail to icinga-announce@lists.icinga.org
 115 * Social media: [Twitter](https://twitter.com/icinga), [Facebook](https://www.facebook.com/icinga), [G+](http://plus.google.com/+icinga), [Xing](https://www.xing.com/communities/groups/icinga-da4b-1060043), [LinkedIn](https://www.linkedin.com/groups/Icinga-1921830/about)