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.
