> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# kubectl로 ClickHouse Operator 설치

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

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

<div id="prerequisites">
  ## 사전 요구 사항
</div>

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

<div id="install-from-release-manifests">
  ## 릴리스 매니페스트를 사용해 설치
</div>

<Note>
  웹훅 인증서를 발급하려면 cert-manager가 필요합니다.
</Note>

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

```bash theme={null}
kubectl apply --server-side --force-conflicts -f https://github.com/ClickHouse/clickhouse-operator/releases/latest/download/clickhouse-operator.yaml
```

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

```bash theme={null}
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. 메트릭 엔드포인트를 활성화합니다

<div id="verify-installation">
  ## 설치 확인
</div>

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

```bash theme={null}
kubectl get pods -n clickhouse-operator-system
```

예상 출력:

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

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

```bash theme={null}
kubectl get crd | grep clickhouse.com
```

예상 출력:

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

<div id="configure-custom-deployment-options">
  ## 사용자 지정 배포 옵션 구성
</div>

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

<Steps>
  <Step>
    ### 리포지토리 클론

    ```bash theme={null}
    git clone https://github.com/ClickHouse/clickhouse-operator.git
    cd clickhouse-operator
    ```
  </Step>

  <Step>
    ### 설치 옵션 구성

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

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

  <Step>
    ### 빌드 및 배포

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

    ```bash theme={null}
    make build-installer VERSION=<required operator version> [IMG=<custom registry path>]
    kubectl apply --server-side --force-conflicts -f dist/install.yaml
    ```
  </Step>
</Steps>