구성 - ClickHouse Documentation

이 페이지에서는 커넥터 설치 후 가장 자주 변경하는 구성 항목을 다룹니다. 각 키의 기본값과 의미는 구성 참고에, 명령 플래그는 CLI 참고에 정리되어 있습니다. 서비스 생성, 스케일링, 삭제는 관리형 서비스에서 다룹니다.

구성 방식

커넥터는 설치 대상마다 하나의 구성 방식을 제공합니다.

Kubernetes
Linux VM

clicklink clctl init는 작업 디렉터리에 clicklink-values.yaml이라는 values 오버레이를 준비하고 이를 사용해 clicklink-connector 차트를 배포합니다. 이 오버레이는 배포 구성을 영구적으로 기록합니다. --force를 전달하지 않는 한 init를 다시 실행해도 유지되므로, 편집 내용은 재실행이나 복구 후에도 보존됩니다.

이 페이지와 운영의 Day-2 명령어는 helm CLI를 사용합니다. 기본 제공 Helm 클라이언트는 init에만 포함되어 있습니다.

오버레이를 편집한 후 적용하십시오.

CONNECTOR_NAMESPACE='clicklink'   # init에서 선택한 커넥터 네임스페이스
CHART_VERSION="$(helm get metadata clicklink-connector -n "${CONNECTOR_NAMESPACE}" | awk '/^VERSION:/{print $2}')"
helm upgrade clicklink-connector clicklink-connector \
  --repo https://releases.clicklink.clickhouse.com/charts \
  --version "${CHART_VERSION}" \
  --namespace "${CONNECTOR_NAMESPACE}" \
  -f clicklink-values.yaml

이 명령 블록은 이미 설치된 차트 버전에 편집한 values를 다시 적용하므로, 구성 변경으로 인해 의도하지 않은 업그레이드가 수행되지 않습니다. 새 버전으로 이동하는 작업은 별도의 단계입니다. 운영을 참조하십시오. 차트 리포지토리를 사용하는 미러 설치에서는 --repo를 미러로 바꾸십시오.직접 차트 참조(oci://, URL 또는 로컬 아카이브나 디렉터리, 프라이빗 미러 참조)로 설치한 경우에는 확인할 리포지토리가 없습니다. 설치에 사용한 참조로 업그레이드를 다시 실행하십시오.

helm upgrade clicklink-connector <same-chart-reference> \
  --version "${CHART_VERSION}" \
  -n "${CONNECTOR_NAMESPACE}" \
  -f clicklink-values.yaml

clicklink clctl init는 /etc/clicklink/config.yaml을 작성합니다. --force를 전달하지 않는 한 init를 다시 실행해도 기존 구성이 유지되므로 파일을 직접 편집해도 안전합니다. 편집한 후 데몬을 재시작하고 확인하십시오.

sudo systemctl restart clicklink-scraper clicklink-troubleshooter clicklink-executor
sudo clicklink clctl preflight

관리형 모드

관리형 모드는 실행기를 구동하며, 이 실행기는 ClickHouse Cloud가 주도하는 서비스 수명 주기를 클러스터에 적용합니다. init은 등록 시점에 관리형 모드를 활성화하고 클러스터 아이덴티티를 채웁니다(관리형 모드 활성화 참조). 아래 키는 이후에 다시 살펴보게 될 수 있는 항목입니다. 설정 상태를 변경하려면 --force와 함께 --managed 또는 --no-managed를 지정하여 init을 다시 실행하십시오. 모든 init 실행과 마찬가지로 진입점이 필요합니다. bundle을 보관해 두었다면 --handoff를, 그렇지 않다면 새 토큰과 함께 --enroll을 사용하십시오(재실행 및 복구 참조). VM에서 --no-managed는 구성에서 실행기를 비활성화할 뿐, 실행 중인 systemd unit을 중지하거나 비활성화하지는 않습니다. 구성을 변경하기 전에 먼저 중지하십시오.

sudo systemctl disable --now clicklink-executor

Kubernetes에서는 values에 executor.enabled: false를 설정하고 helm upgrade로 적용하여 실행기 배포를 제거하십시오. 두 대상 모두 클러스터 권한 부여는 직접 제거하기 전까지 그대로 유지됩니다. 관리형 모드 중지를 참조하십시오.

Kubernetes
Linux VM

init은 현재 kube Context가 가리키는 EKS cluster의 정보를 바탕으로 clicklink-values.yaml의 executor 블록을 구성합니다:

cluster:
  # Service namespaces are <namespacePrefix><service>; must match the
  # prefix you registered.
  namespacePrefix: ns-

executor:
  enabled: true
  pollInterval: 30s
  syncInterval: 30s
  # Local command API, bound to 127.0.0.1 inside the pod only.
  apiPort: 9999
  ports:
    health: 8086
  cluster:
    name: <eks-cluster-name>
    region: us-east-1
    accountId: "123456789012"
    inCluster: true
    # Optional shared data bucket; per-service storage normally arrives
    # with each service, so leave it out unless your account team asks for it.
    # s3_storage:
    #   bucket: <data-bucket>
    #   backup_bucket: <backup-bucket>
  serviceAccount:
    create: false
    name: pcm-executor
  persistence:
    enabled: true
    storageClass: ""
    size: 5Gi
  platformBundleSecret: clicklink-platform-bundle

**cluster.namespacePrefix**는 모든 구성 요소가 공유하는 값이며, 실행기의 권한 부여가 적용 범위를 제한할 때 사용하는 접두사입니다. 설치 후 이 값을 변경하면 권한 부여를 다시 실행해야 합니다.
**executor.cluster**에는 정확히 하나의 클러스터만 지정합니다: name, region, accountId, inCluster: true를 지정하면 실행기가 파드의 ServiceAccount로 인증합니다. 그 외의 키는 s3_storage처럼 snake_case 형태 그대로 실행기에 전달됩니다.
**executor.serviceAccount**는 create: false로 유지합니다. init이 커넥터 네임스페이스의 pcm-executor ServiceAccount에 클러스터 전역 액세스 권한을 부여하고, 차트는 바인딩되지 않은 ServiceAccount를 새로 만드는 대신 이 ServiceAccount에 바인딩합니다.
**executor.persistence**는 /var/lib/clicklink를 뒷받침하며, 실행기는 이 경로에 명령 데이터베이스와 서비스 registry를 보관합니다. 저장소를 참조하십시오.
**executor.platformBundleSecret**은 승인된 플랫폼 업데이트를 담고 있는 시크릿의 이름을 지정합니다. 이 마운트는 선택 사항이므로 첫 승인 이전에도 파드가 시작됩니다. 플랫폼 업데이트 승인을 참조하십시오.
**executor.ports.health**는 /livez와 /metrics를 제공합니다. 어떤 구성 요소에도 별도의 메트릭 포트는 없습니다.

구성 표면에 나온 helm upgrade 명령으로 변경 사항을 적용하십시오.

init은 호스트의 인스턴스 메타데이터와 kubeconfig를 사용해 executor 블록을 /etc/clicklink/config.yaml에 기록합니다. interval 및 port 키는 기본값이며, 재정의하려면 다음과 같이 추가하면 됩니다:

# Service namespaces are <namespace_prefix><service>; must match the
# prefix you registered.
namespace_prefix: ns-

executor:
  enabled: true
  cluster:
    name: <eks-cluster-name>
    region: us-east-1
    account_id: "123456789012"
    # Optional shared data bucket; per-service storage normally arrives
    # with each service, so leave it out unless your account team asks for it.
    # s3_storage:
    #   bucket: <data-bucket>
    #   backup_bucket: <backup-bucket>
  poll_interval: 5m
  sync_interval: 30s
  # Local command API, bound to 127.0.0.1 only.
  api_port: 9999
  observability:
    health_port: 8086

**namespace_prefix**는 모든 컴포넌트가 공유하는 최상위 키이며, executor의 grant가 적용되는 범위를 한정하는 접두사입니다. 설치 후 이 값을 변경하면 grant를 다시 실행해야 합니다.
**executor.cluster**에는 정확히 하나의 클러스터만 지정합니다. executor는 init이 /etc/clicklink/access/executor/_cluster 아래에 생성한 클러스터 전역 액세스 번들로 인증합니다.
**poll_interval**은 executor가 기록했으나 완료하지 못한 명령어를 재시도하는 주기이고, **sync_interval**은 관리형 서비스의 상태를 클러스터와 리컨실하는 주기입니다.
**api_port**는 executor의 로컬 명령 API입니다. 루프백 인터페이스에만 바인딩되고 자체 인증 수단이 없으므로, clicklink clctl 서비스 명령어는 호스트에서 실행합니다.
**observability.health_port**는 /livez와 /metrics를 제공하며, 별도의 메트릭 포트를 두는 컴포넌트는 없습니다.

수정한 후에는 executor를 재시작하고 다음을 확인하십시오:

sudo systemctl restart clicklink-executor
sudo clicklink clctl preflight

ClickHouse 인스턴스 추가 또는 변경

실행기가 생성하는 서비스는 스스로 등록되므로, 관리형 모드에서는 여기에 직접 추가할 필요가 없습니다. 이 섹션은 실행기 없이 실행되며 사용자가 직접 운영하는 ClickHouse를 관찰하는 별도의 커넥터 배포에 적용됩니다. 두 배포가 동일한 인스턴스를 공유하는 경우 해당 배포의 init 시점에 --ch-user-suffix를 전달하십시오. instances 아래의 각 항목은 커넥터가 읽어 들이는 ClickHouse 네이티브 프로토콜 엔드포인트를 지정하며, host, port, database, secure, cluster, 그리고 Kubernetes에서는 namespace를 포함합니다. max_open_conns와 max_idle_conns는 연결 풀의 상한을 정합니다. 자격 증명은 구성에 저장되지 않으며, 각 컴포넌트는 프로비저닝이 생성한 액세스 번들에서 읽기 전용 ClickHouse 사용자를 가져옵니다.

Kubernetes
Linux VM

clicklink-values.yaml의 최상위 instances 맵에 인스턴스를 추가하십시오(VM 레지스트리와 동일한 필드). networkPolicy.clickhouseNamespaces에 해당 네임스페이스를 추가하십시오(네임스페이스의 kubernetes.io/metadata.name 레이블과 일치). 차트는 이 맵을 두 데몬이 읽는 clicklink-instance-registry ConfigMap으로 렌더링합니다. 이 방식은 executor.enabled가 false인 경우에만 동작합니다. 실행기가 켜져 있으면 실행기가 해당 ConfigMap을 소유하므로 렌더링이 실패합니다.

instances:
  analytics:
    host: "clickhouse-analytics.clickhouse.svc.cluster.local"
    port: 9440
    database: "default"
    secure: true
    namespace: "clickhouse"
    cluster: "default"

networkPolicy:
  clickhouseNamespaces:
    - "clickhouse"

워크스테이션에서 각 구성 요소에 대한 읽기 전용 액세스를 프로비저닝하십시오. --apply-ch-grants는 kubectl exec를 통해 파드 내에서 생성된 ClickHouse 권한을 적용합니다. 이 옵션이 없으면 명령어는 Kubernetes 측 리소스만 생성하고, 사용자가 적용할 수 있도록 ch-grants.sql을 디스크에 남겨 둡니다. 관리자 사용자에게 비밀번호가 있으면 --ch-admin-password-stdin을 추가하고 파이프로 전달하십시오.

CONNECTOR_NAMESPACE='clicklink'   # init 시 선택한 커넥터 네임스페이스
clicklink clctl scraper access provision --target helm \
  --target-namespace "${CONNECTOR_NAMESPACE}" \
  --instance analytics --instance-namespace clickhouse \
  --server <kubernetes-api-server-url> \
  --apply-ch-grants --ch-pod <clickhouse-pod-or-label-selector> --ch-pod-namespace clickhouse
clicklink clctl troubleshoot access provision --target helm \
  --target-namespace "${CONNECTOR_NAMESPACE}" \
  --instance analytics --instance-namespace clickhouse \
  --server <kubernetes-api-server-url> \
  --apply-ch-grants --ch-pod <clickhouse-pod-or-label-selector> --ch-pod-namespace clickhouse

SQL 실행 권한이 있는 관리자가 없는 Operator 관리형 인스턴스에서는 --apply-ch-grants 대신 --ch-user-via cr를 사용하십시오(파드 선택 플래그는 그대로 유지). 자세한 내용은 CLI 참고를 참조하십시오. 그런 다음 각 명령어가 생성하는 Secret 및 ServiceAccount 쌍을 해당 accessBundles 맵에 연결하고, 위에 표시된 helm upgrade를 실행하십시오.

scraper:
  accessBundles:
    analytics:
      secretName: clicklink-connector-scraper-access-analytics
      serviceAccountName: pcm-scraper-analytics

troubleshooter:
  accessBundles:
    analytics:
      secretName: clicklink-connector-troubleshooter-access-analytics
      serviceAccountName: pcm-troubleshooter-analytics

VM에서는 인스턴스가 config.yaml이 아니라 레지스트리 파일 /var/lib/clicklink/instances.yaml에 저장됩니다. config.yaml의 instances: 블록은 무시됩니다. init은 --instance로부터 레지스트리를 초기화하며, 스크레이퍼는 재시작 없이 변경 사항을 반영합니다. 최상위 instances: 맵 아래에 인스턴스를 추가하십시오.

instances:
  analytics:
    host: "10.0.12.34"
    port: 9440
    database: "default"
    secure: true
    cluster: "default"

그런 다음 호스트에서 root 사용자로 각 구성 요소에 대한 액세스를 프로비저닝하십시오. --ch-user-via cr를 전달하지 않는 한 관리자 비밀번호가 필수이며, --ch-admin-password-stdin으로 파이프를 통해 전달하십시오. 각 명령어는 ClickHouse 권한을 적용하고 해당 데몬을 재시작합니다(--skip-restart로 재시작 생략).

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

동일한 access provision 명령어에 --force를 함께 사용하면 인스턴스의 ClickHouse 자격 증명을 교체할 수 있습니다. 운영을 참조하십시오.

연산자 허용 목록

연산자 이메일 주소 허용 목록이 Gateway 관리 세션의 접근을 제한합니다. 세션 Gateway로 전송되는 모든 요청에는 목록에 포함된 이메일 주소가 확인된 단기 유효 OIDC ID 토큰이 있어야 합니다. 허용 목록이 비어 있으면 Gateway가 차단됩니다. VM에서는 호스트의 root 사용자가 로컬 세션 파일을 통해 세션을 직접 관리할 수도 있으며, 허용 목록은 Gateway를 통한 경로에만 적용됩니다. 전체 신뢰 모델은 지원 세션을 참조하십시오.

Kubernetes
Linux VM

허용 목록은 오버레이에 정의되며 차트가 이를 ConfigMap으로 렌더링합니다. 변경하려면 목록을 수정하고 helm upgrade를 실행하십시오.

clctl:
  gateway:
    enabled: true
    allowedOperators:
      - "oncall@example.com"
      - "dba@example.com"

init는 허용 목록을 /etc/clicklink/allowed-operators.txt에 기록하며, 이메일 주소를 한 줄에 하나씩 저장합니다.

oncall@example.com
dba@example.com

Gateway는 마지막으로 읽은 시점으로부터 30초가 지나면 다음 요청 시 파일을 다시 읽으므로, 재시작하지 않아도 수정 사항이 적용됩니다.

네트워크 정책과 egress

Kubernetes에서 이 차트는 egress 허용 목록가 적용된 기본 거부(default-deny) NetworkPolicy를 함께 제공합니다. NetworkPolicy 객체는 사용 중인 CNI가 이를 적용(enforce)할 때만 효력이 있습니다. 정책을 적용하는 CNI 환경에서는 두 CIDR 목록이 모두 채워지기 전까지 클러스터 DNS와 ClickHouse 서비스 네임스페이스에만 연결할 수 있습니다. 그 전까지 커넥터는 연결하려는 엔드포인트나 Kubernetes API server로 나가는 egress 경로가 없습니다. init은 커넥터 엔드포인트 뒤에 있는 CIDR를 파악한 경우에만 해당 정책을 enabled 상태로 구성합니다.

networkPolicy:
  enabled: true
  # CIDRs behind your connector endpoint (--egress-cidrs at init).
  allowEgressCIDRs:
    - "203.0.113.0/24"
  # Ports opened to allowEgressCIDRs.
  allowEgressPorts:
    - 443
  # Namespaces of ClickHouse you run yourself, matched by the
  # kubernetes.io/metadata.name label. Namespaces the executor creates
  # are admitted by the label it stamps on them and need no entry here.
  clickhouseNamespaces: []
  # Kubernetes API server CIDRs: your cluster VPC's ranges, staged by init
  # from the EKS cluster. Never the API server's own addresses, which
  # change over the cluster's life.
  apiserverCIDRs:
    - "10.0.0.0/16"

두 CIDR 목록은 출처가 서로 다릅니다:

**allowEgressCIDRs**는 사용자가 직접 제공해야 합니다. 커넥터 엔드포인트 뒤에 있는 범위로, 설치 시 --egress-cidrs로 지정하거나 프롬프트에서 입력합니다. 모든 구성 요소가 커넥터 엔드포인트에 도달하려면 이 값이 필요합니다. 관리형 모드에서 플랫폼 차트가 Amazon ECR에 있는 경우, 해당 리전의 ECR 및 STS 범위(또는 미러의 범위)를 추가하십시오. 이를 추가하지 않으면 정책에 막혀 실행기의 차트 pull이 실패합니다.
**apiserverCIDRs**는 관리형 모드에서 init이 EKS 클러스터의 VPC로부터 도출합니다(eks:DescribeCluster 및 ec2:DescribeVpcs). 모든 구성 요소가 Kubernetes 토큰 요청을 보내고 실행기는 API를 통해 서비스를 구동하므로, 정책을 강제하는 CNI 환경에서는 이 값이 설정되기 전까지 모두 차단됩니다. 조회에 실패하면 init은 경고를 표시한 뒤 목록을 비워 두므로, 사용자가 VPC의 CIDR 블록으로 직접 채워야 합니다.

서비스 네임스페이스는 두 가지 방식으로 선택됩니다. 실행기가 생성하는 네임스페이스에는 clicklink.clickhouse.com/managed-by: executor 레이블이 부여되고 정책이 이 레이블을 기준으로 허용하므로, 관리형 설치에서는 clickhouseNamespaces를 비워 둘 수 있습니다. 직접 운영하는 ClickHouse를 위해 실행기 외부에서 생성한 네임스페이스만 이름으로 나열하면 됩니다. 정책을 나중에 활성화하기. 설치 시 엔드포인트 CIDR을 건너뛴 경우, init은 allowEgressCIDRs: []와 함께 enabled: false를 구성해 두고 이를 마무리하는 단계를 출력합니다. CIDR을 파악한 후에는 clicklink-values.yaml에서 enabled: true와 allowEgressCIDRs를 설정하고, apiserverCIDRs에 VPC의 범위가 포함되어 있는지 확인한 다음 구성 영역에 나온 helm upgrade를 실행하십시오. session gateway가 활성화된 경우에는 egress 규칙이 하나 더 중요해집니다: clctl.gateway.jwksEgressCIDRs. Troubleshooter는 operator 토큰를 검사하기 위해 IdP(Identity Provider)의 JWKS를 가져오므로, 기본 거부 정책에서 목록이 비어 있으면 모든 토큰 검사가 차단됩니다:

clctl:
  gateway:
    jwksEgressCIDRs:
      - "199.36.153.8/30"

예시에 사용된 private.googleapis.com 범위는 Private Google Access를 통해 접근하는 Google IdP(Identity Provider)를 포함합니다. 다른 IdP를 사용한다면 해당 범위 또는 그 앞단에 위치한 egress 프록시의 CIDR을 지정하십시오. 남은 인그레스 키는 두 개입니다. metricsScrapeSelector는 레이블을 기준으로 메트릭 스크레이프 인그레스를 특정 Prometheus 네임스페이스 하나로 제한하며, kubeletProbeCIDRs는 엄격한 기본 거부(default-deny) 정책에서 큐블릿 health probe를 명시적으로 허용합니다. 전체 키 목록은 구성 참고를 확인하십시오.

민감 정보 마스킹 패턴

Troubleshooter는 출력이 사용자 환경을 벗어나기 전에 민감 정보를 마스킹합니다. 기본 제공 패턴은 ipv4, ipv6, bearer-token, aws-access-key, email, jwt, ssh-private-key, connection-string-credentials를 처리합니다. YAML 파일에서 사용자 지정 패턴을 추가하십시오. 사용자 지정 패턴은 파일에 정의된 순서대로 먼저 실행되고, 이후 기본 제공 패턴이 실행됩니다. 기본 제공 패턴의 name을 재사용하는 항목은 해당 기본 제공 패턴을 대체합니다. 각 패턴에는 name(필수, 고유), regex(필수, Go RE2 구문), replace(기본값 [REDACTED], $1 캡처 참조 지원), case_insensitive(기본값 false)를 지정합니다:

version: 1
patterns:
  - name: internal-hostname
    regex: '\b[a-z0-9-]+\.corp\.example\.com\b'
    replace: '[REDACTED:internal-host]'

  # Reusing a built-in name replaces the built-in pattern.
  - name: ipv4
    regex: '\b(?:\d{1,3}\.){3}\d{1,3}\b'
    replace: '[REDACTED:ip]'

VM에서는 파일 경로가 /etc/clicklink/redaction-patterns.yaml입니다. 설치 프로그램은 활성 패턴의 기본 세트(타사 API Key, AWS 시크릿 키 등)를 함께 설치합니다. 이 세트를 줄이거나 확장할 수 있으며, 설치 프로그램은 업그레이드해도 기존 버전을 유지합니다. Kubernetes에서는 YAML을 redaction-patterns.yaml 키를 사용해 ConfigMap에 저장하고 troubleshooter.redaction.patternsConfigMap에 해당 ConfigMap 이름을 설정하십시오. 차트가 이를 동일한 경로에 마운트합니다.

패턴 파일이 존재하지만 유효하지 않으면 troubleshooter가 시작되지 않으며, 문제가 된 항목이 로그에 기록됩니다. 파일이 설정되어 있으나 존재하지 않는 경우에는 경고만 기록하고 기본 제공 패턴을 사용합니다. clicklink clctl preflight로 파일을 검증할 수 있으므로 데몬을 다시 시작하기 전에 실행하십시오.

프라이빗 미러 및 경계 내 엔드포인트

배포된 차트는 image.repository를 공개 멀티 아키텍처 cosign 서명 커넥터 이미지로 미리 설정하므로 일반 설치에는 이미지 values가 필요하지 않습니다. 배포된 기본값을 확인하려면 다음을 실행하십시오.

CLICKLINK_VERSION="$(curl -fsSL https://releases.clicklink.clickhouse.com/latest-version.txt)"
helm show values clicklink-connector \
  --repo https://releases.clicklink.clickhouse.com/charts \
  --version "${CLICKLINK_VERSION#v}"

자체 레지스트리에서 pull하려면 오버레이의 리포지토리를 재정의하십시오:

image:
  repository: "registry.example.com/mirrors/clicklink"

미러에서 차트 자체를 설치하려면 init의 --chart에 --chart-repo에서 해석되는 차트 이름, 직접 지정한 oci:// 참조, URL 또는 로컬 아카이브나 디렉터리를 지정할 수 있습니다. --chart-version은 기본적으로 CLI 자체 버전을 사용하므로 바이너리와 차트의 버전이 함께 유지됩니다.

clicklink clctl init --handoff handoff.yaml --target helm --managed \
  --chart oci://registry.example.com/charts/clicklink-connector

커넥터 엔드포인트가 내부 경계의 사설 CA 뒤에 있는 경우 init에 --api-private-ca를 전달하십시오. 그러면 api.tls.caFile: /etc/clicklink/secrets/mtls/ca.crt가 구성되고, 커넥터는 시스템 루트와 등록 번들의 CA 체인을 함께 사용해 엔드포인트를 검증합니다. VM에서는 /etc/clicklink/config.yaml의 api.tls.ca_file이 이에 해당합니다. init은 번들 체인을 /etc/clicklink/tls/ca.crt에 설치하고, 커넥터는 동일한 방식으로 이를 시스템 루트에 추가합니다. 완전히 air-gapped된 환경에서 등록 및 certificate 서명을 수행하는 방법은 onboarding을 참조하십시오.

저장소

Kubernetes
Linux VM

두 구성 요소가 PersistentVolumeClaim에 상태를 유지합니다. Troubleshooter의 클레임에는 세션 상태와 감사 추적이 저장됩니다:

persistence:
  enabled: true
  storageClass: "gp3"
  size: 5Gi

실행기의 클레임에는 명령 데이터베이스와 실행기가 관리하는 서비스의 레지스트리가 저장됩니다:

executor:
  persistence:
    enabled: true
    storageClass: "gp3"
    size: 5Gi

init은 두 storageClass 값을 모두 선택한 클래스로 설정합니다. storageClass가 비어 있으면 클러스터의 기본 StorageClass가 사용되며, 클러스터에 기본값이 지정되어 있지 않으면 init이 프롬프트 또는 --storage-class로 값을 지정하도록 요구합니다. 실행기의 클레임에는 helm.sh/resource-policy: keep 주석이 지정되어 있으므로 helm uninstall을 실행해도 그대로 남습니다. 제거를 참조하십시오.

스크레이퍼는 커넥터 엔드포인트에 연결할 수 없는 동안 최소 1회 전달을 보장하기 위해 /var/lib/clicklink/buffer 아래에 메트릭을 스풀링합니다. 기본적으로 최대 168시간 또는 1024 MB까지 보관하며, 최대 1 MB/s의 속도로 업로드합니다:

scraper:
  buffer:
    path: /var/lib/clicklink/buffer
    retention: 168h
    max_size_mb: 1024

실행기는 명령 데이터베이스를 /var/lib/clicklink/executor.db에, 서비스 레지스트리를 /var/lib/clicklink/instances.yaml에 보관합니다. 두 파일 모두 재시작과 업그레이드 후에도 유지되며, --purge를 전달하지 않는 한 uninstall.sh도 이를 보존합니다.clicklink clctl preflight에는 buffer 디렉터리와 /var/log에 대한 디스크 검사가 포함됩니다.

시작하기

서비스 및 인프라

Bring Your Own Cloud

데이터 및 통합

연결 및 쿼리 실행

접근 관리

보안 및 컴플라이언스

모니터링 및 백업

AI 도구 및 에이전트

Cloud API

청구

지원

ClickHouse Private

구성

구성 방식

관리형 모드

ClickHouse 인스턴스 추가 또는 변경

연산자 허용 목록

네트워크 정책과 egress

민감 정보 마스킹 패턴

프라이빗 미러 및 경계 내 엔드포인트

저장소

​구성 방식

​관리형 모드

​ClickHouse 인스턴스 추가 또는 변경

​연산자 허용 목록

​네트워크 정책과 egress

​민감 정보 마스킹 패턴

​프라이빗 미러 및 경계 내 엔드포인트

​저장소

구성 방식

관리형 모드

ClickHouse 인스턴스 추가 또는 변경

연산자 허용 목록

네트워크 정책과 egress

민감 정보 마스킹 패턴

프라이빗 미러 및 경계 내 엔드포인트

저장소