How To Release

Prerequisites

Check Build Status

Make sure all builds and CI pipelines are green.

• naemon-core / ci pipeline
• naemon-livestatus / ci pipeline
• naemon-vimcrypt

Create Releases

Naemon Core

1. Create release commit:

   %> # git clone https://github.com/naemon/naemon-core
   %> cd naemon-core
   %> git pull
   %> make clean
   %> make version
   %> vim NEWS
   %> git commit -avs -m "release v<VERSION>"
   %> git tag "v<VERSION>"
   %> git push
   %> git push --tags

2. Wait for pipeline actions on GitHub.

3. Then create release on naemon core releases.

   Use the tag name as title and the news entry as description.

4. Update OSB Builds

   %> # osc checkout "home:naemon"
   %> cd home:naemon/naemon-core
   %> osc up
   %> vim _service # replace version number
   %> osc commit

5. Wait for builds to complete on build.opensuse.org/home:naemon.

Naemon Livestatus

1. Create release commit:

   %> # git clone https://github.com/naemon/naemon-livestatus
   %> cd naemon-core
   %> git pull
   %> make clean
   %> make version
   %> git commit -avs -m "release v<VERSION>"
   %> git tag "v<VERSION>"
   %> git push
   %> git push --tags

2. Wait for pipeline actions on GitHub.

3. Then create release on naemon livestatus releases.

   Use the tag name as title and the news entry as description.

4. Update OSB Builds

   %> # osc checkout "home:naemon"
   %> cd home:naemon/naemon-livestatus
   %> osc up
   %> vim _service # replace version number
   %> osc commit

5. Wait for builds to complete on build.opensuse.org/home:naemon.

Naemon Vim Vault

1. Create release commit:

   %> # git clone https://github.com/naemon/naemon-vimcrypt-vault-broker
   %> cd naemon-vimcrypt-vault-broker
   %> git pull
   %> make clean
   %> make version
   %> git commit -avs -m "release v<VERSION>"
   %> git tag "v<VERSION>"
   %> git push
   %> git push --tags

2. Then create release on naemon vimvault releases.

   Use the tag name as title and the news entry as description.

3. Update OSB Builds

   %> # osc checkout "home:naemon"
   %> cd home:naemon/naemon-vimvault
   %> osc up
   %> vim _service # replace version number
   %> osc commit

4. Wait for builds to complete on build.opensuse.org/home:naemon.

Naemon Meta Package

1. Create release commit:

   %> # git clone https://github.com/naemon/naemon
   %> cd naemon
   %> git pull
   %> make clean
   %> make version
   %> git commit -avs -m "release v<VERSION>"
   %> git tag "v<VERSION>"
   %> git push
   %> git push --tags

2. Wait for pipeline actions on GitHub.

3. Then create release on naemon releases.

   Just use the auto-generate button.

4. Update OSB Builds

   %> # osc checkout "home:naemon"
   %> cd home:naemon/naemon
   %> osc up
   %> vim _service # replace version number
   %> osc commit

5. Wait for builds to complete on build.opensuse.org/home:naemon.

naemon.io

1. Create release update:

   %> # git clone github.com/naemon/naemon.github.io
   %> cd naemon.github.io
   %> git pull
   %> vim src/.env                                 # adjust date and version
   %> vim src/download.md                          # double check available distributions
   %> vim src/documentation/usersguide/whatsnew.md # add changelog entry
   %> vim src/news/<date>-release-<v>.md           # add news entry
   %> git commit -avs -m "release v<VERSION>"
   %> git push

Socialize

Communicate the release on various channels:

• mastodon

Other

If there had been API changes, 3rd party NEB modules have to be rebuild, ex.:

• mod-gearman neb module
• status engine