관리형 서비스

​

관리형 모드의 동작 방식

​

관리형 모드 활성화

​

서비스 생성

• prepare에는 커넥터 구성 사본(--config), 실행기의 로컬 API로 연결되는 kubectl port-forward, 그리고 쓰기 가능한 --output-dir가 필요합니다. 이 명령어는 실행기를 통해 서비스 이름을 확인하며, 실행기에 연결할 수 없으면 실행을 거부합니다.
• 현재 호스트에 구성에 지정된 자격 증명 파일이 없으면, instances create는 이를 clicklink-hmac 및 clicklink-mtls 시크릿에서 읽어오며 읽을 때마다 이를 알립니다. 커넥터 네임스페이스가 clicklink가 아니면 --connector-namespace를 추가하십시오. 이 폴백 동작은 instances create에만 적용됩니다.

CONNECTOR_NAMESPACE='clicklink'   # init 단계에서 선택한 커넥터 네임스페이스
kubectl -n "${CONNECTOR_NAMESPACE}" get configmap clicklink-connector-executor \
  -o jsonpath='{.data.config\.yaml}' > clicklink-config.yaml
kubectl -n "${CONNECTOR_NAMESPACE}" port-forward deployment/clicklink-connector-executor 9999:9999 &
clicklink clctl executor prepare --config clicklink-config.yaml --output-dir ./clicklink-access

sudo clicklink clctl executor prepare --config /etc/clicklink/config.yaml

clicklink clctl instances create \
  --from-prepare ./clicklink-access/_prepare/<name>.create.json \
  --config clicklink-config.yaml \
  --wait

sudo clicklink clctl instances create \
  --from-prepare /etc/clicklink/access/executor/_prepare/<name>.create.json \
  --config /etc/clicklink/config.yaml \
  --wait

clicklink clctl instances get --name <name> --cluster <eks-cluster-name>

​

상태

kubectl -n <connector-namespace> port-forward deployment/clicklink-connector-executor 9999:9999
clicklink clctl instances list --endpoint http://127.0.0.1:9999

• provisioning: 아직 준비된 서버 레플리카가 없거나, ClickHouseCluster가 아직 존재하지 않음
• running: 예상된 모든 서버 레플리카가 준비됨
• degraded: 일부 서버 레플리카만 준비되고 전부는 준비되지 않음
• terminating: 실행기가 서비스를 제거하는 중
• terminated: 서비스의 네임스페이스가 사라짐
• stale: 삭제 절차 없이 서비스가 실행기의 registry에서 제거됨. --wait와 teardown은 이를 terminated와 동일하게 취급합니다

​

서비스 수명 주기

• Scale. ClickHouse Cloud가 고정된 레플리카 수를 지정하며, 그 상한은 ClickHouse Cloud 설정으로 결정됩니다(기본 구성에서는 20). 자동 스케일링은 지원되지 않습니다.
• Stop 및 start. 중지하면 서버가 0으로 스케일되고 Keeper는 유지됩니다. 시작하면 레플리카 수가 복원됩니다. 이 과정 내내 데이터는 사용자의 버킷에 그대로 남아 있습니다.
• Restart. 전체 서비스, 해당 Keeper, 또는 단일 파드를 재시작합니다.
• Backups. ClickHouse Cloud가 백업을 트리거하며, 백업은 백업 버킷에 저장되고 백업을 삭제하면 제거됩니다.
• 버전 업그레이드 및 구성 변경. ClickHouse Cloud는 새 버전이나 설정을 반영해 서비스 정의를 다시 렌더링합니다. 이는 create_instance 명령어로 전달되므로 commands list --action create_instance에서도 업그레이드를 확인할 수 있습니다. 실행기는 이를 적용한 뒤 레플리카가 다시 준비 상태가 될 때까지 대기합니다.
• Delete. 서비스 삭제에서 설명합니다.

​

관리형 서비스의 지원 세션

printf '%s\n' "$CH_DEFAULT_PASSWORD" | clicklink clctl troubleshoot access provision --target helm \
  --target-namespace "${CONNECTOR_NAMESPACE}" \
  --instance <name> --instance-namespace ns-<name> \
  --server <kubernetes-api-server-url> --ch-admin-password-stdin \
  --apply-ch-grants --ch-pod <clickhouse-pod-or-label-selector> --ch-pod-namespace ns-<name>

printf '%s\n' "$CH_DEFAULT_PASSWORD" | sudo clicklink clctl troubleshoot access provision --provider local \
  --instance <name> --instance-namespace ns-<name> \
  --server <kubernetes-api-server-url> --ch-admin-password-stdin

​

서비스 삭제

kubectl -n "${CONNECTOR_NAMESPACE}" port-forward deployment/clicklink-connector-executor 9999:9999 &
clicklink clctl executor teardown --instance <name> --config clicklink-config.yaml --output-dir ./clicklink-access

sudo clicklink clctl executor teardown --instance <name>

​

커넥터가 오프라인일 때