ClickHouse 서버 설치

외부 VM 서버에 ClickHouse를 설치하는 방법을 안내합니다.

📋 업데이트 예정

알림: ClickHouse 서버 설치 스크립트(o11y-db-install.sh)는 현재 개발 중입니다.
이 문서는 스크립트 완성 후 업데이트될 예정입니다.

개요

Skuber+ Observability는 3-Tier 아키텍처를 사용합니다. ClickHouse는 Host Cluster 내부가 아닌 별도의 외부 VM 서버에 설치됩니다.

환경 규모에 따라 두 가지 구성 옵션을 선택할 수 있습니다.

구성 옵션

옵션 1: 단일 노드 구성 (소규모 환경)

개발, 테스트, 소규모 프로덕션 환경에 적합합니다.

특징:

• ClickHouse 노드 1개
• ClickHouse Keeper 불필요
• 설치 및 관리 간단
• 데이터 복제 없음 (정기 백업 필수)

적합한 환경:

• 개발/테스트 환경
• 일일 데이터 50GB 이하
• Agent 클러스터 1~5개

옵션 2: 클러스터 구성 (대규모 환경)

고가용성과 데이터 복제가 필요한 프로덕션 환경에 적합합니다.

특징:

• ClickHouse 노드 2개 이상
• ClickHouse Keeper 클러스터 필수 (3개 노드)
• 데이터 자동 복제 (고가용성)
• 노드 장애 시에도 서비스 지속

적합한 환경:

• 프로덕션 환경
• 일일 데이터 50GB 이상
• Agent 클러스터 5개 이상
• SLA 요구사항이 있는 경우

하드웨어 요구사항

옵션 1: 단일 노드

옵션 2: 클러스터

ClickHouse 서버 (노드당)

ClickHouse Keeper

참고: Keeper를 ClickHouse 노드와 같은 VM에 배치하면 VM 수를 줄일 수 있지만, 고성능 환경에서는 별도 VM을 권장합니다.

스토리지 산정 기준

네트워크 요구사항

설치 방법 (예정)

설치 스크립트 (개발 중)

# 🚧 개발 중 - 향후 제공 예정

# 옵션 1: 단일 노드
./o11y-db-install.sh \
  --mode single \
  --host <clickhouse-vm-ip> \
  --ssh-user <ssh-username> \
  --ssh-key <path-to-ssh-key>

# 옵션 2: 클러스터
./o11y-db-install.sh \
  --mode cluster \
  --hosts <clickhouse-vm-ip-1>,<clickhouse-vm-ip-2> \
  --ssh-user <ssh-username> \
  --ssh-key <path-to-ssh-key> \
  --keeper-nodes <keeper-ip-1>,<keeper-ip-2>,<keeper-ip-3>

수동 설치 (임시)

스크립트가 준비되기 전까지 수동으로 설치할 수 있습니다.

옵션 1: 단일 노드 설치

Step 1: ClickHouse 설치

# Ubuntu/Debian
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg
curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | \
  sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg] \
  https://packages.clickhouse.com/deb stable main" | \
  sudo tee /etc/apt/sources.list.d/clickhouse.list
sudo apt-get update
sudo apt-get install -y clickhouse-server clickhouse-client

Step 2: 외부 접속 허용

sudo vi /etc/clickhouse-server/config.d/listen.xml

<clickhouse>
    <listen_host>0.0.0.0</listen_host>
</clickhouse>

Step 3: 서비스 시작

sudo systemctl start clickhouse-server
sudo systemctl enable clickhouse-server

Step 4: 연결 테스트

clickhouse-client --host localhost --query "SELECT 1"

옵션 2: 클러스터 설치

클러스터 구성은 ClickHouse 공식 문서를 참조하세요:

• ClickHouse Cluster Deployment
• ClickHouse Keeper

구성 선택 가이드

다음 단계

ClickHouse 서버 설치가 완료되면:

• Host 클러스터 설치 - ClickHouse 연결 정보로 Host 설치
• Agent 클러스터 설치 - 모니터링 대상 클러스터 설치

참고 자료

• ClickHouse 공식 문서
• ClickHouse Keeper 설정
• ClickHouse 클러스터 구성