You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@bigtop.apache.org by rv...@apache.org on 2017/03/06 01:42:01 UTC
[2/2] bigtop git commit: BIGTOP-2693. Update readme for build and
configuring git repo for packages
BIGTOP-2693. Update readme for build and configuring git repo for packages
Project: http://git-wip-us.apache.org/repos/asf/bigtop/repo
Commit: http://git-wip-us.apache.org/repos/asf/bigtop/commit/e3485b9c
Tree: http://git-wip-us.apache.org/repos/asf/bigtop/tree/e3485b9c
Diff: http://git-wip-us.apache.org/repos/asf/bigtop/diff/e3485b9c
Branch: refs/heads/master
Commit: e3485b9cbc2bcfa1350a27195320ee59992ee751
Parents: ab38ef3
Author: Felix Cheung <fe...@hotmail.com>
Authored: Tue Feb 28 21:41:10 2017 -0800
Committer: Roman Shaposhnik <rv...@apache.org>
Committed: Sun Mar 5 17:13:53 2017 -0800
----------------------------------------------------------------------
README.md | 32 +++++++++++++++++++++-----------
1 file changed, 21 insertions(+), 11 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/bigtop/blob/e3485b9c/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 13e2f5a..2024f10 100644
--- a/README.md
+++ b/README.md
@@ -178,6 +178,10 @@ __On all systems, Building Apache Bigtop requires certain set of tools__
This build task expected Puppet 3.x to be installed; user has to have sudo permissions. The task will pull down and install
all development dependencies, frameworks and SDKs, required to build the stack on your platform.
+ To immediately set environment after running toolchain, run
+
+ . /etc/profile.d/bigtop.sh
+
* __Building packages__ : `gradle [component-name]-[rpm|deb]`
If -Dbuildwithdeps=true is set, the Gradle will follow the order of the build specified in
@@ -214,25 +218,31 @@ The source for the website is located in "project_root/src/site/".
For Developers: Building a component from Git repository
--------------------------------------------------------
-To fetch source from a Git repository you need to modify `bigtop.mk` and add the
-following fields to your package:
+To fetch source from a Git repository you need to modify `bigtop.bom` and add the
+following JSON snippets to your component/package:
-* `_GIT_REPO` - SSH, HTTP or local path to Git repo.
-* `_GIT_REF` - branch, tag or commit hash to check out.
+```
+git { repo = ""; ref = ""; dir = ""}
+```
+
+* `repo` - SSH, HTTP or local path to Git repo.
+* `ref` - branch, tag or commit hash to check out.
+* `dir` - directory name to write source into.
Some packages have different names for source directory and source tarball
(`hbase-0.98.5-src.tar.gz` contains `hbase-0.98.5` directory).
-By default source will be fetched in a directory named `_TARBALL_SRC`
+By default source will be fetched in a directory named by `tarball { destination = TARBALL_DST}`
without `.t*` extension.
-To explicitly set directory name use the `_GIT_DIR` option.
+To explicitly set directory name use the `dir` option.
Example for HBase:
-
-```make
-HBASE_GIT_REPO=https://github.com/apache/hbase.git
-HBASE_GIT_REF=$(HBASE_PKG_VERSION)
-HBASE_GIT_DIR=hbase-$(HBASE_PKG_VERSION)
+```
+ name = 'hbase'
+ version { base = '1.1.3'; pkg = base; release = 1 }
+ git { repo = "https://github.com/apache/hbase.git"
+ ref = "${version.base}"
+ dir = "${name}-${version.base}" }
```