Linux x86_64 에서 ClickHouse 데이터 스토어 업그레이드

ClickHouse 운영자를 업그레이드하고 ClickHouse 데이터 저장소를 업그레이드하십시오.

참고:
ClickHouse 클러스터를 처음 생성한 후나 샤드 수가 증가한 후에는, 클러스터가 샤드를 연결하는 데 몇 분이 소요될 수 있습니다.

시작하기 전에

외부 저장소에서 이미지를 가져올 수 있도록 온라인 및 오프라인 호스트를 미리 설정해 두십시오. 또한, Helm 저장소를 추가했는지 확인하세요.

ClickHouse 연산자 버전 및 이미지 태그

고정된 ‘ Helm ’ 차트 또는 운영자용 버전에 다음 이미지가 필요합니다.

플랫폼 오퍼레이터 버전 Helm 차트 버전 태그가 지정된 이미지
Linux® x86_64 v1.2.39 v1.2.0

artifact-public.instana.io/clickhouse-operator: v1.2.39

artifact-public.instana.io/clickhouse: 25.8.13.73-7-lts-ibm

ClickHouse 온라인 업그레이드

ClickHouse 데이터 스토어를 업그레이드하려면 다음 단계를 따르십시오.

  1. ClickHouse 연산자를 업그레이드합니다.

    helm upgrade --install clickhouse-operator instana/ibm-clickhouse-operator -n instana-clickhouse --version=v1.2.0 --set operator.image.repository=artifact-public.instana.io/clickhouse-operator --set operator.image.tag=v1.2.39 --set imagePullSecrets[0].name="instana-registry"
     
  2. 다음 패치를 적용하여 ClickHouse 사용자 정의 리소스를 업데이트하십시오.

    kubectl patch ClickHouseInstallation instana -n instana-clickhouse --type=strategic --patch '
    spec:
      templates:
        podTemplates:
          - name: clickhouse
            spec:
              containers:
                - name: instana-clickhouse
                  image: artifact-public.instana.io/clickhouse:25.8.13.73-7-lts-ibm
                - name: clickhouse-log
                  image: artifact-public.instana.io/clickhouse:25.8.13.73-7-lts-ibm
        '
     
  3. ‘ ClickHouse 확인(온라인 및 오프라인) ’의 단계를 완료하십시오.

ClickHouse 오프라인 업그레이드

에어갭 환경에서 ` ClickHouse ` 오퍼레이터를 업그레이드합니다.

아직 외부 레지스트리에서 ClickHouse 이미지를 가져오지 않았다면, 지금 가져올 수 있습니다. 바스티온 호스트에서 다음 명령어를 실행하십시오. 그런 다음, 해당 이미지를 에어갭 환경에 있는 Instana 호스트로 복사하십시오.

docker pull artifact-public.instana.io/clickhouse-operator:v1.2.39
docker pull artifact-public.instana.io/clickhouse:25.8.13.73-7-lts-ibm
         

Instana 호스트에서 다음 단계를 수행하십시오.

  1. 이미지를 내부 이미지 레지스트리에 다시 태그 지정하십시오.
    docker tag artifact-public.instana.io/clickhouse-operator:v1.2.39 <internal-image-registry>/clickhouse-operator:v1.2.39
    docker tag artifact-public.instana.io/clickhouse:25.8.13.73-7-lts-ibm <internal-image-registry>/clickhouse:25.8.13.73-7-lts-ibm
                   
  2. 이미지를 내부 이미지 레지스트리로 전송하세요.
    docker push <internal-image-registry>/clickhouse-operator:v1.2.39
    docker push <internal-image-registry>/clickhouse:25.8.13.73-7-lts-ibm
                   
  3. ClickHouse 운영자를 업그레이드합니다.
    helm upgrade --install clickhouse-operator ibm-clickhouse-operator-v1.2.39.tgz -n instana-clickhouse --version=v1.2.0 --set operator.image.repository=<internal-image-registry>/clickhouse-operator --set operator.image.tag=v1.2.39
                   
  4. 다음 패치를 적용하여 Clickhouse 사용자 정의 리소스를 업데이트하십시오.
    kubectl patch ClickHouseInstallation instana -n instana-clickhouse --type=strategic --patch '
    spec:
      templates:
        podTemplates:
          - name: clickhouse
            spec:
              containers:
                - name: instana-clickhouse
                  image: <internal-image-registry>/clickhouse:25.8.13.73-7-lts-ibm
                - name: clickhouse-log
                  image: <internal-image-registry>/clickhouse:25.8.13.73-7-lts-ibm
         '
     
  5. ‘ ClickHouse 확인(온라인 및 오프라인) ’의 단계를 완료하십시오.

ClickHouse 확인 (온라인 및 오프라인)

ClickHouse 인스턴스와 데이터 저장소를 확인하려면 다음 단계를 따르십시오.

  1. ClickHouse 업그레이드가 완료될 때까지 기다려 주십시오.

    kubectl wait clickhouse/instana --for=condition=Ready --timeout=300s -n instana-clickhouse
     
  2. ClickHouse 운영자 업그레이드를 확인하십시오.

    kubectl get all -n instana-clickhouse
     

    Zookeeper를 사용하고 있으며 ClickHouse 오퍼레이터의 업그레이드가 성공적으로 완료된 경우, 다음 예시와 Running 같이 명령어 실행 결과에 오퍼레이터 상태가 표시됩니다:

    NAME                                                                  READY   STATUS    RESTARTS   AGE
    pod/chi-instana-local-0-0-0                                           2/2     Running   0          8m46s
    pod/chi-instana-local-0-1-0                                           2/2     Running   0          8m5s
    pod/clickhouse-operator-altinity-clickhouse-operator-86b5f9b57689rr   2/2     Running   0          70m
    pod/instana-zookeeper-0                                               1/1     Running   0          4h3m
    pod/instana-zookeeper-1                                               1/1     Running   0          4h2m
    pod/instana-zookeeper-2                                               1/1     Running   0          4h2m
    
    NAME                                                               TYPE           CLUSTER-IP      EXTERNAL-IP     PORT(S)                                        AGE
    service/chi-instana-local-0-0                                      ClusterIP      None            <none>          9000/TCP,8123/TCP,9009/TCP                     8m16s
    service/chi-instana-local-0-1                                      ClusterIP      None            <none>          9000/TCP,8123/TCP,9009/TCP                     7m35s
    service/clickhouse-instana                                         LoadBalancer   192.168.1.167   35.246.237.19   8123:32714/TCP,9000:31317/TCP                  8m11s
    service/clickhouse-operator-altinity-clickhouse-operator-metrics   ClusterIP      192.168.1.136   <none>          8888/TCP                                       70m
    service/instana-zookeeper-admin-server                             ClusterIP      192.168.1.126   <none>          8080/TCP                                       4h3m
    service/instana-zookeeper-client                                   ClusterIP      192.168.1.13    <none>          2181/TCP                                       4h3m
    service/instana-zookeeper-headless                                 ClusterIP      None            <none>          2181/TCP,2888/TCP,3888/TCP,7000/TCP,8080/TCP   4h3m
    
    NAME                                                               READY   UP-TO-DATE   AVAILABLE   AGE
    deployment.apps/clickhouse-operator-altinity-clickhouse-operator   1/1     1            1           70m
    
    NAME                                                                          DESIRED   CURRENT   READY   AGE
    replicaset.apps/clickhouse-operator-altinity-clickhouse-operator-86b5f9b579   1         1         1       70m
    
    NAME                                     READY   AGE
    statefulset.apps/chi-instana-local-0-0   1/1     8m50s
    statefulset.apps/chi-instana-local-0-1   1/1     8m9s
    statefulset.apps/instana-zookeeper       3/3     4h3m
     

    ClickhouseKeeper 를 사용 중이고 ClickHouse 운영자가 성공적으로 업그레이드된 경우, 다음 예시와 Running 같이 명령어 실행 결과에 운영자 상태가 표시됩니다:

     NAME                                                               READY   STATUS    RESTARTS   AGE
     pod/chi-instana-local-0-0-0                                        2/2     Running   0          8m46s
     pod/chi-instana-local-0-1-0                                        2/2     Running   0          8m5s
     pod/clickhouse-keeper-0                                            1/1     Running   0          4h3m
     pod/clickhouse-keeper-1                                            1/1     Running   0          4h3m
     pod/clickhouse-keeper-2                                            1/1     Running   0          4h3m
     pod/clickhouse-operator-ibm-clickhouse-operator-7754679687-bpwlx   1/1     Running   0          4h13m
    
     NAME                                                          TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)                      AGE
     service/chi-instana-local-0-0                                 ClusterIP   None             <none>        9000/TCP,8123/TCP,9009/TCP   8m16s
     service/chi-instana-local-0-1                                 ClusterIP   None             <none>        9000/TCP,8123/TCP,9009/TCP   7m35s
     service/clickhouse-instana                                    ClusterIP   172.30.236.81    <none>        8123/TCP,9000/TCP            8m20s
     service/clickhouse-keeper                                     ClusterIP   172.30.115.37    <none>        2181/TCP,7000/TCP            4h3m
     service/clickhouse-keeper-headless                            ClusterIP   None             <none>        9444/TCP                     4h3m
     service/clickhouse-operator-ibm-clickhouse-operator-metrics   ClusterIP   172.30.120.179   <none>        8888/TCP                     4h23m
    
     NAME                                                          READY   UP-TO-DATE   AVAILABLE   AGE
     deployment.apps/clickhouse-operator-ibm-clickhouse-operator   1/1     1            1           4h23m
    
     NAME                                                                     DESIRED   CURRENT   READY   AGE
     replicaset.apps/clickhouse-operator-ibm-clickhouse-operator-7754679687   1         1         1       4h23m
    
     NAME                                     READY   AGE
     statefulset.apps/chi-instana-local-0-0   1/1     8m20s
     statefulset.apps/chi-instana-local-0-1   1/1     8m20s
     statefulset.apps/clickhouse-keeper       3/3     4h3m