/[resiprocate]/main/RELEASE-PROCESS.txt
ViewVC logotype

Contents of /main/RELEASE-PROCESS.txt

Parent Directory Parent Directory | Revision Log Revision Log


Revision 10206 - (show annotations) (download)
Sun May 12 10:33:39 2013 UTC (6 years, 7 months ago) by dpocock
File MIME type: text/plain
File size: 2917 byte(s)
build: update notes for building 1.9 series release tarballs on Debian 7
1
2 reSIProcate release process
3 ===========================
4
5 This document explains the process for building a release of the
6 reSIProcate software.
7
8 Deliverables
9 ------------
10
11 The only official deliverable is the tarball, for example,
12
13 resiprocate-1.8.0.tar.gz
14
15 As a courtesy to users, a contrib tarball is also produced,
16 containing some third party code:
17
18 resiprocate-contrib-1.8.0.tar.gz
19
20 Building of binary packages (e.g. for Debian, RPM, OpenCSW) is
21 done after the tarball release. That is not covered here.
22
23 Workspace
24 ---------
25
26 Obtain a release branch from SVN, using the git-svn tool.
27 git-svn is used because it makes it easier to build a clean tarball
28 (without the risk of distributing .svn/* by mistake)
29
30 git svn clone \
31 --trunk=https://svn.resiprocate.org/rep/resiprocate/main/branches/release-1.8 \
32 resip-1.8
33
34 cd resip-1.8
35
36 Version/tag
37 -----------
38
39 Here we give an example for building the release v1.8.5:
40
41 Update version information and tag it:
42
43 vi configure.ac (update the version and ABIVERSION numbers)
44
45 git add configure.ac
46 git commit -m 'Update to version 1.8.5'
47
48 git svn dcommit (send changes back to SVN)
49
50 svn copy -m 'release: Tag 1.8.5' \
51 https://svn.resiprocate.org/rep/resiprocate/branches/resiprocate-1.8 \
52 https://svn.resiprocate.org/rep/resiprocate/tags/resiprocate-1.8.5
53
54 Bootstrap
55 ---------
56
57 The bootstrap must always be done on the same version of autotools
58 for consistency. The currently endorsed version is the autotools
59 distributed in Debian 7.0 (wheezy). If another version is to be used,
60 it should be discussed on the mailing list and noted in this document.
61
62 autoreconf --install
63
64 Make a tarball
65 --------------
66
67 build/release-tarball.sh
68
69 * this script will call configure && make dist
70 * any previous configure settings will be overridden, so you
71 may want to preserve a copy of config.status and config.log
72 or just do this operation from a workspace that is independent
73 of your normal development workspace
74
75 Make the contrib tarball
76 ------------------------
77
78 build/contrib-tarball.sh
79
80 Sanity check on tarball
81 -----------------------
82
83 Extract the tarball to /tmp/some-folder/resiprocate-1.8.5
84
85 cd /tmp/some-folder/resiprocate-1.8.5
86 ./configure && make -j 12 check
87
88 Distribute the tarball
89 ----------------------
90
91 sha256sum resiprocate-1.8.5.tar.gz
92
93 Upload the tarball to the pre-release section of the web site
94
95 Send a PGP signed email to the developers list announcing that
96 a release candidate has been built. Other developers may test the tarball.
97
98 Include the SHA-256 checksum in the PGP signed email.
99
100 Confirm the release
101 -------------------
102
103 Upload the tarball to the official download page
104
105 Send a PGP signed email to the resip-announce and users lists
106 announcing that the release candidate is now an official release.
107
108 Include the SHA-256 checksum in the PGP signed email.
109
110

Properties

Name Value
svn:eol-style native

webmaster AT resiprocate DOT org
ViewVC Help
Powered by ViewVC 1.1.27