You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@kylin.apache.org by xx...@apache.org on 2022/08/12 10:14:31 UTC
[kylin] branch doc5.0 updated: KYLIN-5221 Add how to package doc
This is an automated email from the ASF dual-hosted git repository.
xxyu pushed a commit to branch doc5.0
in repository https://gitbox.apache.org/repos/asf/kylin.git
The following commit(s) were added to refs/heads/doc5.0 by this push:
new 8aa50a99c9 KYLIN-5221 Add how to package doc
8aa50a99c9 is described below
commit 8aa50a99c9e579aef40c95e89d27b0d6fea54892
Author: XiaoxiangYu <xx...@apache.org>
AuthorDate: Fri Aug 12 18:14:01 2022 +0800
KYLIN-5221 Add how to package doc
---
README.md | 8 +++--
website/docs/development/how_to_package.md | 48 +++++++++++++++++++++++++++++-
2 files changed, 52 insertions(+), 4 deletions(-)
diff --git a/README.md b/README.md
index 3518feaa70..d5201a55ff 100644
--- a/README.md
+++ b/README.md
@@ -54,7 +54,9 @@ npm start
npm deploy
```
+### TODO List
-### How to push your change
-
-TODO
\ No newline at end of file
+- Search in document
+- SEO
+- Multi Version
+- i18n
\ No newline at end of file
diff --git a/website/docs/development/how_to_package.md b/website/docs/development/how_to_package.md
index f8e8aaf0cf..a0ca3b1d3c 100644
--- a/website/docs/development/how_to_package.md
+++ b/website/docs/development/how_to_package.md
@@ -2,4 +2,50 @@
sidebar_position: 1
---
-# TODO
\ No newline at end of file
+# How to package
+
+### Environment Requirement
+
+| Software | Comment |
+|---------------| ---------------------|
+| Git | Fetch branch name and hash of latest commit |
+| Apache Maven | Build Java and Scala source code |
+| Node.js | Build front end |
+
+
+### Options for Packaging Script
+
+| Option | Comment |
+|-------------------- | ---------------|
+| -official | Should package name contains timestamp, default no |
+| -noThirdParty | Should third party binary be packaging into binary, current they are influxdb,grafana and postgresql, default no |
+| -noSpark | Should spark be packaging into Kylin binary, default yes |
+| -noHive1 | Should this binary support Hive 1.2, by default kylin will support Hive 2.3+ |
+| -skipFront | Should build front end, default yes |
+| -skipCompile | Should build back end, default yes |
+
+### Package Content
+
+| Option | Comment |
+|-------------------- | ---------------|
+| VERSION | `Apache Kylin ${release_version}` |
+| commit_SHA1 | `${HASH_COMMIT}@${BRANCH_NAME}` |
+
+### Package Name convention
+
+Package name is `apache-kylin-${release_version}.tar.gz`, while `${release_version}` is `{project.version}.YYYYmmDDHHMMSS` by default.
+For example, an unofficial package could be `apache-kylin-5.0.0-SNAPSHOT.20220812161045.tar.gz` while an official package could be `apache-kylin-5.0.0.tar.gz`
+
+### Example for developer and release manager
+
+```shell
+
+## Case 1: For developer who want to package for testing purpose
+cd build/release
+./release.sh
+
+## Case 2: Official apache release, kylin binary for deploy on Hadoop3+ and Hive2.3+,
+# and third party cannot be distributed because of apache distribution policy(size and license)
+cd build/release
+./release.sh -noThirdParty -noSpark -official
+```
\ No newline at end of file