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

   1 # Release Workflow
   2
   3 Specify the release version.
   4
   5     VERSION=2.7.0
   6
   7 ## Issues
   8
   9 Check issues at https://github.com/Icinga/icinga2
  10
  11 ## Backport Commits
  12
  13 For minor versions you need to manually backports any and all commits from the
  14 master branch which should be part of this release.
  15
  16 ## Authors
  17
  18 Update the [.mailmap](.mailmap) and [AUTHORS](AUTHORS) files:
  19
  20     $ git checkout master
  21     $ git log --use-mailmap | grep ^Author: | cut -f2- -d' ' | sort | uniq > AUTHORS
  22
  23 ## Version
  24
  25 Update the version number in the following file:
  26
  27 * [icinga2.spec]: Version: (.*)
  28
  29 Example:
  30
  31     gsed -i "s/Version: .*/Version: $VERSION/g" icinga2.spec
  32
  33 ## Changelog
  34
  35 Update the [CHANGELOG.md](CHANGELOG.md) file.
  36
  37 ## Git Tag
  38
  39 Commit these changes to the "master" branch:
  40
  41     $ git commit -v -a -m "Release version $VERSION"
  42
  43 For minor releases: Cherry-pick this commit into the "support" branch.
  44
  45 Create a signed tag (tags/v<VERSION>) on the "master" branch (for major
  46 releases) or the "support" branch (for minor releases).
  47
  48 GB:
  49
  50     $ git tag -u EE8E0720 -m "Version $VERSION" v$VERSION
  51
  52 MF:
  53
  54     $ git tag -u D14A1F16 -m "Version $VERSION" v$VERSION
  55
  56 Push the tag.
  57
  58     $ git push --tags
  59
  60 For major releases: Create a new "support" branch:
  61
  62     $ git checkout master
  63     $ git checkout -b support/2.7
  64     $ git push -u origin support/2.7
  65
  66 For minor releases: Push the support branch, cherry-pick the release commit
  67 into master and merge the support branch:
  68
  69     $ git push -u origin support/2.7
  70     $ git checkout master
  71     $ git cherry-pick support/2.7
  72     $ git merge --strategy=ours support/2.7
  73     $ git push origin master
  74
  75 # External Dependencies
  76
  77 ## Build Server
  78
  79 * Verify package build changes for this version.
  80 * Test the snapshot packages for all distributions beforehand.
  81 * Build the newly created Git tag for Debian/RHEL/SuSE.
  82 * Build the newly created Git tag for Windows.
  83
  84 ## Release Tests
  85
  86 * Test DB IDO with MySQL and PostgreSQL.
  87 * Provision the vagrant boxes and test the release packages.
  88 * Test the [setup wizard](https://packages.icinga.com/windows/) inside a Windows VM.
  89
  90 * Start a new docker container and install/run icinga2.
  91
  92 Example for CentOS7:
  93
  94     $ docker run -ti centos:latest bash
  95
  96     # yum -y install https://packages.icinga.com/epel/7/release/noarch/icinga-rpm-release-7-2.el7.centos.noarch.rpm
  97     # yum -y install icinga2
  98     # icinga2 daemon -C
  99
 100     # systemctl start icinga2
 101     # tail -f /var/log/icinga2/icinga2.log
 102
 103 ## GitHub Release
 104
 105 Create a new release for the newly created Git tag.
 106 https://github.com/Icinga/icinga2/releases
 107
 108 ## Chocolatey
 109
 110 Navigate to the git repository on your Windows box which
 111 already has chocolatey installed. Pull/checkout the release.
 112
 113 Create the nupkg package:
 114
 115     cpack
 116
 117 Install the created icinga2 package locally:
 118
 119     choco install icinga2 -version 2.7.0 -fdv "%cd%" -source "'%cd%;https://chocolatey.org/api/v2/'"
 120
 121 Upload the package to [chocolatey](https://chocolatey.org/packages/upload).
 122
 123 ## Online Documentation
 124
 125 SSH into the web box, navigate into `icinga2-latest/module/icinga2`
 126 and pull the current support branch.
 127
 128 ## Announcement
 129
 130 * Create a new blog post on www.icinga.com/blog
 131 * Send announcement mail to icinga-announce@lists.icinga.org
 132 * Social media: [Twitter](https://twitter.com/icinga), [Facebook](https://www.facebook.com/icinga), [G+](https://plus.google.com/+icinga), [Xing](https://www.xing.com/communities/groups/icinga-da4b-1060043), [LinkedIn](https://www.linkedin.com/groups/Icinga-1921830/about)
 133 * Update IRC channel topic
 134
 135 # After the release
 136
 137 * Add new minor version on [GitHub](https://github.com/Icinga/icinga2/milestones).
 138 * Close the released version on [GitHub](https://github.com/Icinga/icinga2/milestones).