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