Ignore:
Timestamp:
04/29/20 08:58:51 (4 years ago)
Author:
Mark Evenson
Message:

doc: update the releng notes for Maven

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/abcl/doc/releng.org

    r15070 r15274  
    1 * ABCL Release Engineering practices
     1* ABCL Release Engineering
     2
     3See also <https://abcl.org/trac/wiki/ReleaseSteps>.
    24
    35** Maven
    46
    5 Instructions for Releasing ABCL on Sonatype's OSS Maven repository
     7Instructions for releasing ABCL on Sonatype's OSS Maven repository.
     8
     9You need a Sonatype account, see
     10<https://central.sonatype.org/pages/ossrh-guide.html>.  This will
     11result in providing you with a "JIRA username and a password".
    612
    713*** settings.xml
    814
    9 This assumes your settings.xml (/etc/maven2/settings.xml for
    10 Ubuntu-packaged Maven) contains something like this in its
    11 <servers></servers> section:
     15Enter your "JIRA username and a password" in a
     16<file:.m2/settings.xml>.  This will authenticate
    1217
    13 #+BEGIN_SRC
     18#+BEGIN_SRC xml
     19<settings>
    1420 <server>
    1521   <id>sonatype-nexus-snapshots</id>
    … …  
    2228   <password>sonatype-jira-password</password>
    2329 </server>
     30</settings>
    2431#+END_SRC
    2532
    2633*** Process
    2734
    28 First, remember to build it!
     35Ensure that the artifacts you wish to upload are present by building
     36them.
    2937
    3038#+BEGIN_SRC
    … …  
    3846#+END_SRC
    3947
    40 For snapshots - development versions - the version in the POM should be like x.y.z-SNAPSHOT
    4148
    42 #+BEGIN_SRC
    43 mvn gpg:sign-and-deploy-file -Dfile=dist/abcl.jar -DpomFile=pom.xml -Durl=https://oss.sonatype.org/content/repositories/snapshots/ -DrepositoryId=sonatype-nexus-snapshots
    44 mvn gpg:sign-and-deploy-file -Dfile=dist/abcl-sources.jar -DpomFile=pom.xml -Durl=https://oss.sonatype.org/content/repositories/snapshots/ -DrepositoryId=sonatype-nexus-snapshots -Dclassifier=sources
    45 mvn gpg:sign-and-deploy-file -Dfile=dist/abcl-javadoc.jar -DpomFile=pom.xml -Durl=https://oss.sonatype.org/content/repositories/snapshots/ -DrepositoryId=sonatype-nexus-snapshots -Dclassifier=javadoc
    46 mvn gpg:sign-and-deploy-file -Dfile=dist/abcl-contrib.jar -DpomFile=contrib/pom.xml -Durl=https://oss.sonatype.org/content/repositories/snapshots/ -DrepositoryId=sonatype-nexus-snapshots
     49**** Snapshots
     50For snapshots - development versions - the version in the POM should look like ~x.y.z-SNAPSHOT~.
     51
     52#+BEGIN_SRC bash
     53keyname='<your_pgp_key@example.com>'
     54mvn gpg:sign-and-deploy-file -Dgpg.keyname=${keyname} -Dfile=dist/abcl.jar -DpomFile=pom.xml -Durl=https://oss.sonatype.org/content/repositories/snapshots/ -DrepositoryId=sonatype-nexus-snapshots
     55mvn gpg:sign-and-deploy-file -Dgpg.keyname=${keyname} -Dfile=dist/abcl-sources.jar -DpomFile=pom.xml -Durl=https://oss.sonatype.org/content/repositories/snapshots/ -DrepositoryId=sonatype-nexus-snapshots -Dclassifier=sources
     56mvn gpg:sign-and-deploy-file -Dgpg.keyname=${keyname} -Dfile=dist/abcl-javadoc.jar -DpomFile=pom.xml -Durl=https://oss.sonatype.org/content/repositories/snapshots/ -DrepositoryId=sonatype-nexus-snapshots -Dclassifier=javadoc
     57mvn gpg:sign-and-deploy-file -Dgpg.keyname=${keyname} -Dfile=dist/abcl-contrib.jar -DpomFile=contrib/pom.xml -Durl=https://oss.sonatype.org/content/repositories/snapshots/ -DrepositoryId=sonatype-nexus-snapshots
    4758#+END_SRC
    4859
    49 For releases - the version in the POM should be x.y.z
    5060
    51 #+BEGIN_SRC
    52 mvn gpg:sign-and-deploy-file -Dfile=dist/abcl.jar -DpomFile=pom.xml -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -DrepositoryId=sonatype-nexus-staging
    53 mvn gpg:sign-and-deploy-file -Dfile=dist/abcl-${abcl_version}-sources.jar -DpomFile=pom.xml -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -DrepositoryId=sonatype-nexus-staging -Dclassifier=sources
    54 mvn gpg:sign-and-deploy-file -Dfile=dist/abcl-${abcl_version}-javadoc.jar -DpomFile=pom.xml -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -DrepositoryId=sonatype-nexus-staging -Dclassifier=javadoc
     61**** Release
     62For releases - the version in the POM should look like  ~x.y.z~
     63
     64#+BEGIN_SRC bash
     65keyname='<evenson.not.org@gmail.com>'
     66abcl_version=1.6.1
     67mvn gpg:sign-and-deploy-file -Dgpg.keyname=${keyname} -Dfile=dist/abcl.jar -DpomFile=pom.xml -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -DrepositoryId=sonatype-nexus-staging
     68mvn gpg:sign-and-deploy-file -Dgpg.keyname=${keyname} -Dfile=dist/abcl-${abcl_version}-sources.jar -DpomFile=pom.xml -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -DrepositoryId=sonatype-nexus-staging -Dclassifier=sources
     69mvn gpg:sign-and-deploy-file -Dgpg.keyname=${keyname} -Dfile=dist/abcl-${abcl_version}-javadoc.jar -DpomFile=pom.xml -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -DrepositoryId=sonatype-nexus-staging -Dclassifier=javadoc
    5570#+END_SRC
    5671
    … …  
    5873
    5974#+BEGIN_SRC
    60 mvn gpg:sign-and-deploy-file -Dfile=dist/abcl-contrib.jar -DpomFile=contrib/pom.xml -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -DrepositoryId=sonatype-nexus-staging
    61 mvn gpg:sign-and-deploy-file -Dfile=dist/abcl-contrib-${abcl_version}-sources.jar -DpomFile=contrib/pom.xml -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -DrepositoryId=sonatype-nexus-staging -Dclassifier=sources
    62 mvn gpg:sign-and-deploy-file -Dfile=dist/abcl-contrib-${abcl_version}-javadoc.jar -DpomFile=contrib/pom.xml -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -DrepositoryId=sonatype-nexus-staging -Dclassifier=javadoc
     75keyname='<evenson.not.org@gmail.com>'
     76abcl_version=1.6.1
     77mvn gpg:sign-and-deploy-file -Dgpg.keyname=${keyname} -Dfile=dist/abcl-contrib.jar -DpomFile=contrib/pom.xml -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -DrepositoryId=sonatype-nexus-staging
     78mvn gpg:sign-and-deploy-file -Dgpg.keyname=${keyname} -Dfile=dist/abcl-contrib-${abcl_version}-sources.jar -DpomFile=contrib/pom.xml -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -DrepositoryId=sonatype-nexus-staging -Dclassifier=sources
     79mvn gpg:sign-and-deploy-file -Dgpg.keyname=${keyname} -Dfile=dist/abcl-contrib-${abcl_version}-javadoc.jar -DpomFile=contrib/pom.xml -Durl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -DrepositoryId=sonatype-nexus-staging -Dclassifier=javadoc
    6380#+END_SRC
    6481
    … …  
    7390<http://central.sonatype.org/pages/releasing-the-deployment.html>
    7491
    75 *** Specifiying GPG executable
     92*** Specifying GPG executable
    7693
    7794For specifying gpg executable, use a property specified via
Note: See TracChangeset for help on using the changeset viewer.