This is an automated email from the ASF dual-hosted git repository.
fokko pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iceberg-python.git
The following commit(s) were added to refs/heads/main by this push:
new 3471c5f docs: Update how to release (#34)
3471c5f is described below
commit 3471c5f43720f96baac46fff3257a5e4aea6a7a2
Author: Fokko Driesprong <[email protected]>
AuthorDate: Tue Oct 3 08:55:17 2023 +0200
docs: Update how to release (#34)
---
mkdocs/docs/how-to-release.md | 16 +++++++++++-----
mkdocs/docs/verify-release.md | 17 +++++++++++++----
2 files changed, 24 insertions(+), 9 deletions(-)
diff --git a/mkdocs/docs/how-to-release.md b/mkdocs/docs/how-to-release.md
index 37af8bb..32e8744 100644
--- a/mkdocs/docs/how-to-release.md
+++ b/mkdocs/docs/how-to-release.md
@@ -57,14 +57,16 @@ Before committing the files to the Apache SVN artifact
distribution SVN hashes n
Go to [Github Actions and run the `Python release`
action](https://github.com/apache/iceberg/actions/workflows/python-release.yml).
**Set the version to master, since we cannot modify the source**. Download the
zip, and sign the files:
```bash
-for name in $(ls release-master/pyiceberg-*.whl
release-master/pyiceberg-*.tar.gz)
+cd release-master/
+
+for name in $(ls pyiceberg-*.whl pyiceberg-*.tar.gz)
do
gpg --yes --armor --local-user [email protected] --output "${name}.asc"
--detach-sig "${name}"
- shasum -a 512 "${name}.asc" > "${name}.asc.sha512"
+ shasum -a 512 "${name}" > "${name}.sha512"
done
```
-Now we can upload the files
+Now we can upload the files from the same directory:
```bash
export SVN_TMP_DIR=/tmp/iceberg-${VERSION_BRANCH}/
@@ -72,7 +74,7 @@ svn checkout https://dist.apache.org/repos/dist/dev/iceberg
$SVN_TMP_DIR
export SVN_TMP_DIR_VERSIONED=${SVN_TMP_DIR}pyiceberg-$VERSION/
mkdir -p $SVN_TMP_DIR_VERSIONED
-cp release-master/* $SVN_TMP_DIR_VERSIONED
+cp * $SVN_TMP_DIR_VERSIONED
svn add $SVN_TMP_DIR_VERSIONED
svn ci -m "PyIceberg ${VERSION}" ${SVN_TMP_DIR_VERSIONED}
```
@@ -92,11 +94,15 @@ Final step is to generate the email to the dev mail list:
```bash
cat << EOF > release-announcement-email.txt
To: [email protected]
-Subject: [VOTE] Release Apache PyIceberg $VERSION_WITHOUT_RC
+Subject: [VOTE] Release Apache PyIceberg $VERSION
Hi Everyone,
I propose that we release the following RC as the official PyIceberg
$VERSION_WITHOUT_RC release.
+A summary of the high level features:
+
+* <Add summary by hand>
+
The commit ID is $LAST_COMMIT_ID
* This corresponds to the tag: $GIT_TAG ($GIT_TAG_HASH)
diff --git a/mkdocs/docs/verify-release.md b/mkdocs/docs/verify-release.md
index 5750d28..e57a05d 100644
--- a/mkdocs/docs/verify-release.md
+++ b/mkdocs/docs/verify-release.md
@@ -47,20 +47,29 @@ gpg --import KEYS
Next, verify the `.asc` file.
```sh
-gpg --verify pyiceberg-0.4.0-py3-none-any.whl.asc
pyiceberg-0.4.0-py3-none-any.whl
+svn checkout
https://dist.apache.org/repos/dist/dev/iceberg/pyiceberg-0.5.0rc1/
/tmp/pyiceberg/
+
+for name in $(ls /tmp/pyiceberg/pyiceberg-*.whl
/tmp/pyiceberg/pyiceberg-*.tar.gz)
+do
+ gpg --verify ${name}.asc ${name}
+done
```
## Verifying checksums
```sh
-shasum -a 512 --check pyiceberg-0.4.0-py3-none-any.whl.sha512
+cd /tmp/pyiceberg/
+for name in $(ls /tmp/pyiceberg/pyiceberg-*.whl.asc.sha512
/tmp/pyiceberg/pyiceberg-*.tar.gz.asc.sha512)
+do
+ shasum -a 512 --check ${name}
+done
```
## Verifying License Documentation
```sh
-tar xzf pyiceberg-0.4.0.tar.gz
-cd pyiceberg-0.4.0
+tar xzf pyiceberg-0.5.0.tar.gz
+cd pyiceberg-0.5.0
```
Run RAT checks to validate license header:
