parquet-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From w...@apache.org
Subject parquet-cpp git commit: PARQUET-998: Replace defunct release script through README
Date Sun, 16 Jul 2017 21:35:41 GMT
Repository: parquet-cpp
Updated Branches:
  refs/heads/master 18b504482 -> a60529766


PARQUET-998: Replace defunct release script through README

Author: Uwe L. Korn <uwe@apache.org>

Closes #373 from xhochy/PARQUET-998 and squashes the following commits:

d968763 [Uwe L. Korn] PARQUET-998: Replace defunct release script through README


Project: http://git-wip-us.apache.org/repos/asf/parquet-cpp/repo
Commit: http://git-wip-us.apache.org/repos/asf/parquet-cpp/commit/a6052976
Tree: http://git-wip-us.apache.org/repos/asf/parquet-cpp/tree/a6052976
Diff: http://git-wip-us.apache.org/repos/asf/parquet-cpp/diff/a6052976

Branch: refs/heads/master
Commit: a60529766b0d250c1da30ac2c580abb2707e2f80
Parents: 18b5044
Author: Uwe L. Korn <uwe@apache.org>
Authored: Sun Jul 16 17:35:37 2017 -0400
Committer: Wes McKinney <wes.mckinney@twosigma.com>
Committed: Sun Jul 16 17:35:37 2017 -0400

----------------------------------------------------------------------
 dev/release/README.md |  30 ++++++
 dev/release/release   | 250 ---------------------------------------------
 2 files changed, 30 insertions(+), 250 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/parquet-cpp/blob/a6052976/dev/release/README.md
----------------------------------------------------------------------
diff --git a/dev/release/README.md b/dev/release/README.md
new file mode 100644
index 0000000..d9860cd
--- /dev/null
+++ b/dev/release/README.md
@@ -0,0 +1,30 @@
+<!---
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License. See accompanying LICENSE file.
+-->
+
+
+How to release
+==============
+
+1. Do a fresh `git clone` of the repository using the ASF git as origin.
+2. Set the git author to your gpg signing key.
+3. Create an RC using `./dev/release/release-candidate -r <rcNum> -v <version>`
starting with `rcNum=0`.
+   You could first do a dry-run by adding `-p` at the end.
+4. Check that the uploaded RC is valid using `./dev/release/verify-release-candidate <version>
<rcNum>`.
+5. Send the generated mail to dev@parquet.apache.org.
+6. Wait for the vote to end, either proceed to the next step or abort the RC and continue
with the
+   necessary fixes.
+7. In the release SVN, copy the contents of the RC folder into the release folder.
+8. Delete the previous `parquet-cpp` release from SVN.
+9. Cherry-pick the commits in the `master-after-X` branch into master.
+10. Send out the release mail to `dev@parquet.apache.org` and `announce@apache.org`.

http://git-wip-us.apache.org/repos/asf/parquet-cpp/blob/a6052976/dev/release/release
----------------------------------------------------------------------
diff --git a/dev/release/release b/dev/release/release
deleted file mode 100755
index 61c294f..0000000
--- a/dev/release/release
+++ /dev/null
@@ -1,250 +0,0 @@
-#!/bin/bash
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-#
-# This script is used to publish the official release after a successful
-# vote of a release-candidate.
-
-set -e
-set -o nounset
-
-parquetcpp_git_web_url='https://git-wip-us.apache.org/repos/asf?p=parquet-cpp.git'
-parquet_svn_dist_url='https://dist.apache.org/repos/dist/release/parquet'
-parquet_svn_dev_dist_url='https://dist.apache.org/repos/dist/dev/parquet'
-
-function print_help_and_exit {
-cat <<EOF
-Apache Parquet C++ release tool.
-
-Usage: $0 [-h] [-r #] [-p | publish]
-
-  -h   Print this help message and exit
-  -r   Release candidate number (default: 0)
-  -p   Publish (default: dry-run (does not publish anything))
-EOF
-exit 0
-}
-
-publish=0
-rc_tag_version=0
-while getopts ":hl:r:p" opt; do
-  case $opt in
-    r)
-      rc_tag_version=${OPTARG}
-      ;;
-    p)
-      publish=1
-      ;;
-    h)
-      print_help_and_exit
-      ;;
-    *  )
-      echo "Unknown option: -$OPTARG"
-      print_help_and_exit
-      ;;
-  esac
-done
-
-shift $(($OPTIND - 1))
-if [[ "${1:-dry-run}" == "publish" ]]; then
-  publish=1
-fi
-
-# Update local repository
-git fetch --all -q
-git fetch --tags -q
-
-# Ensure that a signing key is available
-if [[ -z "`git config user.signingkey`" ]]; then
-  cat <<EOF
-Error: No GPG signing key can be found within gitconfig.
-
-To configure one, find your code signing key's ID with
-
-   gpg --list-secret-keys
-
-Then configure it as the signing key for this repository with
-
-   git config --global user.signingkey YOUR_KEY_ID
-EOF
-  exit 1
-fi
-
-# Set the base dir for the script to be the top level of the repository
-base_dir=$(git rev-parse --show-toplevel)
-# Verify that this is a clean repository
-if [[ -n "`git status --porcelain`" ]]; then
-  echo "ERROR: Please run from a clean master."
-  exit 1
-elif [[ "`git rev-parse --abbrev-ref HEAD`" == "master" ]]; then
-  echo "ERROR: This script must be run from the released branch."
-  exit 1
-fi
-
-if [[ "$base_dir" != "$PWD" ]]; then
-  echo "Warrning: This script must be run from the root of the repository ${base_dir}"
-  cd $base_dir
-fi
-
-# Make sure that this is not on a snapshot release
-current_version=$(cat .parquetcppversion | tr '[a-z]' '[A-Z]')
-if [[ $current_version =~ .*-SNAPSHOT ]]; then
-  echo "ERROR: .parquetcppversion can not be a 'SNAPSHOT', it is ${current_version}"
-  exit 1
-else
-  major=`echo $current_version | cut -d. -f1`
-  minor=`echo $current_version | cut -d. -f2`
-  patch=`echo $current_version | cut -d. -f3 | cut -d- -f1`
-
-  current_version="${major}.${minor}.${patch}"
-fi
-
-previous_version_tag="${current_version}-rc${rc_tag_version}"
-current_version_tag="rel/${current_version}"
-
-# Make sure the tag does not exist
-if [[ $(git ls-remote --exit-code --tags origin refs/tags/${current_version} >/dev/null
2>&1) == 0 ]]; then
-  echo "ERROR: ${current_version} tag exists."
-  exit 1
-fi
-
-# All check are now complete, before we start alert if we are in dry-run
-if [[ $publish == 0 ]]; then
-  echo "Performing dry-run"
-fi
-
-dist_name="apache-parquet-cpp-${current_version}"
-
-if [[ $publish == 1 ]]; then
-  # Create release branch and tag and push them to the origin
-  echo "Creating ${current_version_tag} staging branch"
-  git checkout -b "stage_${current_version_tag}"
-
-  # Increment the version and create a branch
-  echo ${current_version} > .parquetcppversion
-  git add .parquetcppversion
-  git commit -m "Updating .parquetcppversion to release version ${current_version}."
-  git tag -s "${current_version_tag}" \
-    -m "Apache Parquet C++ ${current_version} release" HEAD
-  git push origin "${current_version_tag}"
-fi
-
-dist_dir=${base_dir}/dist
-rc_dir=${dist_dir}/rc
-release_dir=${dist_dir}/${current_version}
-mkdir -p ${rc_dir}
-cd ${dist_dir}
-
-# Checkout the release candidate
-svn co ${parquet_svn_dev_dist_url}/${previous_version_tag} ${rc_dir} >/dev/null 2>&1
-
-if [[ $publish == 1 ]]; then
-  echo "Publishing the release"
-  # Make the release dist directory and check it out
-  svn mkdir ${parquet_svn_dist_url}/${current_version} -m "parquet-cpp-${current_version}
release"
-  svn co --depth=empty ${parquet_svn_dist_url}/${current_version} ${release_dir}
-else
-  mkdir ${release_dir}
-fi
-
-cd ${release_dir}
-
-# Rename the .parquetcppversion from -RC[:digit:] to release current_version and repackage
the release
-tar -xzf ${rc_dir}/apache-parquet-cpp-*.tar.gz
-mv apache-parquet-cpp-* ${dist_name}
-echo ${current_version} > ${dist_name}/.parquetcppversion
-tar -czf ${dist_name}.tar.gz ${dist_name}
-rm -rf ${dist_name}
-
-# Sign the tarball.
-echo "Signing the distribution"
-gpg --armor --output ${dist_name}.tar.gz.asc --detach-sig ${dist_name}.tar.gz
-
-# Create the checksums
-echo "Creating checksums"
-gpg --print-md MD5 ${dist_name}.tar.gz > ${dist_name}.tar.gz.md5
-shasum ${dist_name}.tar.gz > ${dist_name}.tar.gz.sha
-
-if [[ $publish == 1 ]]; then
-  # Commit the release
-  svn add ${dist_name}*
-  svn ci -m "parquet-cpp-${current_version} release"
-fi
-
-cd ${base_dir}
-
-echo
-echo "Done creating the release. The following draft email has been created"
-echo "to send to the dev@parquet.apache.org mailing list."
-echo
-
-# Create the email template for the release to be sent to the mailing lists.
-MESSAGE=$(cat <<__EOF__
-To: dev@parquet.apache.org
-Subject: [RESULT][VOTE] Release Apache Parquet C++ ${current_version} RC${rc_tag_version}
-
-All,
-The vote to accept Apache Parquet C++ ${current_version} RC${rc_tag_version}
-as the official Apache Parquet C++ ${current_version} release has passed.
-
-
-+1 (Binding)
-------------------------------
-
-
-+1 (Non-binding)
-------------------------------
-
-
-There were no 0 or -1 votes. Thank you to all who helped make this release.
-
-
-Parquet C++ ${current_version} includes the following:
----
-The CHANGELOG for the release is available at:
-${parquetcpp_git_web_url}&f=CHANGELOG&hb=${current_version_tag}
-
-The tag used to create the release with is ${current_version_tag}:
-${parquetcpp_git_web_url}&a=shortlog&h=refs/tags/${current_version_tag}
-
-The release is available at:
-${parquet_svn_dist_url}/${current_version}/${dist_name}.tar.gz
-
-The MD5 checksum of the release can be found at:
-${parquet_svn_dist_url}/${current_version}/${dist_name}.tar.gz.md5
-
-The signature of the release can be found at:
-${parquet_svn_dist_url}/${current_version}/${dist_name}.tar.gz.asc
-
-The GPG key used to sign the release are available at:
-${parquet_svn_dist_url}/KEYS
-
-__EOF__
-)
-echo "--------------------------------------------------------------------------------"
-echo
-echo "${MESSAGE}"
-echo
-echo "--------------------------------------------------------------------------------"
-echo
-
-# Print reset instructions if this was a dry-run
-if [[ $publish == 0 ]]; then
-  echo
-  echo "This is a dry run, nothing has been published."
-  echo
-  echo "To clean up run: rm -rf ${dist_dir}"
-fi
-
-exit 0


Mime
View raw message