thevar1able/ClickHouse
1
0
Fork 0
mirror of https://github.com/ClickHouse/ClickHouse.git synced 2024-11-22 07:31:57 +00:00
Code Issues Packages Projects Releases Wiki Activity

Better build instruction #9054

Browse Source
This commit is contained in:
Alexey Milovidov 2020-02-16 13:45:15 +03:00
parent a3eac2688b
commit dd7c0e13d8
1 changed files with 79 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

104
docs/en/development/build.md
View File

@ -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-->