Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

    1. git checkout ${RELEASE_BRANCH}
    2. Run mvn version to set the proper rc number in all artifacts
      1. mvn versions:set -DnewVersion=${RELEASE_VERSION}-rc${RC_NUM}
    3. Run Unit tests  and ensure they succeed
      1. mvn test -DskipITs=true
    4. Run Integration Tests and ensure they succeed
      1. mvn verify -DskipUTs=true
    5. Commit and push this change to RELEASE branch
      1. git commit -am “Bumping release candidate number ${RC_NUM}”
      2. git push origin ${RELEASE_BRANCH}
    6. Generate Source Release:
      1. This will create the tarball under hudi/src_release directory
      1. cd hudi/src_release
      2. gpg --verify hudi-${RELEASE_VERSION}-rc${RC_NUM}.src.tgz.asc hudi-${RELEASE_VERSION}-rc${RC_NUM}.src.tgz
        1. You should verify that the signature is good
      3. tar -zxvf hudi-${RELEASE_VERSION}-rc${RC_NUM}.src.tgz && cd hudi-${RELEASE_VERSION}-rc${RC_NUM} && mvn clean package -DskipTests
      4. If they pass, delete the repository we got from the tar-ball
        1. cd ../ && rm -rf hudi-${RELEASE_VERSION}-rc${RC_NUM}
      1. git checkout ${RELEASE_BRANCH}
      2. cd scripts && ./release/create_source_release.sh
      3. Verify Source release is signed and buildable
    7. Create tag 
      1. git tag -s ${RELEASE_VERSION}-rc${RC_NUM} "${RELEASE_VERSION}"
      2. if apache repo is origin.
        1. git push origin ${RELEASE_VERSION}-rc${RC_NUM} 
    8. Deploy maven artifacts and verify
      1. This will deploy jar artifacts to the Apache Nexus Repository, which is the staging area for deploying jars to Maven Central. 
      2. Review all staged artifacts (https://repository.apache.org/). They should contain all relevant parts for each module, including pom.xml, jar, test jar, source, test source, javadoc, etc. Carefully review any new artifacts.
      1. git checkout ${RELEASE_BRANCH}
      2. This will deploy 2.11 artifacts to repository.apache.org
        1. cd scripts && ./release/deploy_staging_jars.sh --scala_version=2.11
      3. This will deploy 2.12 artifacts to repository.apache.org.
        1. ./release/deploy_staging_jars.sh --scala_version=2.12 
      4. Review all staged artifacts to ensure it contains both 2.11 and 2.12 artifacts, mainly hudi-spark-bundle-2.11/2.12, hudi-spark-2.11/2.12, hudi-utilities-bundle_2.11/2.12 and hudi-utilities_2.11/2.12.
      5. Close the staging repository on Apache Nexus. When prompted for a description, enter “Apache Hudi, version ${RELEASE_VERSION}, release candidate ${RC_NUM}”.
    9. Stage source releases on dist.apache.org
      1. If you have not already, check out the Hudi section of the dev repository on dist.apache.org via Subversion. In a fresh directory
      2. if you would not checkout, please try svn checkout https://dist.apache.org/repos/dist/dev/hudi again.
        1. svn checkout https://dist.apache.org/repos/dist/dev/hudi --depth=immediates
      3. Make a directory for the new release:
        1.  mkdir hudi/hudi-${RELEASE_VERSION}-rc${RC_NUM}
      4. Copy Hudi source distributions, hashes, and GPG signature: 
        1. mv <hudi-dir>/src_release/* hudi/hudi-${RELEASE_VERSION}-rc${RC_NUM}
      5. Add and commit all the files. 
        1. cd hudi 
        2. svn add hudi-${RELEASE_VERSION}-rc${RC_NUM}
        3. svn commit
      6. Verify that files are present
      7. Run Verification Script to ensure the source release is sane
        1. cd scripts && ./release/validate_staged_release.sh --release=${RELEASE_VERSION} --rc_num=${RC_NUM} --verbose

...

  1. Maven artifacts deployed to the staging repository of repository.apache.org

  2. Source distribution deployed to the dev repository of dist.apache.org and validated

Vote on the release candidate 

...

  • Voting on dev@hudi group
  • Voting on general@incubator group

Once you have built and individually reviewed the release candidate, please share it for the community-wide(dev@hudi ) review. Please review foundation-wide voting guidelines for more information.

...

From: Release Manager

To: dev@hudi.apache.org or general@incubator.apache.org 

Subject: [VOTE] Release 1.2.3, release candidate #3

 

Hi everyone,

Please review and vote on the release candidate #3 for the version 1.2.3, as follows:

[ ] +1, Approve the release

[ ] -1, Do not approve the release (please provide specific comments)

 

The complete staging area is available for your review, which includes:

* JIRA release notes [1],

* the official Apache source release and binary convenience releases to be deployed to dist.apache.org [2], which are signed with the key with fingerprint FFFFFFFF [3],

* all artifacts to be deployed to the Maven Central Repository [4],

* source code tag "release-1.2.3-rc3" [5],

 

The vote will be open for at least 72 hours. It is adopted by majority approval, with at least 3 PMC affirmative votes.

 

Thanks,

Release Manager

 

[1] link

[2] link

[3] https://dist.apache.org/repos/dist/release/hudi/KEYS

[4] link

[5] link

[6] link

...

  1. change the version from ${RELEASE_VERSION}-rc${RC_NUM} to ${RELEASE_VERSION} against release branch, use command `mvn versions:set -DnewVersion=${RELEASE_VERSION}`, e.g. change 0.5.1-rc1 to 0.5.1.
  2. Repeat the steps from Generate Source Release(f) to Stage source releases on dist.apache.org(i). Note that make sure remove the -rc${RC_NUM} suffix when repeat the above steps. and please also verify the steps. 
  3. One more step is to deploy source code to release dist. https://dist.apache.org/repos/dist/release/hudi.
    1. svn checkout https://dist.apache.org/repos/dist/release/hudi --depth=immediates, if you would not checkout, please try svn checkout https://dist.apache.org/repos/dist/release/hudi again.
    2. Make a directory for the new release:
      1.  mkdir hudi/hudi-${RELEASE_VERSION}
    3. Copy Hudi source distributions, hashes, and GPG signature: 
      1. mv <hudi-dir>/src_release/* hudi/hudi-${RELEASE_VERSION}
    4. Add and commit all the files. 
      1. cd hudi 
      2. svn add hudi-${RELEASE_VERSION}
      3. svn commit
    5. Verify that files are present
  4. Use the Apache Nexus repository to release the staged binary artifacts to the Maven Central repository. In the Staging Repositories section, find the relevant release candidate orgapachehudi-XXX entry and click Release. Drop all other release candidates that are not being released.
  5. In Jira, go to Releases → <Release Version> and ensure that all Jiras for the release are 'Closed' state, if not transition all 'Resolved' jiras to 'Closed'.
  6. Finalize the Release in Jira by providing the release date. 
  7. Update DOAP file in the root of the project via sending a PR like this one.

...

Steps to cut doc version and update website.

  1. Follow the  instructions for cutting a doc for this new release.
  2. Build the site locally  and ensure the new doc version is available as intended.
  3. Update site using instructions

Add download links for the new release to the website ?? 

Promote the release

Once the release has been finalized, the last step of the process is to promote the release within the project and beyond. Please wait for 24h after finalizing the release in accordance with the ASF release policy.

...