Debian/Ubuntu에 ClickHouse 설치하기

Debian/Ubuntu에 ClickHouse 설치하기 (Install ClickHouse on Debian/Ubuntu)

공식 deb 패키지로 Debian 또는 Ubuntu에 ClickHouse를 설치하는 방법을 단계별로 안내합니다. APT 저장소를 설정하고 서버·클라이언트 및 ClickHouse Keeper를 설치·실행합니다.

출처: 문서

본문

Debian 또는 Ubuntu에서는 공식 사전 컴파일 deb 패키지를 사용하는 것이 좋습니다.

1. 권장 사항 확인

ClickHouse를 설치하기 전에 다음 권장 사항을 확인하세요:

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

저장 공간 추정 데이터에 필요한 디스크 공간을 추정하려면:

1. 데이터 볼륨 추정: 데이터의 샘플을 가져와 평균 행 크기를 계산한 뒤, 저장할 행 수를 곱하세요.
2. 압축 계수 적용: 샘플을 ClickHouse에 로드해 원본 데이터 크기와 저장된 테이블 크기를 비교하세요. 예를 들어 클릭스트림 데이터는 보통 6~10배 압축됩니다.
3. 복제본 고려: 여러 복제본에 데이터를 저장하려면 추정 볼륨에 복제본 수를 곱하세요.

더 자세한 하드웨어 요구사항은 "Sizing and hardware recommendations"을 참고하세요.

2. 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 서버와 클라이언트 패키지 설치
sudo apt-get install -y clickhouse-server clickhouse-client

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

# ClickHouse 커맨드라인 클라이언트 실행
clickhouse-client # 또는 비밀번호를 설정했다면 "clickhouse-client --password"

3. ClickHouse 서버와 클라이언트 설치

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

4. ClickHouse 시작

ClickHouse 서버를 시작하려면:

sudo service clickhouse-server start

ClickHouse 클라이언트를 시작하려면:

clickhouse-client

서버에 비밀번호를 설정했다면 다음을 실행해야 합니다:

clickhouse-client --password

5. 독립형 ClickHouse Keeper 설치

프로덕션 환경에서는 ClickHouse Keeper를 전용 노드에서 실행하는 것을 강력히 권장합니다. 테스트 환경에서 ClickHouse Server와 ClickHouse Keeper를 같은 서버에서 실행하기로 했다면, ClickHouse Keeper는 서버에 포함되어 있으므로 별도로 설치할 필요가 없습니다.

독립형 ClickHouse Keeper 서버에 clickhouse-keeper를 설치하려면:

sudo apt-get install -y clickhouse-keeper

6. ClickHouse Keeper 활성화 및 시작

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

패키지 (Packages)

사용 가능한 다양한 deb 패키지는 아래와 같습니다:

특정 버전의 ClickHouse를 설치해야 한다면 모든 패키지를 같은 버전으로 설치해야 합니다: sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7

더 알아보기 (Learn more)

• Quick install
• RedHat 설치
• Docker 설치