YuniKorn Release Procedure

This project provides the instructions and tools needed to generate Apache YuniKorn (Incubating) release artifacts. This obeys ASF release policy, and Podling Release Policy.

Create a Release

  1. Create a release branch for the target release in all git repos, such as branch-0.8
  2. Stabilize the release branch
  3. Create a tag and prepare to generate release candidate 1, e.g release-0.8-rc1
  4. Configure tools/release-configs.json
  5. Run script tools/build-release.json to generate source code tarball

Sign a release

If you haven't signed any releases before, please read the doc:

Generate a Key

Generate a new PGP key (skip this step if you already have a key):

gpg --gen-key

# Real name: your full name
# Email address: your apache email address

Upload the Key to a Public Key Server

gpg --export --armor

then upload to https://pgp.mit.edu/.

You will also need to upload public key files to apache server, https://people.apache.org/keys/.

gpg --fingerprint

then copy the fingerprint to https://id.apache.org/.

Create Signature

// gpg signature
gpg --armor --output apache-yunikorn-0.8.0-incubating-src.tar.gz.asc --detach-sig apache-yunikorn-0.8.0-incubating-src.tar.gz

# checksum
shasum -a 512 apache-yunikorn-0.8.0-incubating-src.tar.gz > apache-yunikorn-0.8.0-incubating-src.tar.gz.sha512

this will create the signature in file apache-yunikorn-incubating-0.8.0-rc1.asc

Verify a Signature

gpg --verify apache-yunikorn-incubating-0.8.0-rc1.asc apache-yunikorn-incubating-0.8.0-rc1.tar.gz

Upload Release Tarball

Make sure your public SSH key is uploaded to https://id.apache.org/. Access sftp server: people.apache.org. Upload the tarball along with the signature to the following dir under user home directory.

/home/${USER}/public_html/${RELEASE_DIR}/

use URL, e.g http://people.apache.org/~wwei/apache-yunikorn-incubating-0.8.0-rc1/ to access the files.

Start Voting Thread

According to podling release doc and release approval doc. Steps are:

  • start a voting thread on dev@yunikorn.apache.org. (72 hours)
  • send a summary of that vote to the Incubator’s general list and request IPMC to vote. (72 hours) Both voting need to acquire at least three +1 votes are required and more +1 votes than -1 votes.