Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

kubectl로 ClickHouse Operator 설치

View as MarkdownEdit this pageReport an issueSet up docs MCP

이 가이드에서는 kubectl과 매니페스트 파일을 사용해 ClickHouse Operator를 설치하는 방법을 설명합니다.

사전 요구 사항

  • Kubernetes 클러스터 v1.28.0 이상
  • kubectl v1.28.0 이상
  • 클러스터 관리자 권한

릴리스 매니페스트를 사용해 설치

최신 릴리스에서 연산자와 CRD를 설치합니다:

kubectl apply --server-side --force-conflicts -f https://github.com/ClickHouse/clickhouse-operator/releases/latest/download/clickhouse-operator.yaml

결합된 CRD의 크기가 클라이언트 측 apply 제한을 초과하므로 서버 측 apply가 필요합니다. 클라이언트 측 apply만 지원하는 환경에서는 설명이 제거된 CRD 변형을 사용하십시오:

kubectl apply -f https://github.com/ClickHouse/clickhouse-operator/releases/latest/download/clickhouse-operator-stripped-crds.yaml

다음 작업이 수행됩니다:

  1. clickhouse-operator-system 네임스페이스를 생성합니다
  2. ClickHouseCluster 및 KeeperCluster용 사용자 지정 리소스 정의(CRD)를 설치합니다
  3. 필요한 ServiceAccount, Role, RoleBinding을 생성합니다
  4. 연산자 컨트롤러 매니저를 배포합니다
  5. 리소스 유효성 검사와 기본값 설정을 위한 웹훅을 등록합니다
  6. cert-manager를 사용하여 SSL 인증서를 구성합니다
  7. 메트릭 엔드포인트를 활성화합니다

설치 확인

연산자가 실행 중인지 확인합니다:

kubectl get pods -n clickhouse-operator-system

예상 출력:

NAME                                                 READY   STATUS    RESTARTS   AGE
clickhouse-operator-controller-manager-xxxxxxxxxx    1/1     Running   0          1m

CRD가 설치되어 있는지 확인하십시오:

kubectl get crd | grep clickhouse.com

예상 출력:

clickhouseclusters.clickhouse.com    2025-01-06T00:00:00Z
keeperclusters.clickhouse.com        2025-01-06T00:00:00Z

사용자 지정 배포 옵션 구성

연산자 배포 옵션을 구성하려면 아래 단계를 따르십시오.

리포지토리 클론

git clone https://github.com/ClickHouse/clickhouse-operator.git
cd clickhouse-operator

설치 옵션 구성

필요에 따라 기능을 활성화하거나 비활성화하려면 config/default/kustomization.yaml을 편집하십시오.

  • 웹훅을 비활성화하려면 [WEBHOOK] 및 [CERTMANAGER] 섹션을 주석 처리하십시오.
  • 보안 메트릭 엔드포인트를 활성화하려면 [METRICS] 섹션을 주석 처리하고 [METRICS SECURE] 및 [CERTMANAGER] 섹션의 주석을 해제하십시오.
  • Prometheus Operator용 ServiceMonitor를 활성화하려면 [PROMETHEUS] 섹션의 주석을 해제하십시오.
  • 연산자 네트워크 정책을 활성화하려면 [NETWORK POLICY] 섹션의 주석을 해제하십시오.

빌드 및 배포

연산자 매니페스트를 빌드한 후 적용합니다.

make build-installer VERSION=<required operator version> [IMG=<custom registry path>]
kubectl apply --server-side --force-conflicts -f dist/install.yaml
Navigation