Better build instruction #9054

docs/en/development/build.md

@@ -1,35 +1,13 @@
-# How to Build ClickHouse Release Package
-
-## Install Git and Pbuilder
-
-```bash
-$ sudo apt-get update
-$ sudo apt-get install git pbuilder debhelper lsb-release fakeroot sudo debian-archive-keyring debian-keyring
-```
-
-## Checkout ClickHouse Sources
-
-```bash
-$ git clone --recursive --branch master https://github.com/ClickHouse/ClickHouse.git
-$ cd ClickHouse
-```
-
-## Run Release Script
-
-```bash
-$ ./release
-```
-
 # How to Build ClickHouse for Development
 
 The following tutorial is based on the Ubuntu Linux system.
 With appropriate changes, it should also work on any other Linux distribution.
 Supported platforms: x86_64 and AArch64. Support for Power9 is experimental.
 
-## Install Git, CMake and Ninja
+## Install Git, CMake, Python and Ninja
 
 ```bash
-$ sudo apt-get install git cmake ninja-build
+$ sudo apt-get install git cmake python ninja-build
 ```
 
 Or cmake3 instead of cmake on older systems.
@@ -66,12 +44,12 @@ $ git clone --recursive git@github.com:ClickHouse/ClickHouse.git
 or
 ```bash
 $ git clone --recursive https://github.com/ClickHouse/ClickHouse.git
-$ cd ClickHouse
 ```
 
 ## Build ClickHouse
 
 ```bash
+$ cd ClickHouse
 $ mkdir build
 $ cd build
 $ cmake ..
@@ -83,4 +61,80 @@ To create an executable, run `ninja clickhouse`.
 This will create the `dbms/programs/clickhouse` executable, which can be used with `client` or `server` arguments.
 
 
+# How to Build ClickHouse on Any Linux
+
+The build requires the following componenets:
+
+- Git (is used only to checkout the sources, it's not needed for build)
+- CMake 3.10 or newer
+- Ninja (recommended) or Make
+- C++ compiler: gcc 9 or clang 8 or newer
+- Linker: lld or gold (the classic GNU ld won't work)
+- Python (is only used inside LLVM build and it is optional)
+
+If all the components are installed, you may build in the same way as the steps above.
+
+Example for Ubuntu Eoan:
+
+```
+sudo apt update
+sudo apt install git cmake ninja-build g++ python
+git clone --recursive https://github.com/ClickHouse/ClickHouse.git
+mkdir build && cd build
+cmake ../ClickHouse
+ninja
+```
+
+Example for OpenSUSE Tumbleweed:
+
+```
+sudo zypper install git cmake ninja gcc-c++ python lld
+git clone --recursive https://github.com/ClickHouse/ClickHouse.git
+mkdir build && cd build
+cmake ../ClickHouse
+ninja
+```
+
+Example for CentOS 8:
+
+```
+sudo yum update
+yum install git cmake make gcc-c++ python2
+git clone --recursive https://github.com/ClickHouse/ClickHouse.git
+cmake ../ClickHouse
+make
+```
+
+# You Don't Have to Build ClickHouse
+
+ClickHouse is available in pre-built binaries and packages. Binaries are portable and can be run on any Linux flavour.
+
+They are build for stable, prestable and testing releases as long as for every commit to master and for every pull request.
+
+To find the most fresh build from `master`, go to [commits page](https://github.com/ClickHouse/ClickHouse/commits/master), click on the first green check mark or red cross near commit, and click to the "Details" link right after "ClickHouse Build Check".
+
+
+# How to Build ClickHouse Debian Package
+
+## Install Git and Pbuilder
+
+```bash
+$ sudo apt-get update
+$ sudo apt-get install git python pbuilder debhelper lsb-release fakeroot sudo debian-archive-keyring debian-keyring
+```
+
+## Checkout ClickHouse Sources
+
+```bash
+$ git clone --recursive --branch master https://github.com/ClickHouse/ClickHouse.git
+$ cd ClickHouse
+```
+
+## Run Release Script
+
+```bash
+$ ./release
+```
+
+
 [Original article](https://clickhouse.tech/docs/en/development/build/) <!--hide-->