tgz 아카이브로 ClickHouse 설치하기
tgz 아카이브로 ClickHouse 설치하기 (Install ClickHouse using tgz archives)
deb 또는 rpm 패키지 설치가 어려운 Linux 배포판에서 공식 tgz 아카이브로 ClickHouse를 설치하는 방법을 안내합니다. 단계별로 최신 안정 버전을 내려받아 압축을 풀고 설치합니다.
출처: 문서
본문
deb또는rpm패키지 설치가 불가능한 모든 Linux 배포판에서는 공식 사전 컴파일tgz아카이브를 사용하는 것이 좋습니다.
- 권장 사항 확인
ClickHouse를 설치하기 전에 다음 권장 사항을 확인하세요:
- Swap: 프로덕션 환경에서는 운영 체제의 스왑 파일을 비활성화하세요.
- 디스크 공간: ClickHouse 바이너리는 설치에 최소 2.5 GB의 디스크 공간이 필요합니다.
- 네트워크: 분산 배포(클러스터링)에는 최소 10 Gbit 네트워크 연결을 사용하세요. 네트워크 대역폭은 대량의 중간 데이터를 처리하는 분산 쿼리와 복제에 매우 중요합니다.
저장 공간 추정 데이터에 필요한 디스크 공간을 추정하려면:
- 데이터 볼륨 추정: 데이터의 샘플을 가져와 평균 행 크기를 계산한 뒤, 저장할 행 수를 곱하세요.
- 압축 계수 적용: 샘플을 ClickHouse에 로드해 원본 데이터 크기와 저장된 테이블 크기를 비교하세요. 예를 들어 클릭스트림 데이터는 보통 6~10배 압축됩니다.
- 복제본 고려: 여러 복제본에 데이터를 저장하려면 추정 볼륨에 복제본 수를 곱하세요.
더 자세한 하드웨어 요구사항은 "Sizing and hardware recommendations"을 참고하세요.
- 최신 안정 버전 다운로드 및 설치
필요한 버전은 https://packages.clickhouse.com/tgz/ 저장소에서 curl 또는 wget으로 내려받을 수 있습니다. 그 후 내려받은 아카이브를 압축 해제하고 설치 스크립트로 설치합니다. 아래는 최신 안정 버전 설치 예시입니다.
프로덕션 환경에서는 최신 stable 버전을 사용하는 것을 권장합니다. 릴리스 번호는 이 GitHub 페이지에서 -stable 접미사를 붙여 찾을 수 있습니다.
- 최신 ClickHouse 버전 가져오기
GitHub에서 최신 ClickHouse 버전을 가져와 LATEST_VERSION 변수에 저장합니다.
LATEST_VERSION=$(curl -s https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/utils/list-versions/version_date.tsv | \
grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | sort -V -r | head -n 1)
export LATEST_VERSION
- 시스템 아키텍처 감지
시스템 아키텍처를 감지하고 그에 맞게 ARCH 변수를 설정합니다:
case $(uname -m) in
x86_64) ARCH=amd64 ;; # For Intel/AMD 64-bit processors
aarch64) ARCH=arm64 ;; # For ARM 64-bit processors
*) echo "Unknown architecture $(uname -m)"; exit 1 ;; # Exit if architecture isn't supported
esac
- 각 ClickHouse 컴포넌트용 tarball 다운로드
각 ClickHouse 컴포넌트용 tarball을 내려받습니다. 이 루프는 아키텍처별 패키지를 먼저 시도하고, 없으면 일반 패키지로 폴백합니다.
for PKG in clickhouse-common-static clickhouse-common-static-dbg clickhouse-server clickhouse-client clickhouse-keeper
do
curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION-${ARCH}.tgz" \
|| curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION.tgz"
done
- 패키지 압축 해제 및 설치
다음 명령을 실행해 아래 패키지들을 압축 해제하고 설치합니다:
clickhouse-common-static
# clickhouse-common-static 패키지 압축 해제 및 설치
tar -xzvf "clickhouse-common-static-$LATEST_VERSION-${ARCH}.tgz" \
|| tar -xzvf "clickhouse-common-static-$LATEST_VERSION.tgz"
sudo "clickhouse-common-static-$LATEST_VERSION/install/doinst.sh"
clickhouse-common-static-dbg
# 디버그 심볼 패키지 압축 해제 및 설치
tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION-${ARCH}.tgz" \
|| tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION.tgz"
sudo "clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh"
clickhouse-server
# 설정을 포함한 서버 패키지 압축 해제 및 설치
tar -xzvf "clickhouse-server-$LATEST_VERSION-${ARCH}.tgz" \
|| tar -xzvf "clickhouse-server-$LATEST_VERSION.tgz"
sudo "clickhouse-server-$LATEST_VERSION/install/doinst.sh" configure
sudo /etc/init.d/clickhouse-server start # 서버 시작
clickhouse-client
# 클라이언트 패키지 압축 해제 및 설치
tar -xzvf "clickhouse-client-$LATEST_VERSION-${ARCH}.tgz" \
|| tar -xzvf "clickhouse-client-$LATEST_VERSION.tgz"
sudo "clickhouse-client-$LATEST_VERSION/install/doinst.sh"