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

   1 # Release Workflow
   2
   3 Specify the release version.
   4
   5 ```
   6 VERSION=2.7.2
   7 ```
   8
   9 ## Issues
  10
  11 Check issues at https://github.com/Icinga/icinga2
  12
  13 ## Backport Commits
  14
  15 For minor versions you need to manually backports any and all commits from the
  16 master branch which should be part of this release.
  17
  18 ## Authors
  19
  20 Update the [.mailmap](.mailmap) and [AUTHORS](AUTHORS) files:
  21
  22 ```
  23 git checkout master
  24 git log --use-mailmap | grep '^Author:' | cut -f2- -d' ' | sort | uniq > AUTHORS
  25 ```
  26
  27 ## Version
  28
  29 Update the version in the spec file:
  30
  31 ```
  32 gsed -i "s/Version: .*/Version: $VERSION/g" icinga2.spec
  33 ```
  34
  35 ## Changelog
  36
  37 Update the [CHANGELOG.md](CHANGELOG.md) file.
  38
  39 Export these environment variables:
  40
  41 ```
  42 export ICINGA_GITHUB_AUTH_USERNAME='user'
  43 export ICINGA_GITHUB_AUTH_TOKEN='token'
  44 export ICINGA_GITHUB_PROJECT='icinga/icinga2'
  45 ```
  46
  47 Run the script which updates the [CHANGELOG.md](CHANGELOG.md) file.
  48
  49 ```
  50 ./changelog.py
  51 git diff
  52 ```
  53
  54 ## Git Tag
  55
  56 Commit these changes to the "master" branch:
  57
  58 ```
  59 git commit -v -a -m "Release version $VERSION"
  60 ```
  61
  62 For minor releases: Cherry-pick this commit into the "support" branch:
  63
  64 ```
  65 git checkout support/2.7
  66 git cherry-pick master
  67 ```
  68
  69 Create a signed tag (tags/v<VERSION>) on the "master" branch (for major
  70 releases) or the "support" branch (for minor releases).
  71
  72 GB:
  73
  74 ```
  75 git tag -u EE8E0720 -m "Version $VERSION" v$VERSION
  76 ```
  77
  78 MF:
  79
  80 ```
  81 git tag -u D14A1F16 -m "Version $VERSION" v$VERSION
  82 ```
  83
  84 NH:
  85
  86 ```
  87 git tag -u 630F89D9 -m "Version $VERSION" v$VERSION
  88 ```
  89
  90 Push the tag:
  91
  92 ```
  93 git push --tags
  94 ```
  95
  96 For major releases: Create a new "support" branch:
  97
  98 ```
  99 git checkout master
 100 git checkout -b support/2.7
 101 git push -u origin support/2.7
 102 ```
 103
 104 For minor releases: Push the support branch, cherry-pick the release commit
 105 into master and merge the support branch:
 106
 107 ```
 108 git push -u origin support/2.7
 109 git checkout master
 110 git cherry-pick support/2.7
 111 git merge --strategy=ours support/2.7
 112 git push origin master
 113 ```
 114
 115 # External Dependencies
 116
 117 ## Build Server
 118
 119 * Verify package build changes for this version.
 120 * Test the snapshot packages for all distributions beforehand.
 121 * Build the newly created Git tag for Debian/RHEL/SuSE.
 122 * Build the newly created Git tag for Windows.
 123
 124 ## Release Tests
 125
 126 * Test DB IDO with MySQL and PostgreSQL.
 127 * Provision the vagrant boxes and test the release packages.
 128 * Test the [setup wizard](https://packages.icinga.com/windows/) inside a Windows VM.
 129
 130 * Start a new docker container and install/run icinga2.
 131
 132 Example for CentOS7:
 133
 134 ```
 135 docker run -ti centos:latest bash
 136
 137 yum -y install https://packages.icinga.com/epel/icinga-rpm-release-7-latest.noarch.rpm
 138 yum -y install icinga2
 139 icinga2 daemon -C
 140 ```
 141
 142 ## GitHub Release
 143
 144 Create a new release for the newly created Git tag.
 145 https://github.com/Icinga/icinga2/releases
 146
 147 ## Chocolatey
 148
 149 Navigate to the git repository on your Windows box which
 150 already has chocolatey installed. Pull/checkout the release.
 151
 152 Create the nupkg package:
 153
 154 ```
 155 cpack
 156 ```
 157
 158 Install the created icinga2 package locally:
 159
 160 ```
 161 choco install icinga2 -version 2.7.0 -fdv "%cd%" -source "'%cd%;https://chocolatey.org/api/v2/'"
 162 ```
 163
 164 Upload the package to [chocolatey](https://chocolatey.org/packages/upload).
 165
 166 ## Online Documentation
 167
 168 Ask @bobapple to update the documentation at docs.icinga.com.
 169
 170 ## Announcement
 171
 172 * Create a new blog post on www.icinga.com/blog
 173 * 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)
 174 * Update IRC channel topic
 175
 176 # After the release
 177
 178 * Add new minor version on [GitHub](https://github.com/Icinga/icinga2/milestones).
 179 * Close the released version on [GitHub](https://github.com/Icinga/icinga2/milestones).