MongoDB 검색 및 벡터 검색 설정

외부 복제본 세트에 연결하기 위한 설정

spec.source.external.hostAndPorts

유형: 문자열 배열

외부 복제본 세트 의 호스트 이름 및 포트 목록입니다. MongoDB 복제본 세트 에 대한 호스팅하다 시드 목록 입니다. mongot 는 복제본 세트 모드 에서 데이터베이스 에 연결하고 db.hello()을 사용하여 다른 모든 노드의 목록을 가져옵니다.

이 필드 spec.source.external.shardedCluster와 상호 배타적입니다. 복제본 세트 소스에는 hostAndPorts 를 사용하고 샤딩된 클러스터 소스에는 shardedCluster 를 사용합니다.

예시

hostAndPorts:
  - mdbc-rs-0.my-external-domain.example.com:27017
  - mdbc-rs-1.my-external-domain.example.com:27017
  - mdbc-rs-2.my-external-domain.example.com:27017

spec.source.external.tls

유형: 객체

외부 MongoDB database 에 연결할 때 mongot 사용해야 하는 TLS 설정입니다.

spec.source.external.tls.ca.name

유형: 문자열

mongod 노드에서 사용하는 TLS 인증서를 발급한 인증 기관의 신뢰할 수 있는 체인이 포함된 ConfigMap의 이름입니다.

예시

spec:
  source:
    external:
      tls:
        ca:
          name: trusted-ca

이 ConfigMap의 ca.crt 키 아래에 인증서(또는 인증서 체인)를 지정해야 합니다.

예시

kind: ConfigMap
apiVersion: v1
metadata:
  name: trusted-ca
data:
  ca.crt: |
    -----BEGIN CERTIFICATE-----
    MIIDBTCCAe2gAwIBAgIIH3EOUAGAsx0wDQYJKoZIhvcNAQELBQAwFTETMBEGA1UE
    [...]
    U/4rN8Ias/FONYFRtGfs9uXHmo2MP04BF+9ED2dlbNDUbat+6XCozLJj98nI4VEi
    qaV3JrVFHTgN
    -----END CERTIFICATE-----

외부 샤드 클러스터에 연결하기 위한 설정

다음 설정은 외부 MongoDB 샤딩된 클러스터 에 대한 연결을 구성할 때만 필요합니다. 기존 spec.source.external 설정을 확장합니다.

spec.source.external.shardedCluster

유형: 객체

외부 샤딩된 MongoDB 클러스터 mongot의 데이터 소스 로 선언합니다. mongos 라우터 및 샤드별 복제본 세트 멤버에 대한 구성이 포함되어 있습니다.

MongoDB 샤딩된 클러스터 Kubernetes 외부에 배포되고 Kubernetes Operator가 managed 하지 않는 경우에만 이 옵션을 사용합니다. MongoDB CRD를 사용하여 배포된 연산자 managed 샤딩된 클러스터의 경우 spec.source.mongodbResourceRef 를 대신 사용합니다. Kubernetes Operator는 샤드 토폴로지 자동 검색합니다.

예시

spec:
  source:
    external:
      shardedCluster:
        router:
          hosts:
            - "mongos1.external:27017"
            - "mongos2.external:27017"
        shards:
          - shardName: "shard-0"
            hosts:
              - "shard0-node1.external:27018"
              - "shard0-node2.external:27018"
          - shardName: "shard-1"
            hosts:
              - "shard1-node1.external:27018"
              - "shard1-node2.external:27018"

spec.source.external.shardedCluster.router

유형: 객체

외부 샤딩된 클러스터 의 mongos (라우터) 인스턴스에 대한 구성입니다.

spec.source.external.shardedCluster.router.hosts

유형: 문자열 배열

host:port 형식의 mongos 라우터 인스턴스에 대한 엔드포인트 목록입니다. 모든 mongot 인스턴스가 이 라우터에 연결됩니다. 항목을 하나 이상 지정합니다.

예시

router:
  hosts:
    - "mongos1.external:27017"
    - "mongos2.external:27017"

spec.source.external.shardedCluster.shards

유형: 객체 배열

외부 MongoDB cluster 에 있는 모든 샤드의 목록입니다. 각 항목은 하나의 샤드의 복제본 세트 설명합니다. Kubernetes Operator는 각 샤드 에 대해 하나의 mongot StatefulSet를 생성하며, 각 StatefulSet에는 spec.clusters[].replicas에 지정된 수의 파드가 포함됩니다. 샤드 항목을 하나 이상 지정합니다.

spec.source.external.shardedCluster.shards[*].shardName

유형: 문자열

샤드 의 논리적 이름입니다. Kubernetes Operator는 이 이름을 Kubernetes 리소스 명명(StatefulSets, Services, Secrets)에 사용합니다. 이 값은 MongoDB 샤드 이름과 다를 수 있습니다.

명명 제약 조건:

• 모든 샤드에서 고유해야 합니다.

• 소문자 영숫자 및 하이픈(-)을 허용하며 이름이 영숫자로 시작하고 끝나도록 요구하는 Kubernetes DNS 레이블 이름 규칙(RFC 1123)을 준수해야 합니다. 마침표(.)와 및줄(_)은 허용되지 않습니다. 최대 길이는 63 자입니다.

• Kubernetes 연산자는 metadata.name, 클러스터 인덱스 및 shardName 를 결합하여 생성하는 Kubernetes 리소스의 이름(예시: {name}-search-{clusterIndex}-{shardName})을 만들고 모든 생성된 이름이 레이블의 Kubernetes DNS 제한 63 자 및 하위 도메인 이름의 253 자 내에 맞는지 확인합니다. 이러한 제한에 맞도록 shardName 를 초기화합니다.

예시

shards:
  - shardName: "shard-0"
    hosts:
      - "shard0-node1.external:27018"

spec.source.external.shardedCluster.shards[*].hosts

유형: 문자열 배열

이 샤드 에 대한 mongod 복제본 세트 멤버의 엔드포인트 목록(host:port 형식)입니다. mongot 인스턴스는 이러한 호스트의 데이터를 복제합니다. 항목을 하나 이상 지정합니다.

각 복제본 세트 (샤드)에는 자체 mongot 인스턴스 그룹 있으며, 이 그룹은 해당 복제본 세트 의 데이터만 소싱합니다. 서로 다른 샤드가 동일한 mongot 인스턴스를 주식 하지 않습니다.

예시

shards:
  - shardName: "shard-0"
    hosts:
      - "shard0-node1.external:27018"
      - "shard0-node2.external:27018"
      - "shard0-node3.external:27018"

크기 및 저장

spec.clusters[].replicas

유형: integer

이 Kubernetes 클러스터에 배포할 mongot 팝 수입니다. 복제본 세트 소스의 경우 총 mongot 팝 수입니다. 샤딩된 클러스터 소스의 경우 샤드당 mongot 팝 수입니다.

spec.clusters[].replicas 가 1보다 큰 경우 mongod 와 여러 mongot 인스턴스 간에 트래픽을 라우팅하도록 spec.clusters[].loadBalancer 도 구성해야 합니다.

spec.clusters[].replicas 을 0로 설정하면 Kubernetes Operator가 이 클러스터의 mongot 배포서버를 오프라인으로 전환합니다. Kubernetes 연산자는 StatefulSet를 영 파드로 확장하고 MongoDBSearch 리소스 및 기타 Kubernetes 리소스를 제자리에 유지합니다.

생략하는 경우 기본값은 1입니다.

예시

spec:
  clusters:
    - replicas: 2

spec.clusters[].resourceRequirements

유형: core/v1/ResourceRequirements

mongodb-search 컨테이너 요청 수 있고 제한할 수 있는 CPU 및 메모리입니다. spec.clusters[].statefulSet(으)로 재정의하는 대신 이 필드 사용하여 리소스 할당을 사용자 지정하는 것이 좋습니다.

spec.clusters[].jvmFlags에서 JVM 힙 크기를 재정의하지 않으면 Kubernetes Operator는 기본 힙 크기(-Xmx)를 mongot 컨테이너의 메모리 요청의 50%로 설정합니다. 팝 리소스와 JVM 힙 크기 모두를 제어하려면 spec.clusters[].resourceRequirements 를 적절히 조정하십시오.

생략하면 Kubernetes Operator는 다음 기본값 을 사용합니다.

requests:
  cpu: 2
  memory: 4Gi

spec.clusters[].resourceRequirements.limits

유형: 객체

mongodb-search 컨테이너가 사용할 수 있는 리소스(CPU 및 메모리)의 상한선입니다. 기본적으로 제한이 설정되지 않습니다. 생략하면 팝이 제한되지 않아 노드의 모든 리소스를 사용할 수 있습니다. 워크로드에 따라 제한을 설정하는 것을 권장합니다.

spec.clusters[].resourceRequirements.requests

유형: 객체

mongodb-search 컨테이너에 요청된 CPU 및 메모리 양입니다. cpu 또는 memory 중 하나만 지정하면 Kubernetes Operator가 나머지 필드에 대한 기본값을 적용합니다. 생략하면 Kubernetes Operator는 다음 기본값을 사용합니다.

requests:
  cpu: 2
  memory: 4Gi

spec.clusters[].persistence.single

유형: 객체

MongoDB Search 및 Vector Search 인덱스가 저장되는 MongoDB Search 및 Vector Search 지속성 볼륨에 대한 스토리지 구성입니다. 각 검색 인스턴스 (pod)에는 인덱스를 유지 관리하기 위한 자체 독립적인 저장 가 있으며, 이는 MongoDB database 와 공유되지 않습니다. 인덱스 메타데이터 (정의)만 데이터베이스 자체에 저장됩니다.

스칼라	데이터 유형	설명
labelSelector	문자열	마운트된 볼륨을 디렉토리에 바인딩하는 데 사용되는 태그입니다.
storage	문자열	마운트할 영구 볼륨 의 최소 크기입니다. 이 값은 정수 뒤에 JEDEC 표기법으로 저장 단위를 붙여 표현합니다. 기본값은 16G 입니다. 예시를 들어 복제본 세트 에 60 기가바이트의 저장 공간이 필요한 경우 이 값을 60G로 설정합니다.
storageClass	문자열	영구 볼륨 클레임에 지정된 저장 유형입니다. 이 저장 유형을 StorageClass 객체로 생성한 후 이 객체 사양에서 사용할 수 있습니다. StorageClass reclaimPolicy 를 Retain 으로 설정하다 해야 합니다. 이렇게 하면 영구 볼륨 클레임 이 제거될 때 데이터가 유지됩니다.

MongoDBSearch는 모든 데이터에 하나의 볼륨을 사용하는 single 지속성 모드만 지원합니다. CRD 스키마에도 spec.clusters[].persistence.multiple 필드가 포함되어 있지만 Kubernetes 연산자는 이를 적용하지 않습니다. persistence를 생략하면 Kubernetes 연산자는 spec.clusters[].persistence.single.storage 를 16G(으)로 설정핖니다.

부하 분산

spec.clusters[].loadBalancer

유형: 객체

mongod (또는 mongos)와 mongot 간의 L7 로드 밸런싱을 위한 구성입니다. 이 필드 spec.clusters[].replicas 가 1보다 큰 경우 필수입니다. spec.clusters[].replicas 가 1인 경우 이 필드 선택 사항입니다. 단일 mongot 인스턴스 에 대해서도 로드 밸런서 구성하여 나중에 확장 수 있도록 준비할 수 있습니다.

managed 또는 unmanaged 중 정확히 하나만 설정하다 해야 합니다.

spec.clusters 의 모든 엔트리는 로드 밸런서 모드에 대해 동의해야 합니다. 모든 엔트리가 loadBalancer.managed을 설정하거나, 모든 엔트리가 loadBalancer.unmanaged를 설정하거나, 엔트리가 loadBalancer을 설정하지 않아야 합니다. Kubernetes 연산자는 혼합 모드를 거부합니다. 다중 클러스터 배포서버는 managed 모드만 지원합니다.

로드 밸런서 mongod 클라이언트에 표시되는 TLS 인증서와 해당 인증서에 포함되어야 하는 호스트 이름에 영향을 줍니다.

• 로드 밸런서 없으면 mongod 이(가) mongot에 직접 연결됩니다. mongod 에게 제공된 TLS 인증서는 mongot의 자체 인증서입니다. MongoDB 클러스터 Kubernetes 외부에 있는 경우 mongot 서비스는 외부 도메인에 노출됩니다. mongot TLS 인증서의 SAN(주체 대체 이름) 필드 에 해당 외부 도메인을 포함해야 합니다.

• managed 로드 밸런서 (spec.clusters[].loadBalancer.managed)를 사용하는 경우 Envoy 프록시는 mongot에 직접 연결되는 유일한 구성 요소입니다. Envoy 프록시는 내부 서비스 FQDN을 통해 mongot 에 도달합니다.

  • 복제본 세트: <name>-search-<clusterIndex>-svc.<ns>.svc.cluster.local

  • 샤딩된 클러스터: <name>-search-<clusterIndex>-<shard>-svc.<ns>.svc.cluster.local

  mongot TLS 인증서의 SAN 필드에 이러한 서비스 FQDN을 포함하는 것이 좋습니다. 연산자가 managed Envoy 프록시는 현재 mongot 인증서를 인증서 발급 기관에 대해서만 유효성을 검사하며 SAN 호스트 이름을 일치시키지 않습니다. 외부 mongod 프로세스는 Envoy 프록시의 TLS 인증서를 확인하므로 mongot 인증서에 아니라 Envoy 인증서의 SAN에 외부 도메인을 포함하세요.

팁

단일 mongot 파드를 처음 배포 경우에도 managed 로드 밸런서 활성화합니다. 로드 밸런서 있으면 로드 밸런서 mongod 와 mongot 사이에 이미 있기 때문에 나중에 spec.clusters[].replicas 를 확장하다 TLS 인증서의 도메인이 안정적으로 유지됩니다.

spec.clusters[].loadBalancer.managed

유형: 객체

연산자 managed Envoy 로드 밸런서 구성합니다. Kubernetes Operator는 올바른 라우팅, mTLS, HTTP/2+gRPC 스트림 고정을 사용하여 Envoy 프록시를 배포하고 관리합니다. 기본값을 사용하려면 이 필드 빈 객체 ({})로 설정합니다.

이 필드 spec.clusters[].loadBalancer.unmanaged와 상호 배타적입니다.

샤딩된 클러스터 소스의 경우 managed 로드 밸런서를 사용하는 경우 spec.security.tls 도 구성해야 합니다. Envoy 프록시는 TLS가 필요한 SNI를 사용하여 트래픽을 올바른 샤드로 라우팅합니다.

예시

spec:
  clusters:
    - loadBalancer:
        managed: {}

spec.clusters[].loadBalancer.managed.externalHostname

유형: 문자열

Envoy 프록시가 수신 요청의 SNI 일치를 위해 예상하는 호스트 이름입니다. Kubernetes Operator는 이 값을 사용하여 수신 mongod 연결의 TLS SNI 필드 일치하는 라우팅 규칙을 구성합니다. Envoy TLS 서버 인증서의 SAN(주체 대체 이름) 필드 에 이 호스트 이름을 포함해야 합니다.

샤딩된 클러스터 소스의 경우 값에는 Kubernetes Operator가 샤드 별로 확장하는 {shardName} 자리 표시자가 포함되어야 합니다. 각 샤드는 고유한 호스트 이름을 가지며 Envoy TLS 서버 인증서에는 SAN에 확장된 모든 샤드 호스트 이름이 포함되어야 합니다. 와일드카드 인증서를 사용하여 단일 인증서로 모든 샤드를 커버하고 샤드가 추가되는 경우 재발급을 피할 수 있습니다. 복제본 세트 소스의 경우 {shardName} 자리 표시자를 사용하지 마십시오.

이 필드 MongoDB 외부에서 managed 경우( Kubernetes Operator가 배포하지 않음) 필수입니다. MongoDB 동일한 클러스터 에서 연산자 관리되는 경우, Kubernetes 연산자가 라우팅을 자동으로 구성하므로 이 필드 생략합니다.

다중 클러스터 배포서버에서는 각 클러스터 엔트리에 대해 별도의 호스트 이름이 사용됩니다. 하지만 Kubernetes 연산자는 예를 들어 가용 구역에 걸친 페일오버 프록시가 여러 클러스터의 Envoy 프록시를 전면에 배치하는 경우와 같이 클러스터 간에 하나의 호스트 이름 공유를 허용합니다.

예시

# Replica set with external MongoDB
spec:
  clusters:
    - loadBalancer:
        managed:
          externalHostname: "search.apps.example.com"
# Sharded cluster with external MongoDB
spec:
  clusters:
    - loadBalancer:
        managed:
          externalHostname: "{shardName}.search.example.com"

spec.clusters[].loadBalancer.managed.routerHostname

유형: 문자열

host:port 형식으로 managed Envoy 로드 밸런서를 통해 이 클러스터의 mongot 인스턴스에 도달하기 위해 mongos 라우터가 사용하는 엔드포인트입니다. Kubernetes Operator는 클러스터 수준 라우팅 체인에서 SNI 일치에 호스트 이름을 사용하므로 Envoy TLS 서버 인증서에는 SAN에 이 호스트 이름이 포함되어야 합니다.

외부 샤딩된 MongoDB 소스(spec.source.external.shardedCluster)가 있는 managed 로드 밸런서를 사용하는 경우 이 필드는 필수입니다. Kubernetes Operator는 복제본 세트 소스와 연산자 managed MongoDB에 대해 이 필드를 무시합니다.

externalHostname와 달리 Kubernetes 연산자는 이 값을 그대로 사용하므로 값에 {shardName} 자리 표시자가 포함되어 있으면 안 됩니다. 이 엔드포인트는 mongos의 샤드 아그노스틱 입력 점입니다.

다중 클러스터 배포에서는 각 클러스터 엔트리에 일반적으로 고유한 값이 사용됩니다. 하지만 Kubernetes Operator는 가용 영역에 걸쳐 있는 페일오버 프록시가 여러 클러스터의 Envoy 프록시를 제공하는 경우와 같이 클러스터 간에 하나의 값을 공유할 수 있습니다.

예시

spec:
  clusters:
    - loadBalancer:
        managed:
          externalHostname: "{shardName}.search.example.com"
          routerHostname: "search-router.example.com:27028"

spec.clusters[].loadBalancer.managed.replicas

유형: integer

이 Kubernetes 클러스터에 배포할 Envoy 프록시 팝의 수. 값은 1 이상이어야 합니다. 생략하면 기본값은 1입니다.

spec.clusters[].loadBalancer.managed.resourceRequirements

유형: core/v1/ResourceRequirements

Envoy 컨테이너 요청 하고 제한할 수 있는 CPU 및 메모리입니다. 이 설정을 지정하면 Kubernetes Operator가 기본값을 완전히 대체합니다.

생략하면 Kubernetes Operator는 다음 기본값 을 사용합니다.

requests:
  cpu: 100m
  memory: 128Mi
limits:
  cpu: 500m
  memory: 512Mi

예시

spec:
  clusters:
    - loadBalancer:
        managed:
          resourceRequirements:
            requests:
              cpu: "200m"
              memory: "256Mi"
            limits:
              cpu: "1"
              memory: "1Gi"

spec.clusters[].loadBalancer.managed.deployment

유형: 객체

Kubernetes 연산자가 연산자가 생성한 Envoy 배포에 병합하는 재정의입니다. MongoDB 리소스에서 spec.statefulSet 과 동일한 규칙을 따릅니다. 생략하면 Kubernetes Operator는 Envoy 배포에 기본값을 사용합니다.

이 객체 에는 두 개의 필드가 포함되어 있습니다.

• metadata — Kubernetes 연산자가 Envoy 배포 메타데이터 에 병합하는 labels 및 annotations 필드를 포함합니다.

• spec — apps/v1/DeploymentSpec 객체. Kubernetes Operator는 이러한 재정의를 Envoy 배포 사양에 병합합니다.

예시

spec:
  clusters:
    - loadBalancer:
        managed:
          deployment:
            spec:
              template:
                spec:
                  nodeSelector:
                    kubernetes.io/os: linux

spec.clusters[].loadBalancer.managed.retryPolicy

유형: 객체

Envoy 프록시가 개별 gRPC 스트림에 적용하는 재시도 동작은 업스트림 mongot 인스턴스에 적용됩니다. Envoy 프록시는 실패한 시도와 다른 mongot 호스트로 각 재시도 시도를 보냅니다.

이 필드를 생략하면 Envoy 프록시는 기본값으로 다시 시도합니다. 시도당 타임아웃이 60s인 시도를 2 번 시도합니다.

예시

spec:
  clusters:
    - loadBalancer:
        managed:
          retryPolicy:
            numRetries: 2
            perTryTimeout: "60s"

spec.clusters[].loadBalancer.managed.retryPolicy.numRetries

유형: integer

요청당 최대 재시도 횟수입니다. 값은 1 이상이어야 합니다. 생략하면 각 요청에 대해 총 세 번의 시도가 허용되는 2로 기본값이 설정됩니다.

spec.clusters[].loadBalancer.managed.retryPolicy.perTryTimeout

유형: 문자열

원래 요청을 포함하여 각 개별 시도에 대한 타임아웃은 기간 string(예: "30s")으로 표현됩니다. 생략하면 기본값은 "60s"입니다.

spec.clusters[].loadBalancer.managed.minMongotReadyReplicas

유형: integer

Envoy 프록시가 트래픽을 보내기 전에 mongot 그룹(예: 하나의 샤드의 mongot 인스턴스) 이 가지고 있어야 하는 최소 수의 준비된 mongot 복제본입니다. 그룹이 이 임계값 미만인 동안 Envoy 프록시는 해당 그룹에 대한 트래픽을 정상적인 mongot 그룹에 전송하고 routed_from_another_shard 헤더로 요청을 표시합니다. 이러한 요청은 오류 대신 빈 결과를 반환합니다.

값은 1 이상이어야 합니다. 생략하면 기본값은 1입니다.

spec.clusters[].loadBalancer.unmanaged

유형: 객체

사용자 제공 (Bring Yourself) L7 로드 밸런서 구성합니다. 사용자는 외부에서 로드 밸런서 배포하고 구성할 책임이 있습니다.

이 필드는 spec.clusters[].loadBalancer.managed와(과) 상호 배타적입니다. 다중 클러스터 배포서버는 관리되지 않는 로드 밸런서를 지원하지 않습니다.

spec.clusters[].loadBalancer.unmanaged.endpoint

유형: 문자열

host:port 형식으로 된 BYO 로드 밸런서의 엔드포인트. spec.clusters[].loadBalancer.unmanaged을(를) 구성하는 경우 이 필드를 지정해야 합니다.

Kubernetes Operator가 MongoDB 배포를 관리하는 경우(spec.source.mongodbResourceRef)에는 Kubernetes Operator가 이 값을 mongod 구성에 mongotHost 및 searchIndexManagementHostAndPort로 쓰기합니다. MongoDB가 외부에 있는 경우에는 동일한 값을 사용하여 mongod 매개변수를 직접 구성합니다.

외부 샤딩된 클러스터 소스의 경우 값에는 Kubernetes Operator가 샤드 별로 확장하는 {shardName} 자리 표시자가 포함되어야 하며, 자리 표시자만 포함되어서는 안 됩니다. 외부 복제본 세트 소스의 경우 값에는 {shardName} 자리 표시자가 포함되어서는 안 됩니다.

예시

# Replica set example
spec:
  clusters:
    - loadBalancer:
        unmanaged:
          endpoint: "search-lb.corp.example.com:443"
# Sharded cluster example
spec:
  clusters:
    - loadBalancer:
        unmanaged:
          endpoint: "{shardName}-lb.corp.example.com:443"

샤드별 재정의

spec.clusters[].shardOverrides

유형: 객체 배열

클러스터 기본값과 다르게 이 클러스터 엔트리 내의 특정 샤드의 크기를 재정의하는 재정의. 이 필드를 사용하여 개별 샤드에 나머지 클러스터보다 더 많거나 덜 mongot 노드, 리소스 또는 저장 공간을 할당할 수 있습니다.

이 필드는 외부 샤딩된 클러스터 소스(spec.source.external.shardedCluster)에서만 사용할 수 있습니다. 참조하는 각 샤드 이름은 spec.source.external.shardedCluster.shards[*].shardName에 존재해야 하며, 클러스터 엔트리당 각 샤드를 최대 한 번만 재정의할 수 있습니다.

오버라이드에 replicas, resourceRequirements, persistence 또는 jvmFlags 을 설정하면 명명된 샤드의 클러스터 값을 대체합니다. Kubernetes Operator는 statefulSet 를 클러스터 값에 디프 병합합니다. 설정하지 않은 필드는 클러스터 값을 상속합니다.

예시

spec:
  clusters:
    - replicas: 2
      shardOverrides:
        - shardNames:
            - shard-0
          replicas: 3
          resourceRequirements:
            requests:
              cpu: "4"
              memory: 8Gi

spec.clusters[].shardOverrides[*].shardNames

유형: 문자열 배열

이 오버라이드가 적용되는 이 클러스터 엔트리 내의 샤드 이름입니다. 이 필드는 필수이며 적어도 하나의 엔트리가 포함되어야 합니다.

spec.clusters[].shardOverrides[*].replicas

유형: integer

명명된 샤드의 클러스터의 mongot 복제본 수를 대체합니다. 0 값은 이 샤드의 mongot 인스턴스를 오프라인으로 전환합니다.

spec.clusters[].shardOverrides[*].resourceRequirements

유형: core/v1/ResourceRequirements

명명된 샤드에 대한 클러스터의 CPU 및 메모리 요청 및 제한을 대체합니다.

spec.clusters[].shardOverrides[*].persistence

유형: 객체

명명된 샤드의 클러스터의 영구 볼륨 구성을 대체합니다. spec.clusters[].persistence과 동일한 스키마를 사용합니다.

spec.clusters[].shardOverrides[*].statefulSet

유형: 객체

이름이 지정된 샤드에 대한 StatefulSet 재정의. 다른 재정의 필드와 달리 Kubernetes Operator는 이 값을 대체하는 대신 클러스터의 spec.clusters[].statefulSet 값에 딥 병합합니다.

spec.clusters[].shardOverrides[*].jvmFlags

유형: 문자열 배열

빈 문자열이 아닌 목록으로 설정하면 명명된 샤드의 클러스터의 spec.clusters[].jvmFlags 을 대체합니다. spec.clusters[].jvmFlags 의 형식 규칙은 이 필드에도 적용됩니다.

동기화 소스 선택

spec.clusters[].syncSourceSelector

유형: 객체

이 클러스터 엔트리의 mongot 인스턴스가 데이터를 동기화할 mongod 노드를 선택합니다.

spec.clusters[].syncSourceSelector.matchTagSets

유형: 객체 배열

복제본 세트 태그를 사용하여 동기화 소스 mongod 노드를 선택하는 복제본 세트 태그 세트의 정렬된 목록입니다. Kubernetes Operator는 목록을 mongot 구성에 전달합니다. mongot 는 첫 번째 일치하는 태그 세트가 선택한 노드에서 동기화하고 세컨더리 노드를 선호합니다.

각 항목은 태그 이름을 태그 값에 매핑한 것입니다. 빈 문서({})는 모든 노드와 일치하므로 이전 태그 세트와 일치하는 것이 없는 경우 일치 어떤 것이든 폴백으로 후미에 {} 항목을 추가할 수 있습니다. 최대 50 개의 항목을 지정할 수 있습니다.

예시

spec:
  clusters:
    - syncSourceSelector:
        matchTagSets:
          - region: us-east-1
            workload: search
          - {}

JVM Flags

spec.clusters[].jvmFlags

유형: 문자열 배열

mongot 프로세스 에 전달된 JVM 플래그입니다. Kubernetes Operator는 --jvm-flags "<all flags space-separated>"를 사용하는 mongot 스타트업 명령에 수정하지 않은 플래그를 포함합니다.

각 플래그는 -X, -XX: 또는 -D(으)로 시작해야 하며 공백을 포함하지 않아야 합니다. 영수자 및 숫자 문자와 ., _, +, :, -, = 문자만 포함할 수 있습니다. Kubernetes 연산자는 이 규칙에 부합하지 않는 플래그를 거부합니다.

이 필드 에 -Xms 또는 -Xmx 을 지정하지 않으면 Kubernetes Operator는 둘 다 spec.clusters[].resourceRequirements.requests.memory의 절반으로 설정하여 힙 크기를 자동으로 계산합니다. 리소스 요구 사항을 지정하지 않으면 Kubernetes Operator는 기본값 인 4Gi 메모리 요청 사용하여 약 -Xmx2048m -Xms2048m를 생성합니다.

자체 -Xms 또는 -Xmx 값을 제공하는 경우 Kubernetes Operator는 해당 값을 사용하며 값을 재정의하지 않습니다. Kubernetes 연산자는 항상 연산자 계산 플래그 뒤에 제공한 플래그를 추가합니다.

자세한 학습 은 mongot 에 대한 하드웨어 크기 조정을 참조하세요.

예시

spec:
  clusters:
    - jvmFlags:
        - -Xms2g
        - -Xmx2g

StatefulSet 재정의

spec.clusters[].statefulSet

유형: 객체

Kubernetes 연산자가 mongot 포드 배포를 위해 만드는 StatefulSet 에 대한 재정의입니다. Kubernetes 연산자는 항상 재정의를 마지막에 적용하므로 Kubernetes 연산자가 계산하는 설정을 재정의가 재정의합니다.

이 객체 에는 두 개의 필드가 포함되어 있습니다.

• metadata — Kubernetes 연산자가 StatefulSet 메타데이터에 병합하는 labels 및 annotations 필드를 포함합니다.

• spec — apps/v1/StatefulSetSpec 객체. Kubernetes Operator는 이러한 재정의를 StatefulSet 사양에 병합합니다.

참고

spec.clusters[].statefulSet을(를) 사용하여 리소스 요구 사항 또는 지속성 설정을 설정하다 하지 마세요. 대신 spec.clusters[].resourceRequirements 및 spec.clusters[].persistence 필드를 각각 사용합니다.

고급 mongot 설정

spec.clusters[].advancedMongotConfigs

유형: 객체

이 클러스터 항목에 대한 고급 mongot 설정입니다. Kubernetes Operator는 값을 읽거나 수정하지 않고 mongot 설정 파일의 advancedConfigs 키 아래에 그대로 렌더링합니다. 이 필드는 mongot 구성에서 Kubernetes 연산자가 다른 곳에서 생성하는 설정에 영향을 주지 않습니다.

MongoDBSearch 리소스가 최상위 필드로 노출하지 않는 mongot 설정에만 이 필드를 사용합니다.