This is an automated email from the ASF dual-hosted git repository.
robertlazarski pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/axis-axis2-java-core.git
The following commit(s) were added to refs/heads/master by this push:
new bf682fea57 Update release process docs
bf682fea57 is described below
commit bf682fea57bbe7a05d24df9be06c69654354be1f
Author: Robert Lazarski <robertlazar...@gmail.com>
AuthorDate: Tue Feb 18 10:12:18 2025 -1000
Update release process docs
---
src/site/markdown/release-process.md | 25 ++++++++++++++++---------
1 file changed, 16 insertions(+), 9 deletions(-)
diff --git a/src/site/markdown/release-process.md
b/src/site/markdown/release-process.md
index 64989c5f83..a6a8158f5d 100644
--- a/src/site/markdown/release-process.md
+++ b/src/site/markdown/release-process.md
@@ -156,25 +156,32 @@ The following things are required to perform the actual
release:
In order to prepare the release artifacts for vote, execute the following
steps:
-1. Start the release process using the following command:
+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>
+
+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>
+
+The command to export a public key is as follows:
+
+<code>gpg --armor --export key_id</code>
+
+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.
+
+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.
+
+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>
mvn release:prepare
When asked for a tag name, accept the default value (in the following
format: `vX.Y.Z`).
- The execution of the `release:prepare` goal may occasionally fail because
`svn.apache.org`
- resolves to one of the geolocated SVN mirrors and there is a propagation
delay between
- the master and these mirrors. If this happens,
- wait for a minute (so that the mirrors can catch up with the master) and
simply rerun the command.
- It will continue where the error occurred.
2. Perform the release using the following command:
mvn release:perform
3. Login to Nexus and close the staging repository. For more details about
this step, see
-
[here](https://docs.sonatype.org/display/Repository/Closing+a+Staging+Repository).
+
[here](https://maven.apache.org/developers/release/maven-project-release-procedure.html).
-4. Execute the `target/checkout/etc/dist.py` script to upload the
distributions.
+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>
5. Create a staging area for the Maven site:
@@ -204,7 +211,7 @@ In order to prepare the release artifacts for vote, execute
the following steps:
If the vote passes, execute the following steps:
1. Promote the artifacts in the staging repository. See
-
[here](https://maven.apache.org/developers/release/maven-project-release-procedure.html)
+
[here](https://central.sonatype.org/publish/release/#close-and-drop-or-release-your-staging-repository)
for detailed instructions for this step.
2. Publish the distributions:
