Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id F1BBD200CCC for ; Fri, 21 Jul 2017 13:32:43 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id F05DB16D0E6; Fri, 21 Jul 2017 11:32:43 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id DDECB16D0E5 for ; Fri, 21 Jul 2017 13:32:42 +0200 (CEST) Received: (qmail 86372 invoked by uid 500); 21 Jul 2017 11:32:42 -0000 Mailing-List: contact commits-help@polygene.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@polygene.apache.org Delivered-To: mailing list commits@polygene.apache.org Received: (qmail 86363 invoked by uid 99); 21 Jul 2017 11:32:42 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 21 Jul 2017 11:32:42 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id E26B5E965C; Fri, 21 Jul 2017 11:32:41 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: paulmerlin@apache.org To: commits@polygene.apache.org Date: Fri, 21 Jul 2017 11:32:42 -0000 Message-Id: In-Reply-To: References: X-Mailer: ASF-Git Admin Mailer Subject: [2/5] polygene-java git commit: Update release guide archived-at: Fri, 21 Jul 2017 11:32:44 -0000 Update release guide - add tl;dr - remove mentions of a binary distribution - fix maven convenience binary staging - minor edits (wording, commit messages etc..) Project: http://git-wip-us.apache.org/repos/asf/polygene-java/repo Commit: http://git-wip-us.apache.org/repos/asf/polygene-java/commit/49e6259f Tree: http://git-wip-us.apache.org/repos/asf/polygene-java/tree/49e6259f Diff: http://git-wip-us.apache.org/repos/asf/polygene-java/diff/49e6259f Branch: refs/heads/master Commit: 49e6259f0dff70346dbb7a0360be5987112c159e Parents: 1bdeea8 Author: Paul Merlin Authored: Mon Jul 17 17:23:55 2017 +0200 Committer: Paul Merlin Committed: Mon Jul 17 17:23:55 2017 +0200 ---------------------------------------------------------------------- .../docs/tutorials/howto-releasing-apache.txt | 94 ++++---------------- 1 file changed, 15 insertions(+), 79 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/polygene-java/blob/49e6259f/manual/src/docs/tutorials/howto-releasing-apache.txt ---------------------------------------------------------------------- diff --git a/manual/src/docs/tutorials/howto-releasing-apache.txt b/manual/src/docs/tutorials/howto-releasing-apache.txt index 9c2ae62..c67f269 100644 --- a/manual/src/docs/tutorials/howto-releasing-apache.txt +++ b/manual/src/docs/tutorials/howto-releasing-apache.txt @@ -33,6 +33,13 @@ It is intended to be a recommendation of best practices for the Apache Polygene The instructions provided here are consistent with, but not a replacement for the https://www.apache.org/dev/release.html[ASF Release Guidelines]. +== TL;DR + +- Build and publish/stage release candidate bits +- VOTE thread + - NO: clean things up + - YES: promote the release candidate bits as final and update all properties + == Preparing a release @@ -271,14 +278,6 @@ Also review the release distributions in `distributions/build/distributions` whe [source,shell] ---- . -├── apache-polygene-java--bin.tgz -├── apache-polygene-java--bin.tgz.MD5 -├── apache-polygene-java--bin.tgz.SHA-512 -├── apache-polygene-java--bin.tgz.asc -├── apache-polygene-java--bin.zip -├── apache-polygene-java--bin.zip.MD5 -├── apache-polygene-java--bin.zip.SHA-512 -├── apache-polygene-java--bin.zip.asc ├── apache-polygene-java--src.tgz ├── apache-polygene-java--src.tgz.MD5 ├── apache-polygene-java--src.tgz.SHA-512 @@ -330,7 +329,7 @@ Stage artifacts to https://repository.apache.org/[repository.apache.org] : [source,shell] ---- cd polygene-java -./gradlew -Dversion="" publishAsfMavenArtifacts +./gradlew -Dversion="" uploadArchives ---- Close the staging Nexus repository by following the https://www.apache.org/dev/publishing-maven-artifacts.html#close-stage[Closing the staged repository] guide. @@ -356,8 +355,8 @@ that the new version was published and is tagged as `beta`. === Upload RC distributions -Source and binary distributions, checksums and signatures must be uploaded to https://dist.apache.org/repos/dist/dev/polygene/[dist.apache.org/repos/dist/dev/polygene]. -This build created these in the `buid/distributions` directory, named `apache-polygene-java--[src|bin]*.*`. +Source distribution, checksums and signatures must be uploaded to https://dist.apache.org/repos/dist/dev/polygene/[dist.apache.org/repos/dist/dev/polygene]. +This build created these in the `buid/distributions` directory, named `apache-polygene-java--src*.*`. As this release still is a simple candidate, we'll rename them before upload to advertise this in their names. [source,shell] @@ -380,24 +379,6 @@ cp "polygene-java/distributions/build/distributions/apache-polygene-java--RC#-src.tgz.SHA-512" cp "polygene-java/distributions/build/distributions/apache-polygene-java--src.tgz.asc" \ "polygene-dist/dev/polygene/apache-polygene-java--RC#-src.tgz.asc" -# Binary ZIP -cp "polygene-java/distributions/build/distributions/apache-polygene-java--bin.zip" \ - "polygene-dist/dev/polygene/apache-polygene-java--RC#-bin.zip" -cp "polygene-java/distributions/build/distributions/apache-polygene-java--bin.zip.MD5" \ - "polygene-dist/dev/polygene/apache-polygene-java--RC#-bin.zip.MD5" -cp "polygene-java/distributions/build/distributions/apache-polygene-java--bin.zip.SHA-512" \ - "polygene-dist/dev/polygene/apache-polygene-java--RC#-bin.zip.SHA-512" -cp "polygene-java/distributions/build/distributions/apache-polygene-java--bin.zip.asc" \ - "polygene-dist/dev/polygene/apache-polygene-java--RC#-bin.zip.asc" -# Binary TAR.GZ -cp "polygene-java/distributions/build/distributions/apache-polygene-java--bin.tgz" \ - "polygene-dist/dev/polygene/apache-polygene-java--RC#-bin.tgz" -cp "polygene-java/distributions/build/distributions/apache-polygene-java--bin.tgz.MD5" \ - "polygene-dist/dev/polygene/apache-polygene-java--RC#-bin.tgz.MD5" -cp "polygene-java/distributions/build/distributions/apache-polygene-java--bin.tgz.SHA-512" \ - "polygene-dist/dev/polygene/apache-polygene-java--RC#-bin.tgz.SHA-512" -cp "polygene-java/distributions/build/distributions/apache-polygene-java--bin.tgz.asc" \ - "polygene-dist/dev/polygene/apache-polygene-java--RC#-bin.tgz.asc" ---- And then upload them: @@ -406,7 +387,7 @@ And then upload them: ---- cd polygene-dist/dev/polygene svn add * --force -svn commit -m "polygene: upload to dist/dev/polygene" +svn commit -m "polygene: upload -RC# to dist/dev/polygene" ---- @@ -447,10 +428,6 @@ The vote is open for the next 72 hours and passes if a majority of at least thre [ ] 0 I don't have a strong opinion about this, but I assume it's ok [ ] -1 Do not release Apache Polygene (Java Edition) because... -Here is my vote: - -+1 (binding) - Cheers ---- @@ -500,14 +477,6 @@ Put them in a directory: [source,shell] ---- cd polygene-check-rc -wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java--RC#-bin.tgz -wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java--RC#-bin.tgz.MD5 -wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java--RC#-bin.tgz.SHA-512 -wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java--RC#-bin.tgz.asc -wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java--RC#-bin.zip -wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java--RC#-bin.zip.MD5 -wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java--RC#-bin.zip.SHA-512 -wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java--RC#-bin.zip.asc wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java--RC#-src.tgz wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java--RC#-src.tgz.MD5 wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java--RC#-src.tgz.SHA-512 @@ -526,8 +495,6 @@ Verify PGP signatures: [source,shell] ---- cd polygene-check-rc -gpg apache-polygene-java--RC#-bin.tgz.asc -gpg apache-polygene-java--RC#-bin.zip.asc gpg apache-polygene-java--RC#-src.tgz.asc gpg apache-polygene-java--RC#-src.zip.asc ---- @@ -540,8 +507,6 @@ Verify MD5 checksum: [source,shell] ---- cd polygene-check-rc -echo "$(cat apache-polygene-java--RC#-bin.tgz.MD5) apache-polygene-java--RC#-bin.tgz" | md5sum -c - -echo "$(cat apache-polygene-java--RC#-bin.zip.MD5) apache-polygene-java--RC#-bin.zip" | md5sum -c - echo "$(cat apache-polygene-java--RC#-src.tgz.MD5) apache-polygene-java--RC#-src.tgz" | md5sum -c - echo "$(cat apache-polygene-java--RC#-src.zip.MD5) apache-polygene-java--RC#-src.zip" | md5sum -c - ---- @@ -554,8 +519,6 @@ Verify SHA-512 checksum: [source,shell] ---- cd polygene-check-rc -echo "$(cat apache-polygene-java--RC#-bin.tgz.MD5) apache-polygene-java--RC#-bin.tgz" | shasum -a 512 -c - -echo "$(cat apache-polygene-java--RC#-bin.zip.MD5) apache-polygene-java--RC#-bin.zip" | shasum -a 512 -c - echo "$(cat apache-polygene-java--RC#-src.tgz.MD5) apache-polygene-java--RC#-src.tgz" | shasum -a 512 -c - echo "$(cat apache-polygene-java--RC#-src.zip.MD5) apache-polygene-java--RC#-src.zip" | shasum -a 512 -c - ---- @@ -656,32 +619,6 @@ svn move "$DIST_DEV_URL/apache-polygene-java--RC#-src.tgz.SHA-5 svn move "$DIST_DEV_URL/apache-polygene-java--RC#-src.tgz.asc" \ "$DIST_RELEASE_URL/apache-polygene-java--src.tgz.asc" \ -m "polygene: promoting release distributions" -# Binary ZIP -svn move "$DIST_DEV_URL/apache-polygene-java--RC#-bin.zip" \ - "$DIST_RELEASE_URL/apache-polygene-java--bin.zip" \ - -m "polygene: promoting release distributions" -svn move "$DIST_DEV_URL/apache-polygene-java--RC#-bin.zip.MD5" \ - "$DIST_RELEASE_URL/apache-polygene-java--bin.zip.MD5" \ - -m "polygene: promoting release distributions" -svn move "$DIST_DEV_URL/apache-polygene-java--RC#-bin.zip.SHA-512" \ - "$DIST_RELEASE_URL/apache-polygene-java--bin.zip.SHA-512" \ - -m "polygene: promoting release distributions" -svn move "$DIST_DEV_URL/apache-polygene-java--RC#-bin.zip.asc" \ - "$DIST_RELEASE_URL/apache-polygene-java--bin.zip.asc" \ - -m "polygene: promoting release distributions" -# Binary TAR.GZ -svn move "$DIST_DEV_URL/apache-polygene-java--RC#-bin.tgz" \ - "$DIST_RELEASE_URL/apache-polygene-java--bin.tgz" \ - -m "polygene: promoting release distributions" -svn move "$DIST_DEV_URL/apache-polygene-java--RC#-bin.tgz.MD5" \ - "$DIST_RELEASE_URL/apache-polygene-java--bin.tgz.MD5" \ - -m "polygene: promoting release distributions" -svn move "$DIST_DEV_URL/apache-polygene-java--RC#-bin.tgz.SHA-512" \ - "$DIST_RELEASE_URL/apache-polygene-java--bin.tgz.SHA-512" \ - -m "polygene: promoting release distributions" -svn move "$DIST_DEV_URL/apache-polygene-java--RC#-bin.tgz.asc" \ - "$DIST_RELEASE_URL/apache-polygene-java--bin.tgz.asc" \ - -m "polygene: promoting release distributions" ---- This produces one commit per file but keep svn history and runs fast, without re-uploading the distributions. @@ -806,7 +743,7 @@ Register the new release at https://reporter.apache.org/[reporter.apache.org] === Announce -Finally, send an announcement to mailto:dev@polygene.apache.org[dev@] and mailto:users@polygene.apache.org[users@] mailing lists. Email announcements should have the subject line: +Finally, send an announcement to mailto:dev@polygene.apache.org[dev@] mailing list. Email announcements should have the subject line: [source,text] ---- @@ -817,7 +754,7 @@ The announcement email should contains the release-notes as text, remember they -== VOTE fails +== VOTE fails or is cancelled === Record failure @@ -846,9 +783,8 @@ Drop distributions, checksums and signatures from https://dist.apache.org/repos/ [source,shell] ---- cd polygene-dist/dev/polygene/ -rm "*-RC#*.*" -svn add * --force -svn commit -m "polygene: dropping -RC# from dist/dev/polygene as the vote failed" +svn rm "*-RC#*.*" +svn commit -m "polygene: dropping -RC# from dist/dev/polygene as the vote failed/was cancelled" ---- Drop NPM packages: