forked from apache/ant
-
Notifications
You must be signed in to change notification settings - Fork 0
/
ReleaseInstructions
272 lines (193 loc) · 10.3 KB
/
ReleaseInstructions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
Instructions for making a Release:
Authors: Conor MacNeill
Stefan Bodewig
Magesh Umasankar
Antoine Levy-Lambert
Note: This document was updated in the context of releasing Ant 1.9.5.
Please interpret the branch names, tags, etc. according to
your context.
1. Propose a release plan for vote. This should set out the timetable for
the release under ideal circumstances.
The issue of whether to create a branch for the release should be
discussed in the release vote.
2. We used until Ant 1.6 to create branches, for instance ANT_16_BRANCH
to allow parallel development on master and on the current branch.
Given the slow development speed we've reached with 1.9.x this
doesn't seem to be necessary anymore.
For more information on performing branching and merging, please visit
http://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell
3. Ensure you have all the external libraries that Ant uses in your
lib/optional directory. All dependencies are either provided by
JDK 1.5.0 or downloadable using
ant -f fetch.xml -Ddest=optional.
To find out whether you have all the libraries you need, execute
the build with -verbose option and scan for lines beginning with
"Unable to load...".
4. Create a branch just for the release, even if you've decided to
not work with long lived branches in step 2. This branch can be
removed after the release.
Switch to that branch.
$ git checkout -b prepare_Ant_1.9.5
5. Make sure that your directory tree is clean by running git status.
Some tests leave behind leftovers which end up in the source
distribution otherwise.
6. Set the version number in several files to the required new
versions. See the end of this file for a list of files containing
version information.
7. Next bootstrap, build and run the tests. Then build the
distribution on the branch. It is important that this be a clean
build. Tag this with a tag ANT_195_RC1.
The file release.sh gives an idea of how to do this build process.
build.xml specifies that the code should be compiled with
source=1.5 and target=1.5.
git tag -s -m "Tagging RC1 for version 1.9.5 of Ant" ANT_195_RC1
git push --tags
8. Sign the distribution files using the script release/signit.xml
This script requires using commons-openpgp to sign the artefacts,
This tool can be checked out from
http://svn.apache.org/repos/asf/commons/sandbox/openpgp/trunk
You have to build it using maven
You can create a property file gnupg.properties in your home directory
with your key id
and pass your key passphrase on the command line with -Dpassword=****
Before you do that, ensure that the key you use is inside the KEYS
file in Ant's git repository
<https://git-wip-us.apache.org/repos/asf?p=ant-antlibs-common.git;a=blob;f=KEYS;h=dc62b011b1b429bd6de913f8f2bce79b715f96db;hb=HEAD> -
and that you copy the KEYS file to
/www/www.apache.org/dist/ant
Also make sure you have sent the key that you use to a public
keyserver.
9. Convert the part of the WHATSNEW file covering the changes
since the last release into HTML for the README file on the
website. See the previous release directories for examples of these files.
Add instructions and warnings (GNU tar format issues, etc).
Use the target txt2html of docs.xml
This target generates a file build/html/WHATSNEW.html
Add an html head element with a title like "Release Notes of Apache Ant
1.9.5" (from the default txt2html)
Cut all sections about previous releases to keep only the current release,
and save as RELEASE-NOTES-1.9.5.html inside the distribution folder.
Copy the file RELEASE-NOTES-1.9.5.html also as README.html
10. The distribution is now ready to go.
Create a SVN sandbox on your computer with https://dist.apache.org/repos/dist/dev/ant in it
Copy the distribution folder to the location of the sandbox.
svn add the files and commit into https://dist.apache.org/repos/dist/dev/ant
11. Upload the maven artifacts located under java-repository/org/apache/ant
these artifacts comprise currently for each ant jar of one POM
file, the corresponding jar file and the corresponding GPG
signatures (x.pom, x.jar, x.pom.asc, x.jar.asc) MD5 and SHA1 are
generated by ivy during the upload
to
https://repository.apache.org (nexus repository)
using the build file release/upload.xml
ant -Dupload.user=foo -Dupload.password=secret -lib location_of_ivy_jar -f upload.xml
After the upload, you need to access the web interface of nexus
under https://repository.apache.org login using your Apache
credentials in the left pane, below "build promotion", click on
the "Stagings Repositories" links expand org.apache.ant select the
checkbox next to the upload that you just did click the button
"Close" on the top of the table listing the uploads make a note of
the location of the staging repository for the vote email
12. Once this is committed send a release vote email on dev@ant.
The email will typically mention :
- the git tag for the release including commit hash,
- the location of the tarballs, including revision number in
dist.apache.org repository
- the URL for the maven artifacts
The vote will only pass if at least three PMC members have voted +1
and more +1s than -1s have been cast. The vote will run for 3 days.
13. Update the files listed at the end of the document (files containing
version information) to prepare the development of the next
version of Ant on the master branch.
14. If the vote fails, address the problems and recreate the next RC
build.
15. Once the vote has passed, tag the last RC created with the final tag
$ git tag -s -m "Tagging version 1.9.5 of Ant" ANT_195 HASH_OF_LAST_RC
$ git push --tags
15. The distrib artifacts should be published the apache dist. It is
managed via svnpubsub so the release should be committed to the
subversion repository
https://dist.apache.org/repos/dist/release/ant/.
In order to keep the main dist area of a reasonable size, old releases
should be removed. They will disapear from the main dist but will still be
available via the archive. To do so, just use the "svn rm" command against
the artifacts or folders to remove.
* commit the new release files to
https://dist.apache.org/repos/dist/release/ant/[source|binaries|manual].
* release the maven artifacts using the web interface of nexus under https://repository.apache.org
login using your Apache credentials
in the left pane, below "build promotion", click on the "Stagings Repositories" links
expand org.apache.ant
select the checkbox next to the upload that you just did
and click the button "Release".
4 hours later, the artefacts will be in the maven central repository.
* Make README.html point to the new RELEASE-NOTES or a copy of
it.
16. Update the ant.apache.org site :
The website is managed here: https://svn.apache.org/repos/asf/ant/site/ant/
Update the following files for version number:
* source/antnews.xml (Announcement)
* source/faq.xml (Ant's history details - not for betas)
* source/index.xml (Announcement, latest release details, link to
manual under "Documentation")
* source/srcdownload.xml
* source/bindownload.xml
* source/manualdownload.xml
Generate the html files by invoking 'ant'
Commit the modified/generated files in the 'production' folder, it will go
live on ant.apache.org in a matter on seconds.
Change the version of the manual published on the site: copy the manual into
the production folder - since the site still uses svn and Ant
proper uses git there currently is no way to use the scm for this.
17. Address the available version tags in BugZilla. Create new
milestones and versions 1.9.6.
Assign all existing 1.9.5 bugs to 1.9.6.
Note that such changes can be done at once by choosing the
link "Change several bugs at once" at the bottom of the bug list
displaying the 1.9.5 bugs.
18. At this point in time, the release is done and announcements are made.
PGP-sign your announcement posts.
Apache mailing lists that should get the announcements:
announce@apache.org, dev@ant and user@ant.
19. Add a new release tag to doap_Ant.rdf in Ant's site.
Add a new release at https://reporter.apache.org/
20. If you've created a temporary branch you can delete it now.
21. You can now reacquaint yourself with your family and friends.
(*) Mirrors : the srcdownload.html, bindownload.html and
manualdownload.html each list a number of mirrors. For ant 1.6.0
the mirrors picked up the new version in 8 hours or less, the
release having been done at midnight on Dec 18th, the mirrors had
it on Dec 19th at 8 am. The
srcdownload/bindownload/manualdownload pages all contain a note
advising users to be patient immediately after the release.
(+) Don't expect the old releases to disappear from
www.apache.org/dist as soon as the new releases are there.
The rsync process from people.a.o to www.a.o adds files once per
hour but only deletes once per day.
Related Information
http://www.apache.org/dev/#releases
http://commons.apache.org/releases/index.html
http://wiki.apache.org/commons/SigningReleases
Files containing version information
------------------------------------
* manual/cover.html
* manual/credits.html
* build.xml properties : project.version,manifest-version,pom.version
* POM files under src/etc/poms and subdirectories
* ivy.xml in release subdirectory
* WHATSNEW
* src/etc/testcases/taskdefs/conditions/antversion.xml
cover.html, credits.html, POM files, antversion.xml should be
adjusted for the [newversion] right after the build and tagging
of the release
build.xml
---------
right before a release :
the project.version gets bumped to the exact release
number, for instance 1.9.5
right after a release :
project.version property in build.xml gets bumped to
[newversion]alpha, for example 1.9.6alpha
manifest-version gets bumped to the exact next release number
for example 1.9.6
pom.version gets bumped to [newversion]-SNAPSHOT