Versions Compared

Old Version 1

changes.mady.by.user David Handermann

Saved on

compared with

New Version Current

changes.mady.by.user David Handermann

Saved on

Key

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

...

Maven Settings

<settings>
  <servers>
    <server>
      <id>apache.releases.https</id>
      <username>APACHE_USERNAME</username>
      <password>ENCRYPTED_APACHE_PASSWORD</password>
    </server>
    <server>
      <id>repository.apache.org</id>
      <username>APACHE_USERNAME</username>
      <password>ENCRYPTED_APACHE_PASSWORD</password>
    </server>
  </servers>
</settings>

Release Candidate Build

The Release Manager is responsible for creating, signing, and staging artifacts for a Release Candidate build.

...


Code Block
languagebash
titleprepare-email.sh
#!/bin/bash
 
# Load configuration
source ./configuration.sh
 
# Get Apache Nexus Repository number from staging artifacts
REPOSITORIES_URL=https://repository.apache.org
 
# Get Jira Version and Issues
VERSIONS_JSON=$(curl -s https://issues.apache.org/jira/rest/api/2/project/NIFI/versions)
JIRA_VERSION=$(echo ${VERSIONS_JSON}|jq -r ".[] | select(.name==\"nifi-api-${RELEASE_VERSION}\") | .id" )
PROJECT_ID=$(echo ${VERSIONS_JSON}|jq -r ".[] | select(.name==\"nifi-api-${RELEASE_VERSION}\") | .projectId" )
JIRA_RELEASE_NOTES="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=${PROJECT_ID}&version=${JIRA_VERSION}"
 
# Get Total Issues
ISSUES_JSON=$(curl -s https://issues.apache.org/jira/rest/api/2/version/${JIRA_VERSION}/relatedIssueCounts)
TOTAL_ISSUES=$(echo ${ISSUES_JSON}|jq -r ".issuesFixedCount")
 
# Set SHA-512 hash of source release archive
SHA512_HASH=`cat ${WORK_DIR}/${GIT_REPO}/target/${ARTIFACT_ID}-${RELEASE_VERSION}-source-release.zip.sha512`
 
# Change to cloned working directory
cd ${WORK_DIR}/${GIT_REPO}
 
# Get current Git commit ref
GIT_COMMIT_ID=`git rev-parse HEAD`
PROJECT_LABEL="Apache NiFi API"
 
echo """
[VOTE] Release ${PROJECT_LABEL} ${RELEASE_VERSION} (RC${CANDIDATE_NUMBER})
 
Team,
 
I am pleased to be calling this vote for the source release of ${PROJECT_LABEL} ${RELEASE_VERSION}.
 
Please review the following guide for how to verify a release candidate build:
 
https://cwiki.apache.org/confluence/display/NIFI/Release+Candidate+Verification+for+NiFi+API
 
The source being voted on the and the convenience binaries are available on the Apache Distribution Repository:
 
${DIST_DEV_REPO}${ARTIFACT_ID}-${RELEASE_VERSION}
 
The build artifacts are available on the Apache Nexus Repository:
 
${REPOSITORIES_URL}
 
Git Tag: ${GIT_REPO}-${RELEASE_VERSION}-RC${CANDIDATE_NUMBER}
Git Commit ID: ${GIT_COMMIT_ID}
GitHub Commit Link: https://github.com/apache/${GIT_REPO}/commit/${GIT_COMMIT_ID}
 
Hashes of ${ARTIFACT_ID}-${RELEASE_VERSION}-source-release.zip
 
SHA512: ${SHA512_HASH}
 
Release artifacts are signed with the following key:
 
https://people.apache.org/keys/committer/${GIT_COMMITTER_NAME}.asc
 
KEYS file is available on the Apache Distribution Repository:
 
https://dist.apache.org/repos/dist/release/nifi/KEYS
 
Issues resolved for this version: ${TOTAL_ISSUES}
 
${JIRA_RELEASE_NOTES}
 
Release note highlights can be found on the project wiki:
 
https://cwiki.apache.org/confluence/display/NIFI/Release+Notes#ReleaseNotes-NiFiAPIVersion${RELEASE_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. Then please vote:
 
[] +1 Release this package as ${ARTIFACT_ID}-${RELEASE_VERSION}
[] +0 no opinion
[] -1 Do not release this package because...
"""

Release Candidate Voting

Project Management Committee members can cast binding votes that decide whether the release is approved.

Committers and community members can cast non-binding votes that inform the Release Manager and PMC members about the release candidate status.

Release Candidate Cancellation

The Release Manager can cancel a vote in response to negative findings. Cancelling a vote requires sending an email with the word CANCEL in the subject line.

Code Block
[CANCEL][VOTE] Release Apache NiFi API 2.0.0-RC1

Release Candidate Approval

Approving a Release Candidate build requires at least 3 binding positive votes from project PMC members and more positive votes than negative votes.

The Release Manager sends an email to the project Developers Mailing List with the vote results. The Vote Thread ID can be accessed from the Developer Mailing List archives.

Code Block
[RESULT][VOTE] Release Apache NiFi API 2.0.0-RC1

Apache NiFi Community,

I am pleased to announce that the 2.0.0 release of Apache NiFi API passes:

  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 vote thread: https://lists.apache.org/thread/${VOTE_THREAD_ID}

Release Candidate Repository Updates

After a positive release candidate vote, the source branch should be updated.

Create Signed Tag

Create a signed Git tag and push to the source repository.

Code Block
languagebash
titlecreate-tag.sh
#!/bin/bash
 
# Load configuration
source ./configuration.sh
 
# Change to source directory
cd ${WORK_DIR}/${GIT_REPO}
 
# Create signed Git tag
git tag -u ${GIT_SIGNING_KEY} -s ${GIT_RELEASE_TAG} -m "${JIRA_ISSUE} Released version ${RELEASE_VERSION}" ${GIT_CANDIDATE_TAG}
 
# Push tag to source repository
git push upstream ${GIT_RELEASE_TAG}

Merge Changes

Merge version changes from release branch to main branch.

Code Block
languagebash
titlemerge-changes.sh
#!/bin/bash
 
# Load configuration
source ./configuration.sh
 
# Change to source directory
cd ${WORK_DIR}/${GIT_REPO}
 
# Fetch current upstream branch
git fetch upstream
 
# Rebase upstream changes
git checkout ${GIT_SOURCE_BRANCH}
git rebase upstream/${GIT_SOURCE_BRANCH}
 
# Merge changes
git merge --no-ff ${GIT_CANDIDATE_BRANCH} --gpg-sign=${GIT_SIGNING_KEY} -m "${JIRA_ISSUE} Merged ${GIT_CANDIDATE_BRANCH}"
 
# Push changes to source repository
git push upstream ${GIT_SOURCE_BRANCH}

Set Next Version

Set next snapshot version and push to source repository.

Code Block
languagebash
titleset-next-version.sh
#!/bin/bash
 
# Load configuration
source ./configuration.sh
 
# Change to source directory
cd ${WORK_DIR}/${GIT_REPO}
 
# Set Next Snapshot Version
./mvnw versions:set -DgenerateBackupPoms=false -DnewVersion=${NEXT_SNAPSHOT_VERSION}
 
# Commit Version
git commit --gpg-sign=${GIT_SIGNING_KEY} -a --author "${GIT_AUTHOR}" -m "${JIRA_ISSUE} Updated version to ${NEXT_SNAPSHOT_VERSION}"
 
# Push Updated Version
git push upstream

Release Binary Artifacts

The binary release process consists of publishing artifacts through standard distribution channels.

Distribute Binary Release Artifacts

Move the binary release artifacts from the development directory to the release directory.

Code Block
languagebash
titledistribute-binary-artifacts.sh
#!/bin/bash
 
# Load configuration
source ./configuration.sh
 
# Change to distribution directory
cd ${DIST_DIR}
 
# Set locations
DIST_DEV_URL=${DIST_DEV_REPO}/${ARTIFACT_ID}-${RELEASE_VERSION}
DIST_RELEASE_URL=${DIST_RELEASE_REPO}/${ARTIFACT_ID}-${RELEASE_VERSION}
 
# Move binary artifacts with Subversion
svn move -m "${JIRA_ISSUE}" ${DIST_DEV_URL} ${DIST_RELEASE_URL}

Publish Binary Artifacts through Nexus

The Apache Nexus Repository containing the binary artifacts should be marked as Closed and then Released for subsequent distribution through Maven Central.

Update Release Tracking

Jira releases and release notes should be updated to indicate the date of the release.

Update Release Notes

The Apache NiFi Release Notes page should be updated to indicate the date of the release for the associated version.

Update Jira Releases

The Apache NiFi Releases section in Jira should be updated with the date of the release. The Actions menu associated with the release version has item labeled Release that should be selected to set the released status.

Delete Previous Version

Previous release versions should be deleted from the Apache Release Distribution Repository.

Code Block
languagebash
titledelete-previous-version.sh
#!/bin/bash
 
# Load configuration
source ./configuration.sh
 
# Set Previous Version number
PREVIOUS_VERSION="2.0.0"
 
# Set location
PREVIOUS_RELEASE_URL=${DIST_RELEASE_REPO}/${ARTIFACT_ID}-${PREVIOUS_VERSION}
 
# Delete previous artifacts with Subversion
svn delete -m "${JIRA_ISSUE}" ${PREVIOUS_RELEASE_URL}

Announce Release

Send an email to the Apache Announcements List as well as project mailing lists announcing the new version.


Code Block
languagebash
titleannounce-email.sh
#!/bin/bash
 
# Load configuration
source ./configuration.sh
 
# Get Jira Version and Issues
PROJECT_LABEL="Apache NiFi API"
VERSIONS_JSON=$(curl -s https://issues.apache.org/jira/rest/api/2/project/NIFI/versions)
JIRA_VERSION=$(echo ${VERSIONS_JSON}|jq -r ".[] | select(.name==\"nifi-api-${RELEASE_VERSION}\") | .id" )
PROJECT_ID=$(echo ${VERSIONS_JSON}|jq -r ".[] | select(.name==\"nifi-api-${RELEASE_VERSION}\") | .projectId" )
JIRA_RELEASE_NOTES="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=${PROJECT_ID}&version=${JIRA_VERSION}"
 
echo """
[ANNOUNCE] ${PROJECT_LABEL} ${RELEASE_VERSION} Released
 
The Apache NiFi Team is pleased to announce the release of ${PROJECT_LABEL} ${RELEASE_VERSION}.
 
Apache NiFi is an easy to use, powerful, and reliable system to process and distribute data.
 
https://nifi.apache.org
 
The release artifacts can be loaded from the project website.
 
https://nifi.apache.org/download/
 
Maven artifacts have been released and mirrored according to Apache distribution processes.
 
Issues resolved in ${PROJECT_LABEL} ${RELEASE_VERSION} are listed in Jira Release Notes.
  
${JIRA_RELEASE_NOTES}
 
Highlights of the release are available on the project wiki.
 
https://cwiki.apache.org/confluence/display/NIFI/Release+Notes
 
Thank you,
The Apache NiFi Team
"""