You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@htrace.apache.org by st...@apache.org on 2015/09/16 05:55:45 UTC
[2/2] incubator-htrace git commit: HTRACE-249 Script and doc on how
to publish website
HTRACE-249 Script and doc on how to publish website
Addendum adding how to make release candidate
Project: http://git-wip-us.apache.org/repos/asf/incubator-htrace/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-htrace/commit/7e4530a2
Tree: http://git-wip-us.apache.org/repos/asf/incubator-htrace/tree/7e4530a2
Diff: http://git-wip-us.apache.org/repos/asf/incubator-htrace/diff/7e4530a2
Branch: refs/heads/master
Commit: 7e4530a24a443188ef7d086140998d7afd9a76b8
Parents: 5162d67 23e1b53
Author: stack <st...@duboce.net>
Authored: Tue Sep 15 20:13:25 2015 -0700
Committer: stack <st...@duboce.net>
Committed: Tue Sep 15 20:55:20 2015 -0700
----------------------------------------------------------------------
Dockerfile | 67 ++++++++++++++++
src/main/site/markdown/building.md | 131 +++++++++++++++++++++++++++++---
2 files changed, 188 insertions(+), 10 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-htrace/blob/7e4530a2/src/main/site/markdown/building.md
----------------------------------------------------------------------
diff --cc src/main/site/markdown/building.md
index d5755af,0000000..afa7e4e
mode 100644,000000..100644
--- a/src/main/site/markdown/building.md
+++ b/src/main/site/markdown/building.md
@@@ -1,45 -1,0 +1,156 @@@
+<!---
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License. See accompanying LICENSE file.
+-->
+
+# Building HTrace
+## Publishing a Release Candidate
- TODO
++### Generating the PGP key (if you haven't already)
++Create new pgp key. See http://www.apache.org/dev/openpgp.html
++
++ sudo zypper -y install gpg
++ gpg --version
++ gpg (GnuPG) 2.0.22
++
++This is a new enough version according to the apache site.
++
++Generate a new key via
++
++ gpg --gen-key --s2k-digest-algo sha512
++
++Answer 4096 bits, no expiration time.
++
++Uploaded key to http://pgp.mit.edu/ It now appears as
++
++ http://pgp.mit.edu/pks/lookup?op=get&search=0xDE78987A9CD4D9D3
++
++Get the pgp key signed by others.
++
++Add the new pgp key to the KEYS file
++
++### JIRA maintenance
++From hadoop HowToRelease at https://wiki.apache.org/hadoop/HowToRelease :
++Bulk update Jira to unassign from this release all issues that are open
++non-blockers.
++
++#### Maven and build
++Update the versions in Maven.
++
++ mvn versions:set -DnewVersion=4.0.0
++
++or do it manually by editing the pom.xml files. Commit the new versions.
++
++Add a settings.xml in `~/.m2/settings.xml` with the appropriate logins.
++
++Create the release branch:
++
++ git checkout -b 4.0
++
++Create the release tag via git
++
++ git tag -s 4.0.0RC0 -m '4.0 release candidate 0' -u 9CD4D9D3
++
++For some reason, I get a message about needing a password. But no password
++is actually asked for. Perhaps it is supplied by the window manager via its
++keyring-like program.
++
++Push branch-X.Y.Z and the newly created tag to the remote repo.
++
++ git push apache 4.0 4.0.0RC0
++
++Upload the build to Sonatype's servers.
++
++ git clean -fdqx .
++ mvn clean deploy -Psign,src,dist -DskipTests
++
++This will take a while because it needs to upload to the servers.
++
++Log into repository.apache.org and go to
++https://repository.apache.org/#stagingRepositories
++Select the repo you uploaded earlier. You can browse the files
++here to verify it looks right. When you are satisfied, click "Close".
++
++Generate the source tarball via:
++
++ mvn clean install -DskipTests assembly:single -Pdist
++
++Generate the side files.
++
++ gpg --print-mds /home/cmccabe/src/htrace2d/target/htrace-4.0.0-incubating-src.tar.gz > \
++ /home/cmccabe/src/htrace2d/target/htrace-4.0.0-incubating-src.tar.gz.mds
++ gpg --armor --output /home/cmccabe/src/htrace2d/target/htrace-4.0.0-incubating-src.tar.gz.asc \
++ --detach-sig /home/cmccabe/src/htrace2d/target/htrace-4.0.0-incubating-src.tar.gz
++
++rsync up to your public_html directory in people.apache.org.
++
++ rsync -avi /home/cmccabe/src/htrace2d/target/htrace-4.0.0-incubating-src.tar.* \
++ people.apache.org:~/public_html/htrace/releases/4.0.0
++
++Generate release notes via JIRA at
++https://issues.apache.org/jira/browse/HTRACE/
++by clicking on the release and then clicking the grey "release notes"
++button in the top right.
++
++### Mailing list
++Propose a new release on the mailing list. Wait 1 day for responses.
++
++Post a message with the form:
++
++ > I've posted the first release candidate here:
++ >
++ > http://people.apache.org/~cmccabe/htrace/releases/4.0.0/rc0
++ >
++ > The jars have been staged here:
++ >
++ > https://repository.apache.org/content/repositories/orgapachehtrace-1017
++ >
++ > There's a lot of great stuff in this release [description]
++ >
++ > The vote will run for 5 days.
++ >
++ > cheers,
++ > Colin
++ >
++ > [release notes]
+
+## Publishing htrace.incubator.apache.org website
+Checkout the current website. It is in svn (that's right, subversion).
+The website is in a distinct location such that when its' content is svn
+committed, the commit is published as `htrace.incubator.apache.org`.
+
+Here is how you'd check out the current site into a directory named
+`htrace.incubator.apache.org` in the current directory:
+
++~~~
+ $ svn checkout https://svn.apache.org/repos/asf/incubator/htrace/site/publish htrace.incubator.apache.org
++~~~
+
+Next, run the site publishing script at `${HTRACE_CHECKOUT_DIR}/bin/publish_hbase_website.sh`.
+It will dump out usage information that looks like this:
- $ ./bin/publish_hbase_website.sh
- Usage: ./bin/publish_hbase_website.sh [-i | -a] [-g <dir>] [-s <dir>]
- -h Show this message
- -i Prompts the user for input
- -a Does not prompt the user. Potentially dangerous.
- -g The local location of the HTrace git repository
- -s The local location of the HTrace website svn checkout
- Either -i or -a is required.
- Edit the script to set default Git and SVN directories.
++
++ $ ./bin/publish_hbase_website.sh
++ Usage: ./bin/publish_hbase_website.sh [-i | -a] [-g <dir>] [-s <dir>]
++ -h Show this message
++ -i Prompts the user for input
++ -a Does not prompt the user. Potentially dangerous.
++ -g The local location of the HTrace git repository
++ -s The local location of the HTrace website svn checkout
++ Either -i or -a is required.
++ Edit the script to set default Git and SVN directories.
+
+To run the publish site script interactively, here is an example where
+the git checkout is at `~/checkouts/incubator-htrace` and the svn checkout
+is at `~/checkouts/htrace.incubator.apache.org`:
+
++~~~
+ $ ./bin/publish_hbase_website.sh -i -g ~/checkouts/incubator-htrace -s ~/checkouts/htrace.incubator.apache.org/
++~~~