You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@parquet.apache.org by ga...@apache.org on 2019/10/29 16:25:27 UTC
[parquet-site] 04/12: [Parquet] Update release docs for TLP.
This is an automated email from the ASF dual-hosted git repository.
gabor pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/parquet-site.git
commit 01ae1673ba86e47dd44f5b4f99e7357e5cf5e07e
Author: Ryan Blue <bl...@apache.org>
AuthorDate: Fri May 15 18:20:33 2015 +0000
[Parquet] Update release docs for TLP.
git-svn-id: https://svn.apache.org/repos/asf/parquet/site@1679615 13f79535-47bb-0310-9956-ffa450edef68
---
publish/documentation/how-to-release/index.html | 24 ++++++++++++-----------
source/documentation/how-to-release.html.md | 26 ++++++++++++++-----------
2 files changed, 28 insertions(+), 22 deletions(-)
diff --git a/publish/documentation/how-to-release/index.html b/publish/documentation/how-to-release/index.html
index b8c0336..394e3d0 100644
--- a/publish/documentation/how-to-release/index.html
+++ b/publish/documentation/how-to-release/index.html
@@ -126,6 +126,8 @@
<p>Make sure you have permission to deploy Parquet artifacts to Nexus by pushing a snapshot:</p>
<pre class="highlight text">mvn deploy
</pre>
+<p>If you have problems, read the <a href="https://www.apache.org/dev/publishing-maven-artifacts.html">publishing Maven artifacts documentation</a></p>
+
<h3 id="release-process">Release process</h3>
<p>Parquet uses the maven-release-plugin to tag a release and push binary artifacts to staging in Nexus. Once maven completes the release, the offical source tarball is built from the tag.</p>
@@ -163,7 +165,7 @@
<li>Go to <a href="https://repository.apache.org/">Nexus</a>.</li>
<li>In the menu on the left, choose “Staging Repositories”.</li>
<li>Select the Parquet repository.</li>
-<li>At the top, click “Close”.</li>
+<li>At the top, click “Close” and follow the instructions. For the comment use “Apache Parquet [Format] <VERSION> <RC>”.</li>
</ol>
<h4 id="4.-run-the-source-tarball-script">4. Run the source tarball script</h4>
@@ -171,31 +173,31 @@
</pre>
<p>This script builds the source tarball from the release tag’s SHA1, signs it, and uploads the necessary files with SVN.</p>
-<p>The source release is pushed to <a href="https://dist.apache.org/repos/dist/dev/incubator/parquet/">https://dist.apache.org/repos/dist/dev/incubator/parquet/</a></p>
+<p>The source release is pushed to <a href="https://dist.apache.org/repos/dist/dev/parquet/">https://dist.apache.org/repos/dist/dev/parquet/</a></p>
<p>The last message from the script is the release commit’s SHA1 hash and URL for the VOTE e-mail.</p>
-<h4 id="5.-send-a-vote-e-mail-to-dev@parquet.incubator.apache.org">5. Send a VOTE e-mail to <a href="mailto:dev@parquet.incubator.apache.org">dev@parquet.incubator.apache.org</a></h4>
+<h4 id="5.-send-a-vote-e-mail-to-dev@parquet.apache.org">5. Send a VOTE e-mail to <a href="mailto:dev@parquet.apache.org">dev@parquet.apache.org</a></h4>
<p>Here is a template you can use. Make sure everything applies to your release.</p>
-<pre class="highlight text">Subject: Release Apache Parquet Format (Incubating) <VERSION> RC<NUM>
+<pre class="highlight text">Subject: [VOTE] Release Apache Parquet <VERSION> RC<NUM>
</pre><pre class="highlight text">Hi everyone,
I propose the following RC to be released as official Apache Parquet <VERSION> release.
The commit id is <SHA1>
-* This corresponds to the tag: apache-parquet-format-<VERSION>
-* https://github.com/apache/incubator-parquet-format/tree/<SHA1>
-* https://git-wip-us.apache.org/repos/asf/incubator/repo?p=incubator-parquet-format.git&a=commit&h=<SHA1>
+* This corresponds to the tag: apache-parquet-<VERSION>
+* https://github.com/apache/parquet-format/tree/<SHA1>
+* https://git-wip-us.apache.org/repos/asf/projects/repo?p=parquet-mr.git&a=commit&h=<SHA1>
The release tarball, signature, and checksums are here:
-* https://dist.apache.org/repos/dist/dev/incubator/parquet/<PATH>
+* https://dist.apache.org/repos/dist/dev/parquet/<PATH>
You can find the KEYS file here:
-* https://dist.apache.org/repos/dist/dev/incubator/parquet/KEYS
+* https://dist.apache.org/repos/dist/dev/parquet/KEYS
Binary artifacts are staged in Nexus here:
-* https://repository.apache.org/content/groups/staging/org/apache/parquet/parquet-format/
+* https://repository.apache.org/content/groups/staging/org/apache/parquet/parquet/
This release includes important changes that I should have summarized here, but I'm lazy.
@@ -203,7 +205,7 @@ Please download, verify, and test.
Please vote by <72 HOUR FROM NOW>
-[ ] +1 Release this as Apache Parquet Format <VERSION>
+[ ] +1 Release this as Apache Parquet <VERSION>
[ ] +0
[ ] -1 Do not release this because...
diff --git a/source/documentation/how-to-release.html.md b/source/documentation/how-to-release.html.md
index 9ad0620..144d7ca 100644
--- a/source/documentation/how-to-release.html.md
+++ b/source/documentation/how-to-release.html.md
@@ -13,6 +13,10 @@ Make sure you have permission to deploy Parquet artifacts to Nexus by pushing a
mvn deploy
```
+If you have problems, read the [publishing Maven artifacts documentation][publish-maven-docs]
+
+[publish-maven-docs]: https://www.apache.org/dev/publishing-maven-artifacts.html
+
### Release process
Parquet uses the maven-release-plugin to tag a release and push binary artifacts to staging in Nexus. Once maven completes the release, the offical source tarball is built from the tag.
@@ -52,7 +56,7 @@ Closing a staging repository makes the binaries available in [staging][staging],
1. Go to [Nexus][nexus].
2. In the menu on the left, choose "Staging Repositories".
3. Select the Parquet repository.
-4. At the top, click "Close".
+4. At the top, click "Close" and follow the instructions. For the comment use "Apache Parquet [Format] <VERSION> <RC>".
#### 4. Run the source tarball script
@@ -62,16 +66,16 @@ sh dev/source-release.sh <version> <rc-number>
This script builds the source tarball from the release tag's SHA1, signs it, and uploads the necessary files with SVN.
-The source release is pushed to https://dist.apache.org/repos/dist/dev/incubator/parquet/
+The source release is pushed to https://dist.apache.org/repos/dist/dev/parquet/
The last message from the script is the release commit's SHA1 hash and URL for the VOTE e-mail.
-#### 5. Send a VOTE e-mail to dev@parquet.incubator.apache.org
+#### 5. Send a VOTE e-mail to dev@parquet.apache.org
Here is a template you can use. Make sure everything applies to your release.
```
-Subject: Release Apache Parquet Format (Incubating) <VERSION> RC<NUM>
+Subject: [VOTE] Release Apache Parquet <VERSION> RC<NUM>
```
```
Hi everyone,
@@ -79,18 +83,18 @@ Hi everyone,
I propose the following RC to be released as official Apache Parquet <VERSION> release.
The commit id is <SHA1>
-* This corresponds to the tag: apache-parquet-format-<VERSION>
-* https://github.com/apache/incubator-parquet-format/tree/<SHA1>
-* https://git-wip-us.apache.org/repos/asf/incubator/repo?p=incubator-parquet-format.git&a=commit&h=<SHA1>
+* This corresponds to the tag: apache-parquet-<VERSION>
+* https://github.com/apache/parquet-format/tree/<SHA1>
+* https://git-wip-us.apache.org/repos/asf/projects/repo?p=parquet-mr.git&a=commit&h=<SHA1>
The release tarball, signature, and checksums are here:
-* https://dist.apache.org/repos/dist/dev/incubator/parquet/<PATH>
+* https://dist.apache.org/repos/dist/dev/parquet/<PATH>
You can find the KEYS file here:
-* https://dist.apache.org/repos/dist/dev/incubator/parquet/KEYS
+* https://dist.apache.org/repos/dist/dev/parquet/KEYS
Binary artifacts are staged in Nexus here:
-* https://repository.apache.org/content/groups/staging/org/apache/parquet/parquet-format/
+* https://repository.apache.org/content/groups/staging/org/apache/parquet/parquet/
This release includes important changes that I should have summarized here, but I'm lazy.
@@ -98,7 +102,7 @@ Please download, verify, and test.
Please vote by <72 HOUR FROM NOW>
-[ ] +1 Release this as Apache Parquet Format <VERSION>
+[ ] +1 Release this as Apache Parquet <VERSION>
[ ] +0
[ ] -1 Do not release this because...