The purpose of this document is to capture and describe the steps involved in producing an official release of Apache NiFi Flow Design System. It is written specifically to someone acting in the capacity of a Release Manager (RM).
Our aim is to produce an official Apache release from an existing release branch.
These documents are necessary for all committers to be familiar with
These documents are necessary for someone acting as the RM
These documents are helpful for general environmental setup to perform releases
Throughout this guide, references must be made to names and values that will vary from release to release. For clarity those variable values have been written like Bash variable references. When a term like “/tmp/src/nifi-fds-${NIFI_FDS_VERSION}
” is seen in an instruction or email template it should be replaced with “/tmp/src/nifi-fds-0.1.0
” when working the release of “Apache NiFi Flow Design System 0.1.0”.
NOTE: The next version should be the next minor version if the release is based on a major version development branch (e.g master or 0.x). The next version should be the next incremental version if the release is based on a minor version development branch (e.g support/nifi-fds-1.1.x or support/nifi-fds-0.7.4). If this is the first incremental release (e.g. 1.2.1) for a minor release line the support branch may need to be created.
The following is a list of the sorts of things that will be validated and are the basics to check when evaluating a release for a vote.
nifi-fds-${NIFI_FDS_VERSION}-sources-release.zip
artifact and ensure these files are present at the root of the archive.This list is reflected in the Release Vote and Release Helper Guide emails that are sent once the release has been staged in the Git and Nexus repositories.
The release process includes steps to be performed by the Release Manager as well as the Apache NiFi Flow Design System developer community.
$ git remote -v asf https://gitbox.apache.org/repos/asf/nifi-fds.git (fetch) asf https://gitbox.apache.org/repos/asf/nifi-fds.git (push) origin https://github.com/${RM_USERID}/nifi-fds.git (fetch) origin https://github.com/${RM_USERID}/nifi-fds.git (push)Additional remotes will not cause a problem if these two are correct. Other configurations are perfectly acceptable but the appropriate adjustments to the steps in this guide must be made by the release manager.
git checkout ${BRANCH}
$ git checkout -b NIFI-FDS-${JIRA_TICKET}-RC${RC} ${BRANCH}
$ npm run clean:install
$ cd target/ $ npm start
Zip up the source.
$ git archive --format zip --prefix=nifi-fds-${NIFI_FDS_VERSION}/ NIFI-FDS-${NIFI_FDS_VERSION}-RC${RC}
Create the tag.
$ git tag NIFI-FDS-${NIFI_FDS_VERSION}-RC${RC}
Push the release branch to the ASF repository.
$ git push asf NIFI-FDS-${JIRA_TICKET}-RC${RC} --tags
From this branch, the ${RC_TAG_COMMIT_ID} will be the 40 byte commit hash with the comment NIFI-FDS-${JIRA_TICKET}-RC${RC} prepare release nifi-fds-${NIFI_FDS_VERSION}-RC${RC}
Create the signature and hashes for the source release and convenience binary files.
--digest-algo=SHA512
select the SHA512 hash algorithm). Configure GPG to always prefer stronger hashes.$ gpg -a -b --digest-algo=SHA512 nifi-fds-${NIFI_FDS_VERSION}-source-release.zip # produces nifi-fds-${NIFI_FDS_VERSION}-source-release.zip.asc
$ shasum -a 1 nifi-fds-${NIFI_FDS_VERSION}-source-release.zip | cut -d" " -f1 > nifi-fds-${NIFI_FDS_VERSION}-source-release.zip.sha1
$ shasum -a 256 nifi-fds-${NIFI_FDS_VERSION}-source-release.zip | cut -d" " -f1 > nifi-fds-${NIFI_FDS_VERSION}-source-release.zip.sha256
$ shasum -a 512 nifi-fds-${NIFI_FDS_VERSION}-source-release.zip | cut -d" " -f1 > nifi-fds-${NIFI_FDS_VERSION}-source-release.zip.sha512
Commit the source release along with their hashes and signatures to https://dist.apache.org/repos/dist/dev/nifi-fds/nifi-fds-${NIFI_FDS_VERSION}
.
If anything isn't correct about the staged artifacts you can delete the local tag in git. If you also delete the local branch then it is as if the release never happened. Before doing that though try to figure out what went wrong so the Release Guide can be updated or corrected if necessary.
After the release source is staged in the repositories it's time for the RM to send a release vote to the NiFi community.
Once the release vote is called for, members of the NiFi FDS developer community have 72 hours to evaluate the RC and cast their vote by replying to the “[VOTE] Release ...” email sent by the RM.
NOTE: The release vote is majority rule vote that must include at least 3 binding +1 votes Apache NiFi PMC members and more positive than negative binding votes.
RM sends a vote request email to the NiFi Developers Mailing List.
dev@nifi.apache.org
${RM_USERID}@apache.org
[VOTE] Release Apache NiFi Flow Design System ${NIFI_FDS_VERSION}
Hello, I am pleased to be calling this vote for the source release of Apache NiFi Flow Design System nifi-fds-${NIFI_FDS_VERSION}. The source zip, including signatures, etc. can be found at: https://dist.apache.org/repos/dist/dev/nifi-fds/nifi-fds-${NIFI_FDS_VERSION} The Git tag is nifi-${NIFI_FDS_VERSION}-RC${RC} The Git commit ID is ${RC_TAG_COMMIT_ID} https://gitbox.apache.org/repos/asf?p=nifi-fds.git;a=commit;h=${RC_TAG_COMMIT_ID} Checksums of nifi-fds-x.y.z-source-release.zip: SHA1: <40-BYTE-SHA1SUM-HASH> SHA256: <64-CHAR-SHA256SUM-HASH> SHA512: <128-CHAR-SHA512SUM-HASH> Release artifacts are signed with the following key: https://people.apache.org/keys/committer/${RM_USERID}.asc KEYS file available here: https://dist.apache.org/repos/dist/release/nifi/KEYS 8 issues were closed/resolved for this release: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12316020&version=12329307 Release note highlights can be found here: https://cwiki.apache.org/confluence/display/NIFI/Release+Notes#ReleaseNotes-Version${NIFI_FDS_VERSION} The vote will be open for 72 hours. Please download the release candidate and evaluate the necessary items including checking hashes, signatures, build from source, and test. The please vote: [ ] +1 Release this package as nifi-fds-${NIFI_FDS_VERSION} [ ] +0 no opinion [ ] -1 Do not release this package because...
RM sends the following helper email to the NiFi Developers Mailing List.
dev@nifi.apache.org
${RM_USERID}@apache.org
Apache NiFi ${NIFI_FDS_VERSION} RC${RC} Release Helper Guide
Hello Apache NiFi community, Please find the associated guidance to help those interested in validating/verifying the release so they can vote. # Download latest KEYS file: https://dist.apache.org/repos/dist/dev/nifi/KEYS # Import keys file: gpg --import KEYS # Pull down nifi-fds-${NIFI_FDS_VERSION} source release artifacts for review: wget https://dist.apache.org/repos/dist/dev/nifi-fds/nifi-fds-${NIFI_FDS_VERSION}/nifi-fds-${NIFI_FDS_VERSION}-source-release.zip wget https://dist.apache.org/repos/dist/dev/nifi-fds/nifi-fds-${NIFI_FDS_VERSION}/nifi-fds-${NIFI_FDS_VERSION}-source-release.zip.asc wget https://dist.apache.org/repos/dist/dev/nifi-fds/nifi-fds-${NIFI_FDS_VERSION}/nifi-fds-${NIFI_FDS_VERSION}-source-release.zip.sha1 wget https://dist.apache.org/repos/dist/dev/nifi-fds/nifi-fds-${NIFI_FDS_VERSION}/nifi-fds-${NIFI_FDS_VERSION}-source-release.zip.sha256 wget https://dist.apache.org/repos/dist/dev/nifi-fds/nifi-fds-${NIFI_FDS_VERSION}/nifi-fds-${NIFI_FDS_VERSION}-source-release.zip.sha512 # Verify the signature gpg --verify nifi-fds-${NIFI_FDS_VERSION}-source-release.zip.asc # Verify the hashes (sha1, sha256, sha512) match the source and what was provided in the vote email thread sha1sum nifi-fds-${NIFI_FDS_VERSION}-source-release.zip sha256sum nifi-fds-${NIFI_FDS_VERSION}-source-release.zip sha512sum nifi-fds-${NIFI_FDS_VERSION}-source-release.zip # Unzip nifi-fds-${NIFI_FDS_VERSION}-source-release.zip # Verify the build works (npm version >= 5.6.0) cd nifi-fds-${NIFI_FDS_VERSION} npm run clean:install # Verify the contents contain a good README, NOTICE, and LICENSE. # Verify the git commit ID is correct # Verify the RC was branched off the correct git commit ID # Run the demo-app and make sure it works as expected cd target npm start # Make sure the README, NOTICE, and LICENSE are present and correct cd node_modules/@nifi-fds/core # Send a response to the vote thread indicating a +1, 0, -1 based on your findings. Thank you for your time and effort to validate the release!
Developers in the community review the release candidate and reply to the vote email with their vote.
After 72 hours if
the vote passes and the release candidate is officially released. If the vote does not pass, corrections are made on the release branch and a new release candidate is put forward for a new vote.
RM sends vote result email.
dev@nifi.apache.org
${RM_USERID}@apache.org
[RESULT][VOTE] Release Apache NiFi Flow Design System ${NIFI_FDS_VERSION}
Apache NiFi Community, I am pleased to announce that the ${NIFI_FDS_VERSION} release of Apache NiFi Flow Design System passes with X +1 (binding) votes Y +1 (non-binding) votes 0 0 votes 0 -1 votes Thanks to all who helped make this release possible. Here is the PMC vote thread: ${VOTE_THREAD_URL}
After the vote is complete and the release is approved, these steps complete the release process.
Move convenience binaries and related artifacts from dist/dev to dist/release:
$ svn move -m "NIFI-FDS-${JIRA_TICKET}" https://dist.apache.org/repos/dist/dev/nifi/nifi-fds/nifi-fds-${NIFI_FDS_VERSION} https://dist.apache.org/repos/dist/release/nifi/nifi-fds/nifi-fds-${NIFI_FDS_VERSION}
Merge the release branch into master.
$ git checkout master $ git merge --no-ff NIFI-FDS-${JIRA_TICKET}-RC${RC} $ git push asf master
Publish to the npm registry
$ npm run publish
Deploy the gh-pages demo
# switch to gh-pages branch $ git remote update $ git checkout gh-pages $ git reset --hard asf/gh-pages # simulate npm install of @nifi-fds/core $ rm -rf ./node_modules/ $ mv ./target/node_modules/ ./ $ rm -rf ./demo-app/ $ mv ./target/demo-app/ ./ # update base href for github.io page $ cp -f ./target/gh-pages.index.html ./index.html $ cp -f ./target/README.md ./README.md $ git add -A . $ git commit -m 'gh-pages update' $ git push asf gh-pages:gh-pages
Update the NiFi Web Page to indicate NEWS of the release as appropriate
In JIRA mark the release version as ‘Released’ and ‘Archived’ through ‘version’ management in the ‘administration’ console.
Create a proper signed tag of the released codebase based on the RC Tag created during the release process.
$ git tag -s rel/nifi-fds-${NIFI_FDS_VERSION} -m "${JIRA_TICKET} signed release tag for approved release of NiFi Flow Design System ${NIFI_FDS_VERSION}" ${RC_TAG_COMMIT_ID}
For instructions on setting up to sign your tag see here.
Push the release tag to the official ASF repository.
$ git push asf rel/nifi-fds-${NIFI_FDS_VERSION}
Update the release notes with the final date of the release.
After the release has been complete for 24 hours send the release announcement.
announce@apache.org
, dev@nifi.apache.org
dev@nifi.apache.org
[ANNOUNCE] Apache NiFi Flow Design System x.y.z release
.Hello The Apache NiFi team would like to announce the release of Apache NiFi Flow Design System ${NIFI_FDS_VERSION}. Apache NiFi Flow Design System is an atomic reusable platform for providing a consistent set of UI/UX components for open source friendly web applications to consume. More details on Apache NiFi can be found here: https://nifi.apache.org/fds.html Issues closed/resolved for this list can be found here: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12316020&version=12329373 Release note highlights can be found here: https://cwiki.apache.org/confluence/display/NIFI/Release+Notes#ReleaseNotes-Version${NIFI_FDS_VERSION} Thank you The Apache NiFi team