RELEASE 2.9 KB
Newer Older
1 2 3 4 5 6 7
How to build a release for LemonLDAP::NG
========================================

The version
-----------

- The release version should be updated in the following location:
8
* changelog (add a changelog from JIRA for the target version)
9 10
* Main modules (Common.pm/Handler.pm/Portal.pm/Manager.pm)
* Makefile.PL for cross-dependencies
Clément OUDOT's avatar
Clément OUDOT committed
11
* Doxyfile
12 13

- Then update packages information with:
14
$ make clean && make cpan
15 16

- Version must also be updated in RPM and Debian build files
17 18
  - rpm/lemonldap-ng.spec: update versions and add changelog entry
  - debian/changelog: add changelog entry
19 20 21 22 23

Before release
--------------

- Update documentation:
24
$ make documentation
25

26 27 28
- Translate documentation
$ make fr-doc

Xavier Guimard's avatar
Xavier Guimard committed
29 30 31
- Update debian/changelog
  launch just `dch -r` and force save (":w" and ot ":x")

32 33 34
For minor release
-----------------

Clément OUDOT's avatar
Clément OUDOT committed
35
- Go on gitlab and create a new tag: https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/tags/new
36 37 38 39

For major release
-----------------

Clément OUDOT's avatar
Clément OUDOT committed
40
- Go on gitlab and create a new branch: https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/branches/new
41

Clément OUDOT's avatar
Clément OUDOT committed
42
- Go on gitlab and create a new tag: https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/tags/new
43

44 45 46 47
- Change "latest" symlink in dokuwiki 

- Edit scripts/doc.pl in trunk to point on the new documentation path

48 49
Make the distribution
---------------------
50

51 52
- CPAN packages:
$ make clean && make cpan
53 54

- Tarball:
55 56
$ make clean && make dist

57 58 59 60 61 62
- RedHat packaging:

Create the RPM specific tarball:
$ make clean && make rpm-dist

Next steps: see rpm/README
63 64 65

- Debian packaging:

66 67 68 69
Create the debian specific tarball:
$ make clean && make debian-dist

Untar the debian archive and launch:
70 71 72 73 74 75
$ make debian-packages

Packages are in /tmp

Sign packages:
$ dpkg-sig -p --sign builder /tmp/*.deb
76 77


78 79
Upload the distribution
---------------------
80

81 82 83 84 85 86 87 88 89
- CPAN:
Upload modules tarballs (generated by make cpan)

- OW2 Forge:
Upload dist and bundles

- RPM: see rpm/REDAME

- DEB:
Clément OUDOT's avatar
Clément OUDOT committed
90
The DEB repository is hosted on https://lemonldap-ng.org/deb
91 92 93 94 95 96 97 98

Copy all generated files (*.deb, *.dsc, *.changes, ...):
$ scp *.deb *.dsc *.changes *.debian.tar.gz *.orig.tar.gz lemonldapng@lemonldap-ng.org:incoming/

Then connect on the server and launch reprepro:
$ ssh lemonldapng@lemonldap-ng.org
lemonldapng@lemonldap-ng.org$ cd deb/
lemonldapng@lemonldap-ng.org$ reprepro --ask-passphrase -Vb . include squeeze ../incoming/lemonldap-ng_VERSION_i386.changes
99 100
or
lemonldapng@sd-22107:~/deb$ reprepro --ask-passphrase -Vb . includedeb squeeze ../incoming/*VERSION*deb
101 102

See also reprepro configuration file: 'distributions'
103 104 105 106 107

Site
----

- Update links on the download page
Clément OUDOT's avatar
Clément OUDOT committed
108
- Close the mileston on Gitlab  and create a new one
109 110 111 112

Spread the word
---------------

Clément OUDOT's avatar
Clément OUDOT committed
113
- News on OW2 projects page
114
- Twitter account
Clément OUDOT's avatar
Clément OUDOT committed
115 116
- IRC and Mattemost channel subject
- User and Announces mailing lists
117 118
- Optional: blogs and news sites (LinuxFR, etc.)

Xavier Guimard's avatar
Xavier Guimard committed
119 120 121 122 123 124 125
After release
-------------

- Update debian/changelog
$ dch -v <New number>-1 (and write "New release")
- Update $VERSION anywhere