본문으로 바로가기
본문으로 바로가기

Debian/Ubuntu에 ClickHouse 설치

Debian 또는 Ubuntu에서는 공식 사전 컴파일된 deb 패키지 사용을 권장합니다.

Debian 저장소 설정​

ClickHouse를 설치하려면 다음 명령을 실행하십시오:

# 필수 패키지 설치
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

# ClickHouse GPG 키를 내려받아 키링에 저장
curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

# 시스템 아키텍처 확인
ARCH=$(dpkg --print-architecture)

# apt 소스에 ClickHouse 저장소 추가
echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg arch=${ARCH}] https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list

# apt 패키지 목록 업데이트
sudo apt-get update
  • 필요에 따라 다른 릴리스 유형을 사용하려면 stable을 lts로 바꿀 수 있습니다.
  • packages.clickhouse.com에서 패키지를 수동으로 내려받아 설치할 수도 있습니다.

deb 패키지를 설치하기 위한 이전 배포 방식
# 필수 패키지 설치
sudo apt-get install apt-transport-https ca-certificates dirmngr

# 패키지 인증을 위해 ClickHouse GPG 키 추가
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

# apt 소스에 ClickHouse 저장소 추가
echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
    /etc/apt/sources.list.d/clickhouse.list
    
# apt 패키지 목록 업데이트
sudo apt-get update

# ClickHouse server 및 client 패키지 설치
sudo apt-get install -y clickhouse-server clickhouse-client

# ClickHouse server 서비스 시작
sudo service clickhouse-server start

# ClickHouse 명령줄 client 실행
clickhouse-client # 혹은 비밀번호를 설정한 경우 "clickhouse-client --password"를 사용하십시오.

ClickHouse server 및 client 설치​

sudo apt-get install -y clickhouse-server clickhouse-client

ClickHouse 시작​

ClickHouse 서버를 시작하려면 다음 명령을 실행하십시오:

sudo service clickhouse-server start

ClickHouse 클라이언트를 시작하려면 다음을 실행하십시오:

clickhouse-client

서버에 비밀번호를 설정한 경우에는 다음과 같이 실행해야 합니다:

clickhouse-client --password

독립형 ClickHouse Keeper 설치​

팁

운영 환경에서는 ClickHouse Keeper를 전용 노드에서 실행할 것을 강력히 권장합니다. 테스트 환경에서 ClickHouse Server와 ClickHouse Keeper를 동일한 서버에서 실행하기로 한 경우에는 ClickHouse Server에 ClickHouse Keeper가 포함되어 있으므로 별도로 ClickHouse Keeper를 설치할 필요가 없습니다.

독립형 ClickHouse Keeper 서버에서 clickhouse-keeper를 설치하려면 다음을 실행하십시오:

sudo apt-get install -y clickhouse-keeper

ClickHouse Keeper 활성화 및 시작​

sudo systemctl enable clickhouse-keeper
sudo systemctl start clickhouse-keeper
sudo systemctl status clickhouse-keeper

패키지​

사용 가능한 다양한 deb 패키지는 다음과 같습니다:

PackageDescription
clickhouse-common-static컴파일된 ClickHouse 바이너리 파일을 설치합니다.
clickhouse-serverclickhouse-server에 대한 심볼릭 링크를 생성하고 기본 서버 설정 파일을 설치합니다.
clickhouse-clientclickhouse-client 및 기타 클라이언트 관련 도구에 대한 심볼릭 링크를 생성하고 클라이언트 설정 파일을 설치합니다.
clickhouse-common-static-dbg디버그 정보가 포함된 컴파일된 ClickHouse 바이너리 파일을 설치합니다.
clickhouse-keeper전용 ClickHouse Keeper 노드에 ClickHouse Keeper를 설치하는 데 사용됩니다. ClickHouse 서버와 동일한 서버에서 ClickHouse Keeper를 실행하는 경우 이 패키지를 설치할 필요가 없습니다. ClickHouse Keeper와 기본 ClickHouse Keeper 설정 파일을 설치합니다.

참조

특정 버전의 ClickHouse를 설치해야 하는 경우 모든 패키지를 동일한 버전으로 설치해야 합니다: sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7