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 Update the [.mailmap](.mailmap) and [AUTHORS](AUTHORS) files:
   9
  10     $ git log --use-mailmap | grep ^Author: | cut -f2- -d' ' | sort | uniq > AUTHORS
  11
  12 Update the version number in the icinga2.spec file.
  13
  14 Update the [ChangeLog](ChangeLog), [doc/1-about.md](doc/1-about.md) files using
  15 the changelog.py script.
  16
  17 Changelog:
  18
  19     $ ./changelog.py --version 2.3.5 --project i2
  20
  21 Docs:
  22
  23     $ ./changelog.py --version 2.3.5 --project i2 --links
  24
  25 Wordpress:
  26
  27     $ ./changelog.py --version 2.3.5 --project i2 --html --links
  28
  29 Commit these changes to the "master" branch:
  30
  31     $ git commit -v -a -m "Release version <VERSION>"
  32
  33 For minor releases: Cherry-pick this commit into the "support" branch.
  34
  35 Create a signed tag (tags/v<VERSION>) on the "master" branch (for major
  36 releases) or the "support" branch (for minor releases).
  37
  38 GB:
  39
  40     $ git tag -u EE8E0720 -m "Version <VERSION>" v<VERSION>
  41
  42 MF:
  43
  44     $ git tag -u D14A1F16 -m "Version <VERSION>" v<VERSION>
  45
  46 Push the tag.
  47
  48     $ git push --tags
  49
  50 For major releases: Create a new "support" branch:
  51
  52     $ git checkout master
  53     $ git checkout -b support/2.x
  54     $ git push -u origin support/2.x
  55
  56 # External Dependencies
  57
  58 ## Build Server
  59
  60 ### Linux
  61
  62 * Build the newly created git tag for Debian/RHEL/SuSE.
  63 * Provision the vagrant boxes and test the release packages.
  64 * Start a new docker container and install/run icinga2
  65
  66 Example for CentOS7:
  67
  68     $ sudo docker run -ti centos:latest bash
  69     # yum -y install http://packages.icinga.org/epel/7/release/noarch/icinga-rpm-release-7-1.el7.centos.noarch.rpm
  70     # yum -y install icinga
  71     # systemctl start icinga2
  72     # tail -f /var/log/icinga2/icinga2.log
  73
  74 ### Windows
  75
  76 * Build the newly created git tag for Windows.
  77 * Test the [setup wizard](http://packages.icinga.org/windows/) inside a Windows VM.
  78
  79 ## Github Release
  80
  81 Create a new release from the newly created git tag.
  82 https://github.com/Icinga/icinga2/releases
  83
  84 ## Online Documentation
  85
  86 Ssh into the web box, navigate into `icinga2-latest/module/icinga2`
  87 and pull the current icinga2 revision to update what's new".
  88
  89 ## Announcement
  90
  91 * Create a new blog post on www.icinga.org/blog
  92 * Send announcement mail to icinga-announce@lists.icinga.org
  93 * 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)