To create a release candidate, you will need:
Nexus credentials are configured in your personal
~/.gradle/gradle.properties file using
The release scripts use the command-line
gpg utility so that signing can use the gpg-agent and does not require writing your private key’s passphrase to a configuration file.
To configure gradle to sign convenience binary artifacts, add the following settings to
signing.gnupg.keyName=Your Name (CODE SIGNING KEY)
gpg instead of
gpg2, also set
For more information, see the Gradle signing documentation.
Creating a release candidate¶
Build the source release¶
To create the source release artifacts, run the
source-release.sh script with the release version and release candidate number:
dev/source-release.sh 0.8.1 0
Preparing source for apache-iceberg-0.8.1-rc0 ... Success! The release candidate is available here: https://dist.apache.org/repos/dist/dev/iceberg/apache-iceberg-0.8.1-rc0/ Commit SHA1: 4b4716c76559b3cdf3487e6b60ab52950241989b
The source release script will create a candidate tag based on the HEAD revision in git and will prepare the release tarball, signature, and checksum files. It will also upload the source artifacts to SVN.
Note the commit SHA1 and candidate location because those will be added to the vote thread.
Once the source release is ready, use it to stage convenience binary artifacts in Nexus.
Build and stage convenience binaries¶
Convenience binaries are created using the source release tarball from in the last step.
Untar the source release and go into the release directory:
tar xzf apache-iceberg-0.8.1.tar.gz cd apache-iceberg-0.8.1
To build and publish the convenience binaries, run the
dev/stage-binaries.sh script. This will push to a release staging repository.
Next, you need to close the staging repository:
- Go to Nexus and log in
- In the menu on the left, choose “Staging Repositories”
- Select the Iceberg repository
- At the top, select “Close” and follow the instructions
- In the comment field use “Apache Iceberg <version> RC<num>“
Start a VOTE thread¶
The last step for a candidate is to create a VOTE thread on the dev mailing list.
Subject: [VOTE] Release Apache Iceberg <VERSION> RC<NUM>
Hi everyone, I propose the following RC to be released as official Apache Iceberg <VERSION> release. The commit id is <SHA1> * This corresponds to the tag: apache-iceberg-<VERSION>-rc<NUM> * https://github.com/apache/iceberg/commits/apache-iceberg-<VERSION>-rc<NUM> * https://github.com/apache/iceberg/tree/<SHA1> The release tarball, signature, and checksums are here: * https://dist.apache.org/repos/dist/dev/iceberg/apache-iceberg-<VERSION>-rc<NUM>/ You can find the KEYS file here: * https://dist.apache.org/repos/dist/dev/iceberg/KEYS Convenience binary artifacts are staged in Nexus. The Maven repository URL is: * https://repository.apache.org/content/repositories/orgapacheiceberg-<ID>/ This release includes important changes that I should have summarized here, but I'm lazy. Please download, verify, and test. Please vote in the next 72 hours. [ ] +1 Release this as Apache Iceberg <VERSION> [ ] +0 [ ] -1 Do not release this because...
Finishing the release¶
After the release vote has passed, you need to release the last candidate’s artifacts.
First, copy the source release directory to releases:
mkdir iceberg cd iceberg svn co https://dist.apache.org/repos/dist/dev/iceberg candidates svn co https://dist.apache.org/repos/dist/release/iceberg releases cp -r candidates/apache-iceberg-<VERSION>-rcN/ releases/apache-iceberg-<VERSION> cd releases svn add apache-iceberg-<VERSION> svn ci -m 'Iceberg: Add release <VERSION>'
Next, add a release tag to the git repository based on the passing candidate tag:
git tag -am 'Release Apache Iceberg <VERSION>' apache-iceberg-<VERSION> apache-iceberg-<VERSION>-rcN
Then release the candidate repository in Nexus.
To announce the release, wait until Maven central has mirrored the Apache binaries, then update the Iceberg site and send an announcement email:
[ANNOUNCE] Apache Iceberg release <VERSION>
I'm please to announce the release of Apache Iceberg <VERSION>! Apache Iceberg is an open table format for huge analytic datasets. Iceberg delivers high query performance for tables with tens of petabytes of data, along with atomic commits, concurrent writes, and SQL-compatible table evolution. This release can be downloaded from: https://www.apache.org/dyn/closer.cgi/iceberg/<TARBALL NAME WITHOUT .tar.gz>/<TARBALL NAME> Java artifacts are available from Maven Central. Thanks to everyone for contributing!