본문으로 건너뛰기
최종 수정: 에

Doris Operator 리소스 모델

Doris Operator 리소스 모델은 Doris 클러스터의 구성 요소가 Kubernetes 네이티브 리소스에 어떻게 매핑되는지 설명합니다. 이 매핑을 이해하면 각 필드가 어떤 하위 리소스에 영향을 주는지 파악하고 문제를 더 쉽게 해결할 수 있습니다.

이 문서에서는 모든 필드를 나열하지 않습니다. 필드별 설정은 해당 배포 및 설정 문서를 참조하세요.

최소 구성 예제​

다음 예제는 최소 구성의 DorisCluster를 보여 줍니다. FE와 BE는 각각 해당하는 StatefulSet, Service, PVC 및 관련 리소스에 매핑됩니다.

apiVersion: doris.apache.com/v1
kind: DorisCluster
metadata:
  name: demo
  namespace: doris
spec:
  feSpec:
    replicas: 3
    image: apache/doris:fe-2.1.8
  beSpec:
    replicas: 3
    image: apache/doris:be-2.1.8

개요​

배포 모드와 관계없이 사용자는 Doris 사용자 정의 리소스를 직접 관리합니다. Operator는 이 리소스를 사용하여 Kubernetes 네이티브 리소스를 생성하고, 이러한 리소스가 Doris 구성 요소를 실행합니다.

Doris Operator 리소스 모델 개요

DorisCluster​

DorisCluster는 컴퓨팅·스토리지 통합 배포에 사용됩니다. 일반적으로 FE, BE, CN 및 Broker 구성 요소를 포함합니다.

DorisCluster 리소스 모델

구성 요소설명주요 Kubernetes 리소스
FE메타데이터 관리, SQL 액세스 및 쿼리 조정StatefulSet, 내부 Service, 외부 Service, PVC
BE데이터 저장 및 실행StatefulSet, 내부 Service, 외부 Service, PVC
CN탄력적 컴퓨팅 시나리오에서의 연산 실행StatefulSet, 내부 Service, 외부 Service, PVC, HPA
Broker외부 스토리지 액세스 프록시. 필요 여부는 Doris 버전과 워크로드에 따라 달라짐StatefulSet, 내부 Service

DorisDisaggregatedCluster​

DorisDisaggregatedCluster는 컴퓨팅·스토리지 분리 배포에 사용됩니다. 일반적으로 MetaService, FE 및 하나 이상의 ComputeGroups를 포함합니다.

DorisDisaggregatedCluster 리소스 모델

구성 요소설명주요 Kubernetes 리소스
MetaService컴퓨팅·스토리지 분리 클러스터의 메타데이터 서비스StatefulSet, Service, PVC
FESQL 액세스, 쿼리 조정 및 메타데이터 액세스 진입점StatefulSet, 내부 Service, 외부 Service, PVC
ComputeGroup연산 작업을 실행하는 독립적인 컴퓨팅 리소스 그룹StatefulSet, 내부 Service, 외부 Service, PVC
FoundationDB컴퓨팅·스토리지 분리 클러스터가 메타데이터 관리를 위해 의존하는 구성 요소외부 서비스 또는 fdb-kubernetes-operator로 관리

Service 유형​

Doris Operator는 용도에 따라 서로 다른 Service를 생성합니다.

Service 유형용도일반적인 사용 사례
내부 Service안정적인 네트워크 식별자 및 내부 통신StatefulSet DNS, 구성 요소 검색, Pod 간 액세스
외부 Service외부 액세스 진입점클라이언트 연결 및 외부 시스템 액세스

내부 Service는 일반적으로 업무용 액세스 진입점으로 사용되지 않습니다. 시나리오에 따라 외부 Service를 ClusterIP, NodePort 또는 LoadBalancer로 설정할 수 있습니다.

스토리지​

Doris는 상태를 유지하는 시스템입니다. FE, BE, CN, MetaService 및 ComputeGroups 모두 영구 디렉터리가 필요할 수 있습니다. Operator는 PVC 템플릿을 통해 영구 스토리지를 바인딩합니다.

다음 사항을 확인하세요.

  • Kubernetes 클러스터에 사용 가능한 StorageClass가 있는지.
  • PVC 용량이 데이터와 로그의 증가를 감당하기에 충분한지.
  • 액세스 모드가 워크로드에 적합한지.
  • 설정된 Doris 디렉터리가 PVC 마운트 경로와 일치하는지.

PVC를 바인딩할 수 없으면 Operator는 계속 대기하며, 해당 Pod는 시작할 수 없습니다.

설정 및 인증 리소스​

Doris Operator는 설정과 민감한 데이터를 관리하기 위해 ConfigMap과 Secret을 지원합니다.

리소스일반적인 용도
ConfigMapFE, BE, CN, Broker, MetaService 및 ComputeGroups의 시작 설정
Secret비밀번호, 액세스 자격 증명 및 keytab 파일
authSecretDoris Operator가 노드 등록, 사용 중지 및 관련 관리 작업에 사용하는 자격 증명
kerberosInfoKerberos 설정 및 keytab 마운트
serviceAccount구성 요소가 클라우드 또는 외부 서비스에 액세스해야 할 때 사용하는 Kubernetes ServiceAccount

설정 업데이트가 재시작을 유발하는지는 필드와 Operator 설정에 따라 달라집니다. 예를 들어 컴퓨팅·스토리지 통합 모드에서는 enableRestartWhenConfigChange가 핵심 ConfigMap 변경 시 롤링 재시작을 수행할지 제어합니다.

명명 규칙​

Operator가 관리하는 리소스는 일반적으로 클러스터 이름과 구성 요소 이름을 접두사로 사용하므로 소속을 쉽게 파악할 수 있습니다.

컴퓨팅·스토리지 통합 클러스터의 이름이 demo라면 일반적인 리소스 이름은 다음과 같습니다.

demo-fe
demo-fe-internal
demo-fe-service
demo-be
demo-be-internal
demo-be-service
demo-cn
demo-cn-internal
demo-cn-service
demo-broker
demo-broker-internal

컴퓨팅·스토리지 분리 클러스터의 이름이 demo이고 ComputeGroup의 이름이 adhoc-query라면 일반적인 리소스 이름은 다음과 같습니다.

demo-ms
demo-fe
demo-fe-internal
demo-adhoc-query
demo-adhoc-query-external

실제 이름은 버전이나 설정에 따라 약간 다를 수 있습니다. kubectl get 출력을 기준으로 판단하세요.

구성 요소 간 의존 관계​

리소스 모델에는 구성 요소 간 의존 관계도 반영되어 있습니다.

컴퓨팅·스토리지 통합 클러스터에서 FE는 다른 구성 요소가 등록하고 Doris 메타데이터에 액세스하는 진입점입니다.

DorisCluster의 구성 요소 간 의존 관계

컴퓨팅·스토리지 분리 클러스터에서는 MetaService가 먼저 준비되고, FE는 MetaService에 의존하며, ComputeGroups는 FE에 의존합니다.

DorisDisaggregatedCluster의 구성 요소 간 의존 관계

선행 구성 요소가 준비되지 않으면 이에 의존하는 구성 요소는 계속 대기하거나 상태 조정을 반복할 수 있습니다. 이는 정상적인 동작입니다. 생성 및 변경 작업의 실행 순서는 Doris Operator 수명 주기 관리를 참조하세요.

Report issue