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

MetaService 구성

이 장에서 배울 내용​

  • MetaService가 FoundationDB에 접속하는 데 사용하는 연결 정보 구성
  • MetaService 이미지 버전 사용자 지정
  • MetaService에 적절한 컴퓨팅 리소스 할당
  • ConfigMap을 통한 MetaService 시작 매개변수 사용자 지정
  • MetaService의 활성 프로브 타임아웃 및 시작 타임아웃 구성

개요​

MetaService는 Doris 스토리지-컴퓨트 분리 클러스터의 메타데이터 관리 컴포넌트입니다. 클러스터 내부에서만 사용되며 외부에 노출되지 않습니다. 상태를 저장하지 않는 서비스이며, 일반적으로 active-standby 모드로 배포됩니다. 이 장에서는 DorisDisaggregatedCluster 리소스에서 MetaService를 구성하는 방법을 설명합니다.

전체 구성 항목은 다음과 같습니다.

구성 시나리오구성 필드필수 여부적용 시나리오
FoundationDB 연결fdb.configMapNamespaceName 또는 fdb.address필수모든 시나리오
이미지 사용자 지정image선택배포 예시의 이미지 버전이 요구 사항에 맞지 않는 경우
컴퓨팅 리소스 할당requests / limits선택CPU 및 메모리 사용량을 제한해야 하는 경우
시작 매개변수 사용자 지정configMaps선택기본 시작 매개변수를 수정해야 하는 경우
활성 프로브 타임아웃liveTimeout선택기본값인 180초가 요구 사항에 맞지 않는 경우
시작 타임아웃startTimeout선택기본값인 300초가 요구 사항에 맞지 않는 경우

1. FoundationDB 연결​

MetaService는 FoundationDB에 메타데이터를 저장하므로 FoundationDB 접속 정보를 구성해야 합니다. FoundationDB 배포 방식에 따라 두 가지 구성 방법을 사용할 수 있습니다.

FoundationDB 배포 방식권장 구성 방법구성 필드
fdb-kubernetes-operator를 통해 Kubernetes에 배포Operator가 자동으로 생성한 ConfigMap 참조fdb.configMapNamespaceName
물리 서버에 직접 배포접속 주소 직접 지정fdb.address

방법 1: ConfigMap을 통한 접속 정보 구성​

FoundationDB 클러스터를 fdb-kubernetes-operator를 통해 배포한 경우, Operator가 자동으로 생성한 ConfigMap을 바로 사용할 수 있습니다. 이 ConfigMap에는 FoundationDB 접속 주소가 포함되어 있습니다.

spec:
  metaService:
    fdb:
      configMapNamespaceName:
        name: ${foundationdbConfigMapName}
        namespace: ${namespace}

매개변수 설명:

  • ${foundationdbConfigMapName}: ConfigMap의 이름
  • ${namespace}: FoundationDB가 배포된 네임스페이스

fdb-kubernetes-operator가 생성한 ConfigMap을 찾으려면 FoundationDB 배포 장의 FoundationDB 접속 정보가 포함된 ConfigMap 가져오기를 참조하세요.

방법 2: 접속 주소 직접 구성​

FoundationDB가 물리 서버에 배포된 경우, MetaService 구성에서 접속 주소를 직접 지정할 수 있습니다.

spec:
  metaService:
    fdb:
      address: ${fdbEndpoint}

매개변수 설명:

  • ${fdbEndpoint}: FoundationDB에 접속하는 데 사용하는 주소

물리 서버에 배포된 환경에서 이 주소를 찾으려면 스토리지-컴퓨트 분리 장의 MetaService 배포를 위한 fdb_cluster 확인 방법 소개를 참조하세요.

2. 이미지 사용자 지정​

배포 예시에서 MetaService에 구성된 이미지는 최신 버전이 아닐 수 있습니다. 이미지 버전을 지정하려면 다음 형식을 사용하세요.

spec:
  metaService:
    image: ${msImage}

매개변수 설명:

  • ${msImage}: 배포할 MetaService 이미지입니다. Doris 공식 MetaService 이미지를 사용하세요(이미지 태그에는 ms 접두사가 포함됩니다).

3. 컴퓨팅 리소스 할당​

Kubernetes 리소스 제한을 사용하여 MetaService에 적절한 CPU와 메모리를 할당하세요. 예를 들어 다음 구성은 MetaService의 리소스를 CPU 코어 4개와 메모리 4Gi로 제한합니다.

spec:
  metaService:
    requests:
      cpu: 4
      memory: 4Gi
    limits:
      cpu: 4
      memory: 4Gi

위 구성을 배포할 DorisDisaggregatedCluster 리소스에 적용하세요.

4. 시작 구성 사용자 지정​

기본 시작 매개변수가 요구 사항에 맞지 않으면 ConfigMap을 통해 사용자 지정 시작 구성 파일을 마운트할 수 있습니다. Doris-Operator는 ConfigMap을 통해 각 컴포넌트의 시작 구성 파일을 마운트하는 방식으로 사용자 지정을 지원합니다.

전체 흐름은 다음과 같습니다.

단계설명
입력사용자 지정 doris_cloud.conf 구성 파일
작업ConfigMap을 생성하고 /etc/doris 디렉터리에 마운트
출력MetaService가 사용자 지정 구성으로 시작
팁

Doris-Operator는 MetaService 시작 구성에서 FoundationDB 관련 설정을 자동으로 채우므로, 시작 구성을 사용자 지정할 때 fdb_cluster를 설정할 필요가 없으며 설정해서도 안 됩니다.

단계 1: 사용자 지정 ConfigMap 생성​

시작 구성 파일의 이름은 반드시 doris_cloud.conf여야 합니다. 다음은 그 예시입니다.

apiVersion: v1
data:
  doris_cloud.conf: |
    # // meta_service
    brpc_listen_port = 5000
    brpc_num_threads = -1
    brpc_idle_timeout_sec = 30
    http_token = greedisgood9999

    # // doris txn config
    label_keep_max_second = 259200
    expired_txn_scan_key_nums = 1000

    # // logging
    log_dir = ./log/
    # info warn error
    log_level = info
    log_size_mb = 1024
    log_filenum_quota = 10
    log_immediate_flush = false
    # log_verbose_modules = *

    # //max stage num
    max_num_stages = 40
kind: ConfigMap
metadata:
  name: doris-metaservice
  namespace: default

단계 2: 사용자 지정 시작 구성 마운트​

DorisDisaggregatedCluster 리소스에서 metaService.configMaps를 통해 위의 ConfigMap을 마운트하세요.

spec:
  metaService:
    configMaps:
    - name: ${msConfigMapName}
      mountPath: /etc/doris

매개변수 설명:

  • ${msConfigMapName}: MetaService 시작 구성이 포함된 ConfigMap의 이름
  • mountPath: 마운트 지점은 반드시 /etc/doris여야 함

위 구성을 배포할 DorisDisaggregatedCluster 리소스에 적용하세요.

5. 서비스 프로브 타임아웃 구성​

Doris Operator는 스토리지-컴퓨트 분리 클러스터 서비스에 두 가지 타임아웃 매개변수를 제공합니다.

프로브 유형구성 필드기본값단계트리거 조건
활성 프로브(LivenessProbe)liveTimeout180초서비스 실행 중프로브 실패 상태가 임계 시간을 초과하여 지속되면 서비스를 강제로 재시작
시작 타임아웃startTimeout300초서비스 시작 중시작 시간이 임계 시간을 초과하면 서비스를 강제로 재시작

활성 프로브 타임아웃 구성​

활성 프로브는 서비스의 실행 상태를 모니터링합니다. 예를 들어 활성 프로브 타임아웃을 30초로 설정하려면 다음과 같이 구성하세요.

spec:
  metaService:
    liveTimeout: 30

시작 타임아웃 구성​

시작 타임아웃은 서비스 시작에 시간이 너무 오래 걸리는 경우를 처리합니다. 예를 들어 시작 타임아웃을 120초로 설정하려면 다음과 같이 구성하세요.

spec:
  metaService:
    startTimeout: 120
Report issue