Building Release

Instructions how to build a new maintenance release

Commit and merge the changes from our translation server!

You need a clean 23.1 checkout without any uncommited or unpushed changes!

git clone git@github.com:EGroupware/egroupware.git epl-23.1-checkout
cd epl-23.1-checkout
# install EPL apps
git clone git@github.com:EGroupwareGmbH/epl.git stylite
for app in esyncpro policy webauthn; do git clone git@github.com:EGroupwareGmbH/$app.git; done
./install-cli.php

For an existing checkout you need to run install-cli twice, as first one fails in composer!

./install-cli.php

Then you start the build, which will run install-cli.php again

doc/rpm-build/checkout-build-archives.php -v

• it will determine the changelog based on commit messages and allows to modify it
• it will create a tag 23.1.<YYYYmmdd> (can be changed with --packaging <YYYYmmdd>)
• at one point it needs the root password to update clamav database to virusscan the build-root
• pgp will ask the passphrase for build@egroupware.org key to sign the hashes of the archives
• at last it will ask the Github token of the user doing the upload (can be changed with --github_user <username>)
• the creation of the tag on Github will no longer trigger an automatic build of the Docker image egroupware/egroupware:19.1.<YYYYmmdd> on Docker Hub: https://cloud.docker.com/u/egroupware/repository/registry-1.docker.io/egroupware/egroupware, you have to manually run:

cd doc/docker/fpm
./build.sh 23.1.<YYYYmmdd>
# for EPL
cd -; cd stylite/docker
./build.sh 21.1.<YYYYmmdd>

After testing the image, it need to be tagged as 23.1 and latest

docker pull egroupware/egroupware:23.1.<YYYYmmdd>
docker tag egroupware/egroupware:23.1.<YYYYmmdd> egroupware/egroupware:23.1
docker push egroupware/egroupware:23.1
docker tag egroupware/egroupware:23.1.<YYYYmmdd> egroupware/egroupware:latest
docker push egroupware/egroupware:latest

Push the changelog to 23.1 branch and merge the commit to master to satisfy the update checker:

cd epl-23.1-checkout
git push
git log # to identify the change-log commit to merge to master
git checkout master
git pull
git cherry-pick <hash-from-changelog-commit>
git push
git checkout 23.1

Last but not least remove the pre-release tag from 23.1.<YYYYmmdd> release on Github and update first line of https://www.egroupware.org/currentversion

ssh docker.egroupware.org sed "'1 s/^.*$/23.1.<YYYYmmdd>/'" -i /var/www/egroupware.org/currentversion

Building the EPL image

cd other/23.1/checkout # use a *different* up-to-date 23.1 checkout
docker pull egroupware/egroupware:23.1.<YYYYmmdd>
cd stylite
docker/build.sh 23.1.<YYYYmmdd>

• it will pull the above build CE image
• add epl-functions to it
• tag it as quay.io/egroupware/epl:23.1.<YYYYmmdd>, 23.1 and latest and push it to quay.io

Build RPM/DEB packages on build.opensuse.org

This step is not necessary, if there are no changes on the package itself!

You need a checkout of the EGroupware/build.opensuse.org repo

git clone git@github.com:EGroupware/build.opensuse.org.git

To build a new package you need to

cd build.opensuse.org/server\:eGroupWare/egroupware-docker
cp /your/23.1/checkout/doc/rpm-build/debian.changes .
# fix the packaging accordingly
for file in egroupware-docker.{spec,dsc}; do sed -i 's/23.1.[0-9]\{8\}/21.1.<YYYYmmdd>/g' $file; done
git rm egroupware-docker-23.1*.tar.gz
tar -czvf egroupware-docker-23.1.<YYYYmmdd>.tar.gz egroupware-docker
osc addremove
osc commit -m 'building 23.1.<YYYYmmdd>'
git add egroupware-docker-23.1.<YYYYmmdd>.tar.gz egroupware-docker.{spec,dsc} debian.changes
git commit -m 'changes for 23.1.<YYYYmmdd>'

After testing EPL-Archives need to be rsync-ed to download.egroupware.org

cd ~/download/archives
rsync -rv egroupware-23.1 download.egroupware.org:/var/www/html/stylite-epl/

Univention packages for 23.1

cd epl-23.1-checkout
doc/rpm-build/release-appcenter.sh

And writing an email to appcenter@univention.de that there is a new maintenance release.