ClickHouse(03)ClickHouse怎麼安裝和部署

張飛的豬發表於2022-07-05

本文會介紹如何安裝和部署ClickHouse,官方推薦的幾種安裝模式,以及安裝之後如何啟動,ClickHouse叢集如何配置等。

簡單來說,ClickHouse的搭建流程如下:

  1. 環境檢查,環境依賴安裝
  2. 在對應的服務上下載安裝Click House
  3. 配置config.xml和user.xml,如果搭建Click House叢集,還要配置Host檔案和FQDN:(Fully Qualified Domain Name)全限定域名
  4. 啟動server
  5. 連線client

這裡先介紹單機的Click House的搭建和啟動,下一篇會介紹搭建Click House叢集需要配置的東西。

系統要求

ClickHouse可以在任何具有x86_64,AArch64或PowerPC64LE CPU架構的Linux,FreeBSD或Mac OS X上執行。

官方預構建的二進位制檔案通常針對x86_64進行編譯,並利用SSE4.2指令集,因此,除非另有說明,支援它的CPU使用將成為額外的系統需求。

下面是檢查當前CPU是否支援SSE 4.2的命令:

$ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"

要在不支援SSE4.2或AArch64,PowerPC64LE架構的處理器上執行ClickHouse,官方介紹是說要通過適當的配置調整從原始碼構建ClickHouse,這裡就不詳細介紹了,有興趣可以自行閱讀原始碼瞭解。

安裝包下載

官方文件裡面,介紹了下面幾種安裝方式:DEB、RPM、Tgz、Docker、其他環境安裝和使用原始碼安裝,本質上都是一樣的,我們選擇合適安裝方式,根據步驟,一步一步來就可以。

一般來說,安裝包會包含下面的內容:

  • clickhouse-common-static — ClickHouse編譯的二進位制檔案。
  • clickhouse-server — 建立clickhouse-server軟連線,並安裝預設配置服務
  • clickhouse-client — 建立clickhouse-client客戶端工具軟連線,並安裝客戶端配置檔案。
  • clickhouse-common-static-dbg — 帶有除錯資訊的ClickHouse二進位制檔案。

DEB安裝包

建議使用Debian或Ubuntu的官方預編譯deb軟體包。執行以下命令來安裝包:

#安裝環境配置和安裝軟體更新
sudo apt-get install -y apt-transport-https ca-certificates dirmngr
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
    /etc/apt/sources.list.d/clickhouse.list
sudo apt-get update

#安裝clickhouse
sudo apt-get install -y clickhouse-server clickhouse-client

#啟動clickhouse服務
sudo service clickhouse-server start

#啟動客戶端
clickhouse-client # or "clickhouse-client --password" if you've set up a password.

如果要使用最新的版本,請用testing替代stable,一般來說在測試環境使用,生產環境還是要以穩定為主。

RPM安裝包

CentOS、RedHat和所有其他基於rpm的Linux發行版的使用官方預編譯rpm包。

首先,您需要新增官方儲存庫:

$ sudo yum install -y yum-utils
$ sudo yum-config-manager --add-repo https://packages.clickhouse.com/rpm/clickhouse.repo

然後使用yum安裝

$ sudo yum install -y clickhouse-server clickhouse-client

然後啟動clickhouse

sudo /etc/init.d/clickhouse-server start
clickhouse-client # or "clickhouse-client --password" if you set up a password.

和DEB安裝安裝方式一樣,如果要使用最新的版本,請用testing替代stable,一般來說在測試環境使用,生產環境還是要以穩定為主。

Tgz安裝包

如果作業系統不支援安裝deb或rpm包,可以使用官方預編譯的tgz軟體包。可以通過curl或wget從儲存庫https://packages.clickhouse.com/tgz/下載。

下載後解壓縮下載資原始檔並使用安裝指令碼進行安裝。以下是一個最新穩定版本的安裝示例:

#獲取最後一個版本號
LATEST_VERSION=$(curl -s https://packages.clickhouse.com/tgz/stable/ | \
    grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | sort -V -r | head -n 1)
export LATEST_VERSION

#下載對應版本號的tgz安裝包
curl -O "https://packages.clickhouse.com/tgz/stable/clickhouse-common-static-$LATEST_VERSION.tgz"
curl -O "https://packages.clickhouse.com/tgz/stable/clickhouse-common-static-dbg-$LATEST_VERSION.tgz"
curl -O "https://packages.clickhouse.com/tgz/stable/clickhouse-server-$LATEST_VERSION.tgz"
curl -O "https://packages.clickhouse.com/tgz/stable/clickhouse-client-$LATEST_VERSION.tgz"

#解壓壓縮包並執行對應的指令碼
tar -xzvf "clickhouse-common-static-$LATEST_VERSION.tgz"
#生成ClickHouse編譯的二進位制檔案
sudo "clickhouse-common-static-$LATEST_VERSION/install/doinst.sh"

tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION.tgz"
#生成帶有除錯資訊的ClickHouse二進位制檔案
sudo "clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh"

tar -xzvf "clickhouse-server-$LATEST_VERSION.tgz"
#建立clickhouse-server軟連線,並安裝預設配置服務
sudo "clickhouse-server-$LATEST_VERSION/install/doinst.sh"
#啟動服務
sudo /etc/init.d/clickhouse-server start

tar -xzvf "clickhouse-client-$LATEST_VERSION.tgz"
#建立clickhouse-client客戶端工具軟連線,並安裝客戶端配置檔案
sudo "clickhouse-client-$LATEST_VERSION/install/doinst.sh"

Docker安裝包

通過Docker安裝,需要你搭建docker環境,這裡就不過多介紹,預設你已經安裝了docker,如果還沒有可以自行搜尋docker的安裝,搭建好docker。

通過docker安裝,特別簡單,使用官方的映象執行一個例項就可以,執行下面的命令即可。

# 啟動伺服器例項
$ docker run -d --name some-clickhouse-server --ulimit nofile=262144:262144 clickhouse/clickhouse-server

# 進入docker內部並且進入clickhouse
$ docker run -it --rm --link some-clickhouse-server:clickhouse-server --entrypoint clickhouse-client clickhouse/clickhouse-server --host clickhouse-server
# OR
$ docker exec -it some-clickhouse-server clickhouse-client


# 通過curl連線到clickhouse,輸出'Hello, ClickHouse!'
$ echo "SELECT 'Hello, ClickHouse!'" | docker run -i --rm --link some-clickhouse-server:clickhouse-server curlimages/curl 'http://clickhouse-server:8123/?query=' -s --data-binary @-

ClickHouse的docker映象,預設只能通過docker網路訪問。

如果需要外網範圍,我們也可以通過將容器內部的特定埠對映到主機埠來公開在Docker中執行的ClickHouse或者通過允許容器直接使用主機埠(也允許存檔更好的網路效能)。

#將容器內部的特定埠對映到主機埠來公開在Docker中執行的ClickHouse
$ docker run -d -p 18123:8123 -p19000:9000 --name some-clickhouse-server --ulimit nofile=262144:262144 clickhouse/clickhouse-server

$ echo 'SELECT version()' | curl 'http://localhost:18123/' --data-binary @-


#允許容器直接使用主機埠
$ docker run -d --network=host --name some-clickhouse-server --ulimit nofile=262144:262144 clickhouse/clickhouse-server
$ echo 'SELECT version()' | curl 'http://localhost:8123/' --data-binary @-

如果需要調整config.xml,可以使用下面的命令。

$ docker run -d --name some-clickhouse-server --ulimit nofile=262144:262144 -v /path/to/your/config.xml:/etc/clickhouse-server/config.xml clickhouse/clickhouse-server

其他安裝方式

ClickHouse還可以使用原始碼安裝,或者手動下載安裝包編譯,有需要的可以到ClickHouse官網檢視文件,這裡不做太多篇幅的介紹。

啟動

執行如下命令在後臺啟動服務:

$ sudo /etc/init.d/clickhouse-server start

日誌檔案將輸出在/var/log/clickhouse-server/資料夾。

如果伺服器沒有啟動,檢查/etc/clickhouse-server/config.xml中的配置。

clickhouse的配置引數主要分了兩個檔案,一個是config.xml中的伺服器配置引數(Server Settings),另一個是常規配置引數(setttings)。

手動從控制檯啟動伺服器:

$ clickhouse-server --config-file=/etc/clickhouse-server/config.xml

在這種情況下,日誌將被列印到控制檯,這在開發過程中很方便。

如果配置檔案在當前目錄中,則不需要指定——config-file引數。預設情況下,它的路徑為./config.xml。

ClickHouse支援訪問限制設定。它們位於users.xml檔案(與config.xml同級目錄)。

預設情況下,允許default使用者從任何地方訪問,不需要密碼。可檢視user/default/networks。 更多資訊,請參見Configuration Files。

啟動服務後,您可以使用命令列客戶端連線到它:

$ clickhouse-client

預設情況下,使用default使用者並不攜帶密碼連線到localhost:9000。還可以使用--host引數連線到指定伺服器。

示例:

$ ./clickhouse-client
ClickHouse client version 0.0.18749.
Connecting to localhost:9000.
Connected to ClickHouse server version 0.0.18749.

:) SELECT 1

SELECT 1

┌─1─┐
│ 1 │
└───┘

1 rows in set. Elapsed: 0.003 sec.

:)

當到了這裡,你就成功搭建了一個單機版的Click House了。

ClickHouse相關資料分享

ClickHouse經典中文文件分享

參考文章:ClickHouse(03)ClickHouse怎麼安裝和部署

相關文章