project = EAGLE AND status not in (Open,"In Progress",Reopened) AND fixVersion is EMPTY ORDER BY priority DESC

project = EAGLE AND status not in (Open,"In Progress",Reopened) AND resolution not in ("Not A Problem",Duplicate,"Cannot Reproduce",Invalid,Unresolved) AND fixVersion is EMPTY ORDER BY priority DESC

project = EAGLE AND status in (Open, "In Progress", Reopened) AND fixVersion = $RELEASE_VERSION ORDER BY updatedDate DESC

# GOAL: check a branch based on remote develop branch
# $BRANCH_NAME: placeholder for branch name
# $APACHE_EAGLE_REPO: placeholder for git remote repo alias, should be pointing to
#     https://git-wip-us.apache.org/repos/asf/incubator-eagle.git
git fetch $APACHE_EAGLE_REPO
git checkout -b $BRANCH_NAME $APACHE_EAGLE_REPO/develop

# GOAL: check HEAD
# $BRANCH_NAME: placeholder for branch name
git log --decorate --graph $BRANCH_NAME, HEAD

# GOAL: push the creation of the branch to remote
# $BRANCH_NAME: placeholder for branch name
# $APACHE_EAGLE_REPO: placeholder for git remote repo alias, should be pointing to
#     https://git-wip-us.apache.org/repos/asf/incubator-eagle.git
git push $APACHE_EAGLE_REPO $BRANCH_NAME:$BRANCH_NAME

# GOAL: set version for project and its sub-modules
# $VERSION: placeholder for version, e.g. 0.4.0-incubating
mvn versions:set -DnewVersion=$VERSION -DgenerateBackupPoms=false

# GOAL: set version for project and its sub-modules
# $OLD_VERSION: placeholder for old version, e.g. 0.3.0-incubating
# $VERSION: placeholder for version, e.g. 0.4.0-incubating
find . -name pom.xml | xargs sed -i "" -e "s/$OLD_VERSION-SNAPSHOT/$VERSION/"

--------------------------------------
To: dev@eagle.incubator.apache.org
--------------------------------------
Subject: New release branch created: $RELEASE_BRANCH_NAME
--------------------------------------
Hi $RECIPIENT,

I've just created new release branch for upcoming $VERSION release.

Project version in develop branch has been changed to $NEW_SNAPSHOT_VERSION, please apply the update and continue opening Pull Requests to develop branch as usual. I'll cherry-pick commits to $RELEASE_BRANCH_NAME on per needed basis.
 
For hot bug fixes, please open Pull Requests to $RELEASE_BRANCH_NAME.
 
Thanks,
$RM

mvn apache-rat:check

# GOAL: build and test, make sure that the project can 
#       be built successfully and unit tests all pass;
#       otherwise, make changes in normal bug fix ways
#       and loop to re-build & re-test, until passed.
mvn clean test
 
# GOAL: if any changes are made, make sure again it 
#       passes license check
mvn apache-rat:check 

# GOAL: create tag
# $VERSION: placeholder for target release version, e.g. 0.4.0-incubating
# $N: placeholder for ordinal number of release candidate, e.g. 1, 2, etc.
git tag -s -a v$VERSION-rc$N -m "Apache Eagle $VERSION release candidate $N"

# GOAL: push tag to remote repo
# $APACHE_EAGLE_REPO: placeholder for git remote repo alias, should be pointing to
#     https://git-wip-us.apache.org/repos/asf/incubator-eagle.git
# $TAG_NAME: placeholder for tag name, e.g. v0.4.0-incubating-rc1
git push $APACHE_EAGLE_REPO $TAG_NAME

# GOAL: archive source code to a tar ball
# $VERSION: placeholder for target release version, e.g. 0.4.0-incubating
# $N: placeholder for ordinal number of release candidate, e.g. 1, 2, etc.
git archive --format=tar --prefix=apache-eagle-$VERSION-src/ HEAD | gzip > ./apache-eagle-$VERSION-src-rc$N.tar.gz

# suppose we have copied tar ball to the dedicated directory
cd /tmp/prepared-release-0.4.0-incubating
 
# $VERSION: placeholder for target release version, e.g. 0.4.0-incubating
gunzip -c apache-eagle-$VERSION-src.tar.gz | tar xopf - 
 
git clone https://git-wip-us.apache.org/repos/asf/incubator-eagle.git
 
cd incubator-eagle
 
# $TAG_NAME: placeholder for tag name, e.g. v0.4.0-incubating-rc1
git checkout tags/$TAG_NAME
 
cd ..
 
# GOAL: make sure nothing in the tar ball is different from source code downloaded from git repo
# $VERSION: placeholder for target release version, e.g. 0.4.0-incubating
diff -r incubator-eagle apache-eagle-$VERSION-src --exclude=".git"
 
# $VERSION: placeholder for target release version, e.g. 0.4.0-incubating
cd apache-eagle-$VERSION-src
 
mvn clean install

* All artifacts must be signed and check-summed. In order to sign a release we will need an OpenPGP key. We should get a key signed by a few other people. We will also need to receive their keys from a public key server. See the Apache release signing page for more details.
 
* If we've added the OpenPGP key fingerprint to our Apache profile, the key should automatically be added to https://people.apache.org/keys/group/eagle.asc
 
* md5sum and sha1sum should be installed to create check-sum and verify artifacts, run below command to install them if we don't have it on our machine:
 
    brew install md5sha1sum

# GOAL: sign artifacts
# if gpg 2.X is installed, the command should start with "gpg2".
# $ARTIFACT_NAME: placeholder for artifact, e.g. apache-eagle-0.4.0-incubating-src-rc2.tar.gz
gpg --armor --output $ARTIFACT_NAME.asc --detach-sig $ARTIFACT_NAME
 
# GOAL: create md5 check-sum
# $ARTIFACT_NAME: placeholder for artifact, e.g. apache-eagle-0.4.0-incubating-src-rc2.tar.gz
md5sum $ARTIFACT_NAME > $ARTIFACT_NAME.md5
 
# GOAL: create sha1 check-sum
# $ARTIFACT_NAME: placeholder for artifact, e.g. apache-eagle-0.4.0-incubating-src-rc2.tar.gz
sha1sum $ARTIFACT_NAME > $ARTIFACT_NAME.sha1

# suppose the release dedicated directory is: /tmp/prepared-release-0.4.0-incubating
cd /tmp/prepared-release-0.4.0-incubating
 
# checkout from apache svn that holds artifacts
svn co "https://dist.apache.org/repos/dist/dev/incubator/eagle"
 
# navigate to eagle directory and create a new directory with the release version info
# the new directory name should looks like, e.g.: 0.4.0-incubating-rc1
# $VERSION: placeholder for target release version, e.g. 0.4.0-incubating
# $N: placeholder for ordinal number of release candidate, e.g. 1, 2, etc.
cd eagle; 
mkdir $VERSION-rc$N
 
copy artifacts and generated files to the created folder
 
# commit artifacts, signatures, check-sums to apache svn
# $VERSION: placeholder for target release version, e.g. 0.4.0-incubating
# $N: placeholder for ordinal number of release candidate, e.g. 1, 2, etc.
svn add $VERSION-rc$N
svn commit -m "Upload artifacts of apache eagle $VERSION-rc$N to staging."

# if gpg 2.X is installed, gpg relevant commands should start with "gpg2".
 
# GOAL: get key id of OpenPGP pub key. Execute below command and pick the one of our own
# E.g.: 
#       If the output of this command renders with: 
#         > pub   rsa4096/F1111111 2016-06-29 [SC]
#         > uid         [ultimate] Release Manager (CODE SIGNING KEY) <someone@email.com>
#         > sub   rsa4096/E2222222 2016-06-29 [E]
#       then, F1111111 in first line should be the key id.
#
#       There may be more than one sections rendered, take notice of the user info in 
#       the second line and make sure the section we're looking up is the right one.
gpg --list-keys
 
svn co https://dist.apache.org/repos/dist/release/incubator/eagle eagle-release
 
cd eagle-release
 
# GOAL: append pub-key to KEYS
# $KEY_ID: placeholder for the key id of the RM
(gpg --list-sigs $KEY_ID && gpg --armor --export $KEY_ID ) >> KEYS
 
svn commit -m "Adding OpenPGP public key to KEYS file." KEYS

--------------------------------------
To: dev@eagle.incubator.apache.org
--------------------------------------
Subject: [VOTE] Release: Apache Eagle $VERSION (Release Candidate $N)
--------------------------------------
Hi all,

This is a release vote for Apache Eagle, version $VERSION, release candidate $N.

Highlighted changes in this release are as the following:
  * $HIGHLIGHT_1
  * $HIGHLIGHT_2
  * etc.

Thanks to everyone who has contributed to this release.

Here's the release note: https://git-wip-us.apache.org/repos/asf?p=incubator-eagle.git;a=blob_plain;f=CHANGELOG.txt;hb=refs/heads/$BRANCH_NAME

The artifacts to be voted on are located at: https://dist.apache.org/repos/dist/dev/incubator/eagle/$ARTIFACT_DIRECTORY/

The commit to be voted upon: https://github.com/apache/incubator-eagle/commit/$COMMIT_SHA

Release tag is: https://github.com/apache/incubator-eagle/releases/tag/$TAG_NAME

Release artifacts are signed with the following key: http://people.apache.org/keys/committer/$NAME.asc

The hashes of the artifacts are as follows:
apache-eagle-$VERSION-src-rc$N.tar.gz.md5: $MD5_CHECKSUM
apache-eagle-$VERSION-src-rc$N.tar.gz.sha1: $SHA1_CHECKSUM

Please vote on releasing this package as: Apache Eagle $VERSION.

The vote is open for the next 72 hours and passes if a majority of at least three +1 PPMC votes are cast.

[ ] +1 Release this Apache Eagle $VERSION Release Candidate $N.
[ ]  0 I don't feel strongly about it, but I'm okay with the release
[ ] -1 Do not release this package because...


Thanks,
$RM

--------------------------------------
To: dev@eagle.incubator.apache.org
--------------------------------------
Subject: [RESULT][VOTE] Release: Apache Eagle $VERSION (Release Candidate $N)
--------------------------------------
Hi all,

Voting is now closed and has passed with the following tally:
- PPMC +1: $PPMC_VOTERS (sum: $TOTAL)
- Others +1: $OTHER_VOTERS (sum: $TOTAL)
 
A vote will now be called on general@incubator.apache.org. Thank you all for voting for this release candidate.
 
$RM

--------------------------------------
To: general@incubator.apache.org
--------------------------------------
Subject: [VOTE] Release: Apache Eagle $VERSION
--------------------------------------
Hi all,

This is the incubator release of Apache Eagle, version $VERSION.
Highlighted changes in this release are as the following:
  * $HIGHLIGHT_1
  * $HIGHLIGHT_2
  * etc.

Thanks to everyone who has contributed to this release.

Here's the release note: https://git-wip-us.apache.org/repos/asf?p=incubator-eagle.git;a=blob_plain;f=CHANGELOG.txt;hb=refs/heads/$BRANCH_NAME

The artifacts to be voted on are located at: https://dist.apache.org/repos/dist/dev/incubator/eagle/$ARTIFACT_DIRECTORY/

The commit to be voted upon: https://github.com/apache/incubator-eagle/commit/$COMMIT_SHA

Release tag is: https://github.com/apache/incubator-eagle/releases/tag/$TAG_NAME

Release artifacts are signed with the following key: http://people.apache.org/keys/committer/$NAME.asc

The hashes of the artifacts are as follows:
apache-eagle-$VERSION-src-rc$N.tar.gz.md5: $MD5_CHECKSUM
apache-eagle-$VERSION-src-rc$N.tar.gz.sha1: $SHA1_CHECKSUM

A vote on releasing this package has already passed in Apache Eagle PPMC[1] including +1 votes from our PPPMC (XXX, XXX, XXX ...). Here is the archive of the vote: $PPMC_VOTE_ARCHIVE_LINK

Please vote on releasing this package as: Apache Eagle $VERSION.

The vote is open for the next 72 hours.

[ ] +1 Approve
[ ]  0 No opinion
[ ] -1 Disapprove (and reason ...)


Thanks,
$RM

--------------------------------------
To: general@incubator.apache.org
--------------------------------------
Subject: [RESULT][VOTE] Release: Apache Eagle $VERSION
--------------------------------------
Hi all,

Voting is now closed and has passed with the following tally: 
- Binding +1s: $IPMC_BINDING_VOTERS (sum: $TOTAL)
- Non binding +1s: $PPMC_VOTERS (sum: $TOTAL)


Thanks to everyone who voted! I'll continue with the rest of the release process.
 
$RM

svn co https://dist.apache.org/repos/dist/release/incubator/eagle eagle-release
 
cd eagle-release

# $VERSION: placeholder for target release version, e.g. 0.4.0-incubating
mkdir $VERSION
 
copy artifacts to the created directory
 
rename artifacts by removing "rc$N" from the name
 
re-create md5 and sha1 check-sum (refer to previous step for how to do)
 
# GOAL: add files and check-in to svn
# add and commit artifacts, signatures, check-sums to apache svn
# $VERSION: placeholder for target release version, e.g. 0.4.0-incubating
svn add $VERSION
svn commit -m "Upload artifacts of apache eagle $VERSION for releasing."

# GOAL: create tag
# $VERSION: placeholder for target release version, e.g. 0.4.0-incubating
git tag -s -a v$VERSION -m "Apache Eagle $VERSION."
 
# GOAL: push tag to remote repository
# $APACHE_EAGLE_REPO: placeholder for git remote repo alias, should be pointing to
#     https://git-wip-us.apache.org/repos/asf/incubator-eagle.git
# $TAG_NAME: placeholder for tag name, e.g. v0.4.0-incubating
git push $APACHE_EAGLE_REPO $TAG_NAME

# GOAL: remove old version from svn, the old release version will remain available in:
#    http://archive.apache.org/dist/incubator/eagle/
# $OLD_VERSION: placeholder for old release version, e.g. 0.3.0-incubating
cd eagle-release
svn rm apache-eagle-$OLD_VERSION
svn commit -m 'Remove old release $OLD_VERSION.'

* RM should have the privilege to access Apache Nexus (maven repo). To achieve this, new RM may have to file a JIRA ticket to ask apache INFRA team to help grant access. Official requirement of requesting is could be found here: http://www.apache.org/dev/publishing-maven-artifacts.html#signing-up. And a sample ticket could be found at: https://issues.apache.org/jira/browse/INFRA-12409. 
 
* If you’re the first time to do release, you need update the server authentication information in ~/.m2/settings.xml. In the “servers” section, keep the structure as following, and make sure the following servers be added, and replace ${APACHE_ID}, ${APACHE_PASSWORD}, ${GPG_PASSPHRASE} with your ID, password, and passphrase:
  <servers>
    <!-- To publish a snapshot of some part of Maven. -->
    <server>
      <id>apache.snapshots.https</id>
      <username>${APACHE_ID}</username>
      <password>${APACHE_PASSWORD}</password>
    </server>
    <!-- To stage a release of some part of Maven. -->
    <server>
      <id>apache.releases.https</id>
      <username>${APACHE_ID}</username>
      <password>${APACHE_PASSWORD}</password>
    </server>
    <!-- To sign artifacts with OpenPGP. -->
    <server>
      <id>gpg.passphrase</id>
      <passphrase>${GPG_PASSPHRASE}</passphrase>
    </server>
  </servers>

# GOAL: set passphrase variable without putting it into shell history.
# $OLD_VERSION: placeholder for old release version, e.g. 0.3.0-incubating
# 
read -s GPG_PASSPHRASE
 
# GOAL: clean directory from both git and maven view.
git clean -xf
mvn clean
 
# GOAL: dry-run to make sure no blocking error occurs (for we have run pass tests in previous steps, just ignore the maven-test phase).
# NOTE: don't replace ${GPG_PASSPHRASE}, it's a part of the command.
mvn -Papache-release -DskipTests -Dgpg.passphrase=${GPG_PASSPHRASE} install
 
# GOLA: deploy (for we have run pass tests in previous steps, just ignore the maven-test phase).
# NOTE: don't replace ${GPG_PASSPHRASE}, it's a part of the command.
mvn -Papache-release -DskipTests -Dgpg.passphrase=${GPG_PASSPHRASE} deploy

--------------------------------------
To: announce@apache.org
--------------------------------------
Subject: [ANNOUNCE] Apache Eagle $VERSION released
--------------------------------------
Hi,

The Apache Eagle (incubating) Community is happy to announce the release of version $VERSION from the Apache Incubator.

Apache Eagle (incubating) is a monitoring framework to analyze big data platforms for security and performance.
      
The release bits are available at: http://www.apache.org/dyn/closer.cgi?path=/incubator/eagle/apache-eagle-$VERSION/

The change list is available at: https://git-wip-us.apache.org/repos/asf?p=incubator-eagle.git;a=blob_plain;f=CHANGELOG.txt;hb=refs/heads/$VERSION
      
We would like to thank all contributors who made the release possible.

Disclaimer :
Apache Eagle is an effort undergoing incubation at The Apache Software
Foundation (ASF), sponsored by the Apache Incubator PMC. 
Incubation is required of all newly accepted projects until a further 
review indicates that the infrastructure, communications, and decision
making process have stabilized in a manner consistent with other 
successful ASF projects.
While incubation status is not necessarily a reflection of the 
completeness or stability of the code, it does indicate that the 
project has yet to be fully endorsed by the ASF.

Regards,
Apache Eagle (incubating) Community

# GOAL: update local git repo with the newest doc check-ins
# In this part, say, operations of updating the repo may vary depending on your working model on git, 
# e.g. fork & PR, or directly check-in/out. Anyway, the target is to get the newest code from remote
# git repo:
#     https://github.com/eaglemonitoring/eaglemonitoring.github.io
# We just list the direct model git commands here for your reference.
# $GIT_REPO_PATH: placeholder for the local git-repo path of eaglemonitoring.github.io
cd $GIT_REPO_PATH
git pull 

# GOAL: verify the result of the update
# To verify, open localhost:4000 in web browser after executing below command, then verify the updated content
jekyll serve
 
# GOAL: build site files
jekyll build
 
# GOAL: checkout existing site files from svn
svn co https://svn.apache.org/repos/asf/eagle/ eagle-site
 
cd eagle-site
 
# GOAL: copy newly built site files to svn local folder
# $GIT_REPO_PATH: placeholder for the local git-repo path of eaglemonitoring.github.io
cp -r $GIT_REPO_PATH/_site/* site/
 
# GOAL: check tracking status of files
svn status
 
# GOAL: add all untracked files
# After executing 'svn status', all untracked files are marked with "?" on the left, add them all.
# $UNTRACKED_FILE_LIST: placeholder for the untracked file name list marked by svn, separated by blank space
svn add $UNTRACKED_FILE_LIST
 
# GOAL: checkin to svn
# $COMMENT: placeholder for comment of the checkin
svn commit -m "$COMMENT"