Debian/Ubuntu에 ClickHouse 설치

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

권장 사항 검토

ClickHouse를 설치하기 전에 다음 권장 사항을 검토하십시오.

Swap: 프로덕션 환경에서는 운영 체제의 스왑 파일을 비활성화하십시오.
Disk space: ClickHouse 바이너리를 설치하려면 최소 2.5 GB의 디스크 공간이 필요합니다.
Network: 분산 배포(클러스터링)에서는 최소 10 Gbit의 네트워크 연결을 사용하십시오. 대량의 중간 데이터가 포함된 분산 쿼리를 처리할 때와 복제 시에는 네트워크 대역폭이 매우 중요합니다.

스토리지 요구 사항 추정

데이터에 필요한 디스크 공간을 추정하려면 다음 단계를 따르십시오.

데이터 용량 추정: 데이터의 샘플을 추출해 평균 행 크기를 계산한 다음, 저장할 예정인 행 수를 곱하십시오.
압축 계수 적용: 샘플 데이터를 ClickHouse에 로드한 뒤 원본 데이터 크기와 저장된 테이블 크기를 비교하십시오. 예를 들어 클릭스트림 데이터는 일반적으로 6~10배 압축됩니다.
레플리카 수 반영: 여러 레플리카에 데이터를 저장할 계획이라면 추정 용량에 레플리카 수를 곱하십시오.

하드웨어 요구 사항에 대한 자세한 내용은 "사이징 및 하드웨어 권장 사항"을 참조하십시오.

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 서버 및 client 패키지 설치
sudo apt-get install -y clickhouse-server clickhouse-client

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

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

ClickHouse 서버 및 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 서버에 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 패키지는 다음과 같습니다:

Package	Description
`clickhouse-common-static`	컴파일된 ClickHouse 바이너리 파일을 설치합니다.
`clickhouse-server`	`clickhouse-server`에 대한 심볼릭 링크를 생성하고 기본 서버 설정 파일을 설치합니다.
`clickhouse-client`	`clickhouse-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

권장 사항 검토​

Debian 저장소 설정​

ClickHouse 서버 및 client 설치​

ClickHouse 시작​

독립 실행형 ClickHouse Keeper 설치​

ClickHouse Keeper 활성화 및 시작​

패키지​