Skip to content

Commit bf682fe

Browse files
Update release process docs
1 parent 8baedee commit bf682fe

File tree

1 file changed

+16
-9
lines changed

1 file changed

+16
-9
lines changed

src/site/markdown/release-process.md

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -156,25 +156,32 @@ The following things are required to perform the actual release:
156156

157157
In order to prepare the release artifacts for vote, execute the following steps:
158158

159-
1. Start the release process using the following command:
159+
If not yet done, export your public key and <a href="https://dist.apache.org/repos/dist/release/axis/axis2/java/core/KEYS"> append it there. </a>
160+
161+
If not yet done, also export your public key to the dev area and <a href="https://dist.apache.org/repos/dist/release/axis/axis2/java/core/KEYS"> append it there. </a>
162+
163+
The command to export a public key is as follows:
164+
165+
<code>gpg --armor --export key_id</code>
166+
167+
If you have multiple keys, you can define a ~/.gnupg/gpg.conf file for a default. Note that while 'gpg --list-keys' will show your public keys, using maven-release-plugin with the command 'release:perform' below requires 'gpg --list-secret-keys' to have a valid entry that matches your public key, in order to create 'asc' files that are used to verify the release artifcats. 'release:prepare' creates the sha512 checksum files.
168+
169+
The created artifacts i.e. zip files can be checked with, for example, sha512sum 'axis2-2.0.0-bin.zip.asc' which should match the generated sha512 files. In that example, use 'gpg --verify axis2-2.0.0-bin.zip.asc axis2-2.0.0-bin.zip' to verify the artifacts were signed correctly.
170+
171+
1. Start the release process using the following command - use 'mvn release:rollback' to undo and be aware that in the main pom.xml there is an apache parent that defines some plugin versions<a href="https://maven.apache.org/pom/asf/"> documented here. </a>
160172

161173
mvn release:prepare
162174

163175
When asked for a tag name, accept the default value (in the following format: `vX.Y.Z`).
164-
The execution of the `release:prepare` goal may occasionally fail because `svn.apache.org`
165-
resolves to one of the geolocated SVN mirrors and there is a propagation delay between
166-
the master and these mirrors. If this happens,
167-
wait for a minute (so that the mirrors can catch up with the master) and simply rerun the command.
168-
It will continue where the error occurred.
169176

170177
2. Perform the release using the following command:
171178

172179
mvn release:perform
173180

174181
3. Login to Nexus and close the staging repository. For more details about this step, see
175-
[here](https://docs.sonatype.org/display/Repository/Closing+a+Staging+Repository).
182+
[here](https://maven.apache.org/developers/release/maven-project-release-procedure.html).
176183

177-
4. Execute the `target/checkout/etc/dist.py` script to upload the distributions.
184+
4. Execute the `target/checkout/etc/dist.py` script to upload the source and binary distributions to the development area of the <a href="https://dist.apache.org/repos/dist/"> repository. </a>
178185

179186
5. Create a staging area for the Maven site:
180187

@@ -204,7 +211,7 @@ In order to prepare the release artifacts for vote, execute the following steps:
204211
If the vote passes, execute the following steps:
205212

206213
1. Promote the artifacts in the staging repository. See
207-
[here](https://maven.apache.org/developers/release/maven-project-release-procedure.html)
214+
[here](https://central.sonatype.org/publish/release/#close-and-drop-or-release-your-staging-repository)
208215
for detailed instructions for this step.
209216

210217
2. Publish the distributions:

0 commit comments

Comments
 (0)