2011-03-07 10:25:52 +01:00
|
|
|
How to build a release for LemonLDAP::NG
|
|
|
|
========================================
|
|
|
|
|
|
|
|
The version
|
|
|
|
-----------
|
|
|
|
|
|
|
|
- The release version should be updated in the following location:
|
2017-11-11 14:06:23 +01:00
|
|
|
* changelog (add a changelog from GitLab for the target version)
|
2011-03-07 10:25:52 +01:00
|
|
|
* Main modules (Common.pm/Handler.pm/Portal.pm/Manager.pm)
|
|
|
|
* Makefile.PL for cross-dependencies
|
|
|
|
|
|
|
|
- Then update packages information with:
|
2013-01-15 12:02:17 +01:00
|
|
|
$ make clean && make cpan
|
2011-03-07 10:25:52 +01:00
|
|
|
|
|
|
|
- Version must also be updated in RPM and Debian build files
|
2013-01-15 12:02:17 +01:00
|
|
|
- rpm/lemonldap-ng.spec: update versions and add changelog entry
|
|
|
|
- debian/changelog: add changelog entry
|
2011-03-07 10:25:52 +01:00
|
|
|
|
|
|
|
Before release
|
|
|
|
--------------
|
|
|
|
|
2018-09-06 15:13:09 +02:00
|
|
|
- Update languages (needs a Transifex token)
|
|
|
|
$ ./scripts/download_translations
|
|
|
|
|
2011-03-07 10:25:52 +01:00
|
|
|
- Update documentation:
|
2018-03-13 18:48:29 +01:00
|
|
|
|
2018-07-15 17:35:17 +02:00
|
|
|
$ ./scripts/parameters-for-wiki.pl >/tmp/prmlist.txt
|
2018-03-13 18:48:29 +01:00
|
|
|
|
|
|
|
Replace https://lemonldap-ng.org/documentation/X.X/parameterlist by
|
|
|
|
/tmp/prmlist.txt content
|
2019-04-03 14:15:16 +02:00
|
|
|
|
2018-03-13 18:48:29 +01:00
|
|
|
$ make documentation
|
2011-03-23 15:54:14 +01:00
|
|
|
|
2018-05-24 14:49:35 +02:00
|
|
|
- Update changelog:
|
|
|
|
|
|
|
|
$ ./scripts/generate-changelog.pl
|
|
|
|
|
|
|
|
This update "changelog" file using GitLab issues (tags Bug, New feature,
|
|
|
|
Improvement)
|
|
|
|
|
2016-03-01 14:55:57 +01:00
|
|
|
- Update debian/changelog
|
|
|
|
launch just `dch -r` and force save (":w" and ot ":x")
|
|
|
|
|
2017-10-26 11:23:28 +02:00
|
|
|
- Check Debian packages quality
|
2018-03-13 18:48:29 +01:00
|
|
|
$ cme check dpkg
|
2017-10-26 11:23:28 +02:00
|
|
|
|
2011-07-08 11:39:32 +02:00
|
|
|
For minor release
|
|
|
|
-----------------
|
|
|
|
|
2017-11-24 20:54:55 +01:00
|
|
|
- Go on gitlab and create a new tag: https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/tags/new
|
2011-07-08 11:39:32 +02:00
|
|
|
|
|
|
|
For major release
|
|
|
|
-----------------
|
|
|
|
|
2017-11-24 20:54:55 +01:00
|
|
|
- Go on gitlab and create a new branch: https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/branches/new
|
2011-03-07 10:25:52 +01:00
|
|
|
|
2017-11-24 20:54:55 +01:00
|
|
|
- Go on gitlab and create a new tag: https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/tags/new
|
2011-03-07 10:25:52 +01:00
|
|
|
|
2019-04-03 14:15:16 +02:00
|
|
|
- Change "latest" symlink in dokuwiki
|
2013-11-02 20:06:11 +01:00
|
|
|
|
|
|
|
- Edit scripts/doc.pl in trunk to point on the new documentation path
|
|
|
|
|
2013-01-15 12:02:17 +01:00
|
|
|
Make the distribution
|
|
|
|
---------------------
|
2011-03-07 10:25:52 +01:00
|
|
|
|
2013-01-15 12:02:17 +01:00
|
|
|
- CPAN packages:
|
|
|
|
$ make clean && make cpan
|
2011-03-07 10:25:52 +01:00
|
|
|
|
|
|
|
- Tarball:
|
2013-01-15 12:02:17 +01:00
|
|
|
$ make clean && make dist
|
|
|
|
|
2014-06-29 22:18:39 +02:00
|
|
|
- RedHat packaging:
|
|
|
|
|
|
|
|
Create the RPM specific tarball:
|
|
|
|
$ make clean && make rpm-dist
|
|
|
|
|
|
|
|
Next steps: see rpm/README
|
2013-01-15 12:02:17 +01:00
|
|
|
|
|
|
|
- Debian packaging:
|
|
|
|
|
2013-04-23 12:11:19 +02:00
|
|
|
Create the debian specific tarball:
|
|
|
|
$ make clean && make debian-dist
|
|
|
|
|
|
|
|
Untar the debian archive and launch:
|
2013-01-15 12:02:17 +01:00
|
|
|
$ make debian-packages
|
|
|
|
|
|
|
|
Packages are in /tmp
|
|
|
|
|
|
|
|
Sign packages:
|
|
|
|
$ dpkg-sig -p --sign builder /tmp/*.deb
|
2011-03-07 10:25:52 +01:00
|
|
|
|
|
|
|
|
2013-01-15 12:02:17 +01:00
|
|
|
Upload the distribution
|
|
|
|
---------------------
|
2011-03-07 10:25:52 +01:00
|
|
|
|
2013-01-15 12:02:17 +01:00
|
|
|
- CPAN:
|
|
|
|
Upload modules tarballs (generated by make cpan)
|
|
|
|
|
2018-06-16 11:33:00 +02:00
|
|
|
- OW2 Release:
|
|
|
|
Upload dist and bundles on sftp://release-up.ow2.org/projects/lemonldap
|
2013-01-15 12:02:17 +01:00
|
|
|
|
|
|
|
- RPM: see rpm/REDAME
|
|
|
|
|
|
|
|
- DEB:
|
|
|
|
The DEB repository is hosted on http://lemonldap-ng.org/deb
|
|
|
|
|
2017-06-08 18:27:08 +02:00
|
|
|
Copy all generated files (*.deb):
|
|
|
|
$ scp *.deb lemonldapng@lemonldap-ng.org:incoming/
|
2013-01-15 12:02:17 +01:00
|
|
|
|
|
|
|
Then connect on the server and launch reprepro:
|
|
|
|
$ ssh lemonldapng@lemonldap-ng.org
|
|
|
|
lemonldapng@lemonldap-ng.org$ cd deb/
|
2017-06-08 18:27:08 +02:00
|
|
|
lemonldapng@sd-22107:~/deb$ reprepro --ask-passphrase -Vb . includedeb stable ../incoming/*VERSION*deb
|
|
|
|
lemonldapng@sd-22107:~/deb$ reprepro --ask-passphrase -Vb . includedeb 2.0 ../incoming/*VERSION*deb
|
2013-01-15 12:02:17 +01:00
|
|
|
|
|
|
|
See also reprepro configuration file: 'distributions'
|
2011-03-07 10:25:52 +01:00
|
|
|
|
2017-06-08 18:27:08 +02:00
|
|
|
- Docker:
|
|
|
|
Build a new image from https://github.com/LemonLDAPNG/lemonldap-ng-docker
|
|
|
|
Tag image to latest
|
|
|
|
Upload on Docker hub
|
|
|
|
|
2011-03-07 10:25:52 +01:00
|
|
|
Site
|
|
|
|
----
|
|
|
|
|
|
|
|
- Update links on the download page
|
2017-11-24 20:54:55 +01:00
|
|
|
- Close the milestone on Gitlab and create a new one
|
2011-03-07 10:25:52 +01:00
|
|
|
|
|
|
|
Spread the word
|
|
|
|
---------------
|
|
|
|
|
2017-06-08 18:27:08 +02:00
|
|
|
- News on OW2 projects page: https://projects.ow2.org/bin/view/lemonldap-ng/
|
|
|
|
- Twitter account / Facebook page
|
|
|
|
- IRC channel subject and Mattermost
|
|
|
|
- Mailing lists: lemonldap-ng-users / lemonldap-ng-announces
|
2011-03-07 10:25:52 +01:00
|
|
|
- Optional: blogs and news sites (LinuxFR, etc.)
|
|
|
|
|
2016-03-01 14:55:57 +01:00
|
|
|
After release
|
|
|
|
-------------
|
|
|
|
|
|
|
|
- Update debian/changelog
|
|
|
|
$ dch -v <New number>-1 (and write "New release")
|
|
|
|
- Update $VERSION anywhere
|
|
|
|
|