9.2. Release procedure

9.2.1. Requirements

Here is the requirements about release procedure.

  • Debian GNU/Linux (sid)

  • Use zsh as user shell

Use the following working directories.

  • MROONGA_DIR=$HOME/work/mroonga

  • MROONGA_CLONE_DIR=$HOME/work/mroonga/mroonga.clean

  • MROONGA_GITHUB_COM_PATH=$HOME/work/mroonga/mroonga.github.com

  • CUTTER_DIR=$HOME/work/cutter

  • CUTTER_SOURCE_PATH=$HOME/work/cutter/cutter

  • GROONGA_SOURCE_PATH=$HOME/work/groonga/groonga.clean

9.2.2. Setup build environment

Install the following packages:

% sudo apt-get install -V ruby mecab libmecab-dev gnupg2 dh-autoreconf python-sphinx bison

We use Vagrant for building deb or rpm packages and expect that Virtualbox package is already installed. If not, please install it in the following steps:

% cat /etc/apt/sources.list
deb http://ftp.jp.debian.org/debian/ sid main contrib
deb-src http://ftp.jp.debian.org/debian/ sid main contrib
% sudo apt-get update
% sudo apt-get install virtualbox

9.2.3. Bump version

Bump version to the latest release:


9.2.4. Describe the changes

Summarize recent changes since the previous release into doc/source/news.txt. This summary is also used in release note.

Execute the following command to collect change logs since the previous version:

% git log -p --reverse $(git tag | tail -1)..

Search the logs by ^commit, and pick up collect remarkable changes.

Should be included

  • The changes which affect to users

  • The changes which broke compatibility

Shoud not be included

  • The changes which doesn’t affect to users (Internal source code changes or refactoring)

9.2.5. Generate configure script

Because of master branch doesn’t include configure script, then it is required to generate configure script for building.

Execute autogen.sh with the following command:

% sh autogen.sh

It generates configure script.

9.2.6. Execute configure script

For generating Makefile, execute the configure script.

Execute with the following options for the release:

% ./configure \
    --enable-document \
    --prefix=/tmp/local \
    --with-launchpad-uploader-pgp-key=(Launchpadに登録したkeyID) \
    --with-mroonga-github-com-path=$MROONGA_GITHUB_COM_PATH \
    --with-cutter-source-path=$CUTTER_SOURCE_PATH \
    --with-groonga-source-path=$GROONGA_SOURCE_PATH \
    --with-mysql-source=(The directory of MySQL source code) \
    --with-mysql-build=(The build directory of MySQL) \
    --with-mysql-config=(The path to mysql_config command)

See Others for the details of --with-mysql-source option.

9.2.7. Check whether you can upload packages

Check whether you can login to packages.groonga.org as packages user.

You can check with the following command whether you can login:

% ssh packages@packages.groonga.org

If you can’t login to packages.groonga.org, you must be registered ssh public key.

9.2.8. Execute make update-latest-release

Execute make update-latest-release command with OLD_RELEASE_DATE, NEW_RELEASE_DATE.

When 9.09 release, we executed the following command:

% make update-latest-release OLD_RELEASE=9.09 OLD_RELEASE_DATE=2019-09-27 NEW_RELEASE_DATE=2019-10-30

This command updates some html files (which is used for web sites of Mroonga - index.html,ja/index.html) and the version of spec file or debian/changelog entry.

9.2.9. Tagging for release

Execute the following command for tagging:

% make tag
% git push --tags origin


After tagging for the release, execute configure script. This tag information is reflected when generating the documents.

9.2.10. Upload archive files

Then, create archive file (tar.gz) for distribution:

% make dist

Change working directory to packages/source:

% cd packages/source

Execute make download for syncing with the upstream:

% make download

Execute make archive for generating source archive:

% make archive

Execute make upload for uploading archive file:

% make upload

As a result, tar.gz archive file is available from http://packages.groonga.org/source/mroonga/.

9.2.11. Create packages for the release

Create Linux and Windows packages. Debian

Change working directory to apt:

% cd apt

Execute the following command:

% make download
% make build
% make upload

After uploading the packages, update sign/metadata. See Groonga’s release procedure about details. Debian derivatives(Ubuntu)

For Ubuntu, packages are provided by PPA on launchpad.net.

Change working directory to ubuntu and execute make upload command:

% cd packages/ubuntu
% make upload

When upload packages was succeeded, package build process is executed on launchpad.net. Then build result is notified via E-mail. You can install packages via Groonga PPA on launchpad.net:

* https://launchpad.net/~groonga/+archive/ubuntu/ppa Red Hat derivatives

Change working directory to yum

% cd apt

Execute the following command:

% make download
% make build
% make upload

After uploading the packages, update sign/metadata. See Groonga’s release procedure about details. Windows

For windows packages, we use AppVeyor CI artifacts files.

9.2.12. Upload documents

  1. Clone mroonga.github.com repository

  2. Execute make update-document

  3. Commit changes in mroonga.github.com repository && push them

9.2.13. Announce release for mailing list

Send release announce for each mailing list

9.2.14. Announce release for twitter

Click Tweet link in Mrooga blog entry. You can share tweet about latest release. If you use tweet link, title of release announce and URL is embedded into your tweet.

Execute sharing tweet in Japanese and English version of blog entry. Note that this tweet should be done when logged in by groonga account.