MongoDB database 리소스 사양

필수 사항

apiVersion

유형: 문자열

MongoDB 리소스 스키마의 버전입니다.

kind

유형: 문자열

생성하고자 하는 MongoDB 리소스 유형입니다. 이것을 MongoDB(으)로 설정합니다.

metadata.name

유형: 문자열

생성할 MongoDB 리소스의 이름입니다.

리소스 이름은 44자 이내여야 합니다.

spec.credentials

유형: 문자열

필수입니다. 시크릿 Kubernetes MongoDB Ops Manager API 의 이름 Kubernetes Cloud Manager MongoDB Ops Manager는 Operator가 또는 와 통신할 수 있도록 인증 자격 증명 으로 생성 했습니다.

자격 증명을 보유하고 있는 Ops Manager 쿠버네티스 시크릿 객체는 생성하려는 리소스와 동일한 네임스페이스에 존재해야 합니다.

중요

연산자는 시크릿에 대한 변경 사항을 관리합니다

Kubernetes Operator는 시크릿에 대한 모든 변경 사항을 추적하고 MongoDB 리소스 상태를 조정합니다.

spec.persistent

유형: 부울

기본값: True

경고: 컨테이너에 영구 볼륨 에 쓰기 (write) 수 있는 권한을 부여합니다. . Kubernetes Operator는 securityContext 에 fsGroup = 2000, runAsUser = 2000 및 runAsNonRoot = true 설정합니다. Kubernetes Operator는 fsgroup 을(를 runAsUser 으)로 설정하여 컨테이너 에서 메인 프로세스 를 실행하는 사용자가 볼륨을 쓸 수 있도록 합니다. 학습 보려면 Pod 또는 컨테이너에 대한 보안 컨텍스트 구성을 참조하세요. 및 관련 토론 Kubernetes 문서에서 확인 가능합니다. 리소스 를 다시 배포해도 영구 볼륨 문제가 해결되지 않으면 MongoDB 지원팀 에 문의 하세요.

Disk Usage Disk IOPS 영구 볼륨 Processes 을 Deployment 사용하지 Metrics 않는 경우 및 Atlas 차트는 이 배포에 대한 데이터를 검토 할 때 페이지의 탭이나 페이지에 표시할 수 없습니다.

spec.type

유형: 문자열

생성하고자 하는 MongoDB 리소스 유형입니다. 허용되는 값은 다음과 같습니다.

• Standalone

• ReplicaSet

• ShardedCluster

spec.version

유형: 문자열

MongoDB 리소스에 설치한 MongoDB의 버전.

중요

호환되는 MongoDB Server 버전을 선택하도록 합니다.

호환되는 버전은 MongoDB database 리소스가 사용하는 기본 이미지에 따라 다릅니다.

참고

데이터베이스 리소스에 대해 이 값을 이후 버전의 MongoDB 로 업데이트 하는 경우, 기능 호환성 버전 은 업그레이드하려는 MongoDB 버전으로 유지되어 필요한 경우 다운그레이드할 수 있는 옵션을 제공합니다. 기능 호환성 버전 이 새 MongoDB 버전과 일치하도록 하려면 spec.featureCompatibilityVersion 을 새 버전 또는 AlwaysMatchVersion 로 수동으로 설정하다 해야 합니다. 학습 내용은 spec.featureCompatibilityVersion 를 참조하세요.

조건부

모든 리소스는 다음 설정 중 하나를 사용해야 합니다.

spec.opsManager.configMapRef.name

유형: 문자열

ConfigMap 의 이름 Cloud Manager 또는 MongoDB Ops Manager 연결 구성을 사용합니다. spec.cloudManager.configMapRef.name 설정은 이 설정의 별칭이며 대신 사용할 수 있습니다.

이 값은 생성하려는 리소스와 동일한 네임스페이스에 존재해야 합니다.

중요

Operator가 ConfigMap의 변경 사항을 관리합니다.

Kubernetes Operator는 ConfigMap에 대한 모든 변경 사항을 추적하고 MongoDB 리소스 상태를 조정합니다.

spec.cloudManager.configMapRef.name

유형: 문자열

spec.opsManager.configMapRef.name 의 별칭입니다.

옵션

모든 리소스 유형은 다음 설정을 사용할 수 있습니다:

metadata.annotations.mongodb.com/v1.architecture

유형: 문자열

특정 배포에서 사용하는 컨테이너 아키텍처를 결정합니다.

• 런타임에 MongoDB 바이너리를 다운로드하는 기본 비정적 컨테이너 또는

• 런타임에 변경되지 않는 정적 컨테이너(공개 미리 보기) 입니다.

허용되는 값은 다음과 같습니다.

• static

• non-static

apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: my-project
  annotations:
    mongodb.com/v1.architecture: "static"

spec.agent.backupAgent.logRotate

유형: 객체

MongoDB Agent 가 백업 로그 를 로테이션하는 임계값입니다.

spec.agent.backupAgent.logRotate.sizeThresholdMB

유형: integer

MongoDB Agent 가 로그를 로테이션하기 전의 백업 로그 파일 의 최대 크기(MB)입니다.

spec.agent.backupAgent.logRotate.timeThresholdHrs

유형: integer

MongoDB Agent 가 백업 로그 파일 을 로테이션하는 데 걸리는 시간(시간)입니다.

spec.agent.mongod.auditlogRotate

유형: 객체

MongoDB 프로세스에 대한 감사 로그 순환 구성이 포함된 객체입니다.

spec.agent.mongod.auditlogRotate.sizeThresholdMB

유형: 숫자

MongoDB Agent 가 로그를 로테이션하기 전의 감사 로그 파일 의 최대 크기(MB)입니다.

spec.agent.mongod.auditlogRotate.timeThresholdHrs

유형: integer

MongoDB Agent 가 감사 로그 파일 을 로테이션하는 데 걸리는 시간(시간)입니다.

spec.agent.mongod.auditlogRotate.numUncompressed

유형: integer

현재 로그 파일 을 포함하여 압축되지 않은 상태로 유지할 총 감사 로그 파일의 최대 개수입니다.

spec.agent.mongod.auditlogRotate.numTotal

유형: integer

MongoDB Ops Manager 가 보관하는 감사 로그 파일의 총 개수입니다. 이 값을 설정하다 하지 않으면 총 감사 로그 파일 수가 기본적으로 0 로 설정됩니다.

spec.agent.mongod.auditlogRotate.percentOfDiskspace

유형: 숫자

Ops Manager가 10진수로 표시된 로그 파일을 저장하는 데 사용할 수 있는 총 디스크 공간의 최대 백분율입니다. 이 제한을 초과하면 Ops Manager는 이 제한에 도달할 때까지 로그 파일을 삭제합니다. Ops Manager는 가장 오래된 로그 파일을 먼저 삭제합니다.

기본값은 0.02 입니다.

spec.agent.mongod.logRotate

유형: 객체

MongoDB Ops Manager 가 프로세스 의 MongoDB 로그를 로테이션하는 임계값입니다.

spec.agent.mongod.logRotate.sizeThresholdMB

유형: integer

MongoDB Ops Manager 가 로그 파일을 로테이션하기 전의 개별 로그 파일 의 최대 크기(MB)입니다. MongoDB Ops Manager 는 로그 파일이 이 sizeThresholdMB 또는 spec.agent.mongod.logRotate.timeThresholdHrs에 지정된 값을 충족하는 경우 즉시 로그 파일 을 회전합니다.

spec.agent.mongod.logRotate.timeThresholdHrs

유형: integer

다음 로테이션 전 개별 로그 파일의 최대 기간(단위: 시간)입니다. 시간은 마지막 회전 이후의 시간입니다.

파일이 이 또는 를 spec.agent.mongod.logRotate.sizeThresholdMB 충족하면MongoDB Ops Manager 가 로그 파일 파일 순환합니다.timeThresholdHrs

spec.agent.monitoringAgent.logRotate

유형: 객체

MongoDB Agent 가 모니터링 로그 를 로테이션하는 임계값입니다.

spec.agent.monitoringAgent.logRotate.sizeThresholdMB

유형: integer

MongoDB Agent 가 모니터링 로그 를 로테이션하기 전의 개별 로그 파일 의 최대 크기(MB)입니다.

spec.agent.monitoringAgent.logRotate.timeThresholdHrs

유형: integer

MongoDB Agent 가 모니터링 로그 를 로테이션하는 데 걸리는 시간(시간)입니다.

spec.agent.readinessProbe.environmentVariables

유형: 객체

준비성 프로브의 로그 파일을 제어하는 데 사용되는 다음 환경 변수를 구성합니다.

• READINESS_PROBE_LOGGER_BACKUPS

• READINESS_PROBE_LOGGER_COMPRESS

• READINESS_PROBE_LOGGER_MAX_SIZE

• READINESS_PROBE_LOGGER_MAX_AGE

• MDB_WITH_AGENT_FILE_LOGGING

• LOG_FILE_PATH

apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: my-project
spec:
  agent:
    readinessProbe:
      environmentVariables:
        READINESS_PROBE_LOGGER_BACKUPS: 1
        READINESS_PROBE_LOGGER_MAX_SIZE: 10
        READINESS_PROBE_LOGGER_MAX_AGE: 3
        READINESS_PROBE_LOGGER_COMPRESS: true
        MDB_WITH_AGENT_FILE_LOGGING: false
        LOG_FILE_PATH: /var/log/mongodb-mms-automation/readiness.log

spec.featureCompatibilityVersion

유형: 문자열

기본값은 MongoDB 업그레이드 후 이전 주요 MongoDB 버전입니다.

새로운 주요 버전으로 업그레이드 할 때 발생하는 데이터 변경 사항을 제한합니다. 예를 예시 , MongoDB 5.0 에서 MongoDB 6.0 로 업그레이드 하는 경우, 기능 호환성 버전 은 5.0 로 유지되어 필요한 경우 다운그레이드할 수 있는 옵션을 제공합니다.

기능 호환성 버전 을 새 MongoDB 버전과 일치시키려면 featureCompatibilityVersion 을 새 버전으로 수동으로 설정하다 해야 합니다. 예를 예시featureCompatibilityVersion: 6.0 입니다.

또는 AlwaysMatchVersion 옵션을 활성화 하여 업그레이드 중에 MongoDB 버전과 일치하도록 기능 호환성 버전 을 자동으로 업데이트 할 수 있습니다. 예를 예시featureCompatibilityVersion: AlwaysMatchVersion 입니다.

기능 호환성에 학습 보려면 MongoDB 매뉴얼의 setFeatureCompatibilityVersion 을 참조하세요.

spec.clusterDomain

유형: 문자열

기본값: cluster.local

Kubernetes Operator를 배포하는 Kubernetes 클러스터의 도메인 이름입니다. Kubernetes가 StatefulSet 를 생성하는 경우 , Kubernetes는 각 Pod 를 할당합니다.FQDN . Cloud Manager 또는 MongoDB Ops Manager를 업데이트하기 위해 Kubernetes Operator는 각 Pod 의 FQDN을 계산합니다. 제공된 클러스터 이름을 사용합니다. Kubernetes는 이러한 호스트 이름을 쿼리하는 API 를 제공하지 않습니다.

경고

spec.clusterDomain Kubernetes 클러스터에 기본 도메인 이 있는 경우 cluster.local 을(를) 설정해야 합니다. 기본값 이외. 기본값을 사용하지 않거나 spec.clusterDomain 옵션을 설정하지 않으면 Kubernetes Operator가 예상대로 작동하지 않을 수 있습니다.

spec.clusterName

유형: 문자열

기본값: cluster.local

중요

spec.clusterName은 더 이상 사용되지 않습니다.

대신 spec.clusterDomain 를 사용하세요.

Kubernetes Operator를 배포하는 Kubernetes 클러스터의 도메인 이름입니다. Kubernetes가 StatefulSet 를 생성하는 경우 , Kubernetes는 각 Pod 를 할당합니다.FQDN . Cloud Manager 또는 MongoDB Ops Manager를 업데이트하기 위해 Kubernetes Operator는 각 Pod 의 FQDN을 계산합니다. 제공된 클러스터 이름을 사용합니다. Kubernetes는 이러한 호스트 이름을 쿼리하는 API 를 제공하지 않습니다.

경고

spec.clusterDomain Kubernetes 클러스터에 기본 도메인 이 있는 경우 cluster.local 을(를) 설정해야 합니다. 기본값 이외. 기본값을 사용하지 않거나 spec.clusterDomain 옵션을 설정하지 않으면 Kubernetes Operator가 예상대로 작동하지 않을 수 있습니다.

metadata.namespace

유형: 문자열

Kubernetes 네임스페이스 이 MongoDB 리소스 및 기타 객체 를 생성하는 위치 .

spec.service

유형: 문자열

기본값: <resource_name>+'-svc' 및 <resource_name>+'-svc-external'

중요

spec.service는 더 이상 사용되지 않습니다.

대신 spec.statefulSet.spec.serviceName 를 사용하세요.

StatefulSet 에 생성하거나 사용할 Kubernetes 서비스의 이름 . 이 이름의 서비스가 이미 존재하는 경우, MongoDB Enterprise Kubernetes Operator는 해당 서비스를 삭제하거나 다시 생성하지 않습니다. 이 설정을 사용하면 사용자 지정 서비스를 직접 생성하고 Kubernetes Operator가 이를 재사용할 수 있습니다.

spec.logLevel

유형: 문자열

기본값: INFO

Pod 내부의 자동화 에이전트 로깅 수준을 구성합니다.. 허용되는 값은 다음과 같습니다.

• DEBUG

• INFO

• WARN

• ERROR

• FATAL

spec.security.authentication.ignoreUnknownUsers

유형: 부울

기본값: false

Kubernetes Operator 또는 Cloud Manager 또는 Ops Manager 사용자 인터페이스를 통해 구성되지 않은 데이터베이스 사용자를 수정할 수 있는지 여부를 결정합니다.

mongod 또는 mongos 을(를) 통해 데이터베이스 사용자를 직접 관리하려면 이 설정을 true 으)로 설정합니다.

독립형 설정

spec.additionalMongodConfig

유형: 컬렉션

MongoDB 프로세스를 시작할 때 사용하는 추가 구성 옵션입니다.

Kubernetes Operator는 MongoDB Agent를 통해 배포하는 MongoDB 버전의 모든 구성 옵션을 지원합니다. 단, 사용자가 다음 옵션에 제공한 값은 Kubernetes Operator에 의해 재정의됩니다.

• net.port

• net.tls.certificateKeyFile

• net.tls.clusterFile

• replication.replSetName

• security.clusterAuthMode

• sharding.clusterRole

• storage.dbPath

• systemLog.destination

• systemLog.path

Kubernetes Operator가 소유하는 구성 옵션에 대해 자세히 알아보려면 MongoDB Kubernetes Operator전용 설정을 참조하세요.

사용할 수 있는 구성 옵션에 대해 알아보려면 Ops 관리자 설명서에서 MongoDB 배포를 위한 고급 옵션을 참조하세요.

spec.agent

유형: 컬렉션

MongoDB 데이터베이스 리소스에 대한 MongoDB Agent 구성 설정입니다.

spec.agent.startupOptions

유형: 컬렉션

MongoDB 데이터베이스 리소스를 시작하는 데 적합한 MongoDB Agent 설정.

MongoDB Agent 설정을 키-값 쌍으로 제공해야 합니다. 값은 문자열이어야 합니다.

지원되는 MongoDB Agent 설정 목록은 다음을 참조하세요.

• Cloud Manager 프로젝트에 대한 MongoDB Agent 설정 .

• Operator와 함께 배포한 MongoDB Ops Manager 버전에 대한MongoDB Agent 설정 입니다. Kubernetes

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDB
4
metadata:
5
  name: my-standalone
6
spec:
7
  version: "6.0.0-ent"
8
  service: my-service
9
10
  opsManager:
11
    configMapRef:
12
      name: my-project
13
  credentials: my-credentials
14
  type: Standalone
15
16
  persistent: true
17
  agent:
18
    startupOptions:
19
      maxLogFiles: "30"
20
      dialTimeoutSeconds: "40"
21
...

spec.podSpec

유형: 객체

MongoDB CustomResourceDefinition 의 사양이 포함된 객체 Pods.

spec.externalAccess

유형: 컬렉션

외부 연결을 위해 클러스터를 노출하는 사양입니다. Kubernetes 클러스터 외부에서 MongoDB 리소스에 연결하는 방법을 알아보려면 Kubernetes 외부에서 MongoDB 데이터베이스 리소스에 연결하기를 참조하세요.

spec.externalAccess 추가하면 Kubernetes Operator가 복제본 세트의 각 파드에 대한 외부 서비스를 생성합니다. 외부 서비스는 클러스터의 각 MongoDB database 파드에 대한 외부 진입점을 제공합니다. 각 외부 서비스에는 선택기 가 있습니다. 외부 서비스를 특정 Pod와 일치시킵니다.

이 설정을 값없이 추가하면 Kubernetes Operator는 다음과 같은 기본값을 사용하여 외부 서비스를 생성합니다.

필드	값	설명
Name	<pod-name>-svc-external	외부 서비스의 이름입니다. 이 값은 변경할 수 없습니다.
Type	LoadBalancer	외부 LoadBalancer 서비스를 생성합니다.
Port	<Port Number>	mongod 에 대한 포트입니다.
publishNotReadyAddress	true	DNS 레코드 가 파드가 준비되지 않은 경우에도 생성됩니다. 데이터베이스 Pod에 대해 false 로 설정하지 마세요.

참고

spec.externalAccess.externalDomain 설정하면 외부 서비스가 백업을 위해 다른 포트(Port Number + 1)를 추가합니다.

spec.externalAccess.externalService

유형: 컬렉션

spec.externalAccess 의 기본값을 재정의하기 위한 사양입니다.

spec.externalAccess 설정을 설정하면 Kubernetes Operator가 기본값 인 외부 로드 밸런서 서비스를 자동으로 생성합니다. 필요에 따라 특정 값을 재정의하거나 새 값을 추가할 수 있습니다. 예를 들어 NodePort 서비스 를 생성하려는 경우 로드 밸런서가 필요하지 않은 경우 Kubernetes 사양에서 재정의를 구성해야 합니다.

externalAccess:
  externalService:
    annotations:
      # cloud-specific annotations for the service
    spec:
      type: NodePort # default is LoadBalancer
      # you can specify other spec overrides if necessary

Kubernetes 사양에 대한 자세한 내용은 Kubernetes 설명서의 ServiceSpec을 참조하세요.

spec.externalAccess.externalService.annotations

유형: 컬렉션

배포의 모든 클러스터에 클라우드 제공자별 구성 설정을 추가할 수 있는 키-값 쌍입니다. 자세히 알아보려면 주석 을 참조하세요. 및 Kubernetes 클라우드 제공자에 대한 설명서를 참조하세요.

주석 을 사용할 수 있습니다. Kubernetes Operator 배포에서 사용하는 외부 서비스에 대한 자리 표시자 값을 지정합니다. Kubernetes Operator는 다음 표에 설명된 대로 이러한 값을 올바른 값으로 자동으로 바꿉니다. 자리 표시자를 사용하면 특정 파드의 각 서비스에 특정 어노테이션을 제공할 수 있습니다.

값	설명
{resourceName}	metadata.name 과 같습니다.
{namespace}	metadata.namespace 과 같습니다.
{podIndex}	StatefulSet 에 의해 할당된 파드의 인덱스 현재 외부 서비스의 대상이 됩니다.
{podName}	{resourceName}-{podIndex} 과 같습니다.
{statefulSetName}	StatefulSet. {resourceName} 와 같습니다.
{externalServiceName}	지정한 자리 표시자 값을 기반으로 외부 서비스의 생성된 이름입니다. {resourceName}-{podIndex}-svc-external 과 같습니다.
{mongodProcessDomain}	mongod 프로세스를 호스팅하는 서버의 도메인 이름입니다. 지정된 경우 spec.externalAccess.externalDomain 와 같습니다. 그렇지 않으면 mongod 프로세스 FQDN 에 사용된 도메인과 동일합니다. 예를 들어 프로세스 호스트 이름 mdb-rs-1.example.com 의 경우 example.com 은 도메인 이름입니다.
{mongodProcessFQDN}	자동화 mongod구성 에 설정된 프로세스 호스트 이름입니다. 프로세스 호스트 이름은 배포 구성에 따라 달라집니다. external domains 을(를) 사용하도록 배포를 구성한 경우 프로세스 호스트 이름은 다음 형식을 사용합니다. {resourceName}-{podIndex}.{mongodProcessDomain} 예를 들면 다음과 같습니다. mdb-rs-1.example.com 배포에서 외부 도메인을 사용하지 않는 경우 프로세스 호스트 이름은 다음 형식을 사용합니다. {resourceName}-{podIndex}.{resourceName}-{podIndex}-svc.{namespace}.svc.cluster.local 예를 들면 다음과 같습니다. mdb-rs-1.mdb-rs-1-svc.ns.svc.cluster.local

참고

표에 지정된 대로 알려진 자리 표시자 값만 사용해야 하며 자리 표시자가 비어 있거나 null 값을 사용하지 않도록 해야 합니다. 또한 단일 MongoDB 리소스 배포서버 에 다중 Kubernetes 클러스터 배포와 관련된 자리 표시자를 사용할 수 없습니다.

그렇지 않으면 Kubernetes Operator가 오류를 반환합니다. 예를 들어 다음과 같은 오류 메시지가 표시될 수 있습니다.

error replacing placeholders in map with key=external-dns.alpha.kubernetes.io/hostname, value={resourceName}-{podIndex}-{unknownPlaceholder}.{clusterName}-{clusterIndex}.example.com: missing values for the following placeholders: {clusterName}, {clusterIndex}, {unknownPlaceholder}``

예시

다음 예제에서는 {resourceName}, {podIndex} 및 {namespace} 자리 표시자를 지정합니다.

apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: mdb-rs
  namespace: ns
spec:
  replicas: 3
  externalAccess:
    externalService:
      annotations:
        external-dns.alpha.kubernetes.io/hostname: {resourceName}-{podIndex}-{namespace}.example.com

Kubernetes Operator는 각 자리 표시자의 적절한 값을 기반으로 외부 서비스에 대한 주석을 자동으로 채웁니다. 예를 들면 다음과 같습니다.

mdb-rs-0-svc-external:
  annotations:
    external-dns.alpha.kubernetes.io/hostname: mdb-rs-0-ns.example.com
mdb-rs-1-svc-external:
  annotations:
    external-dns.alpha.kubernetes.io/hostname: mdb-rs-1-ns.example.com
mdb-rs-2-svc-external:
  annotations:
    external-dns.alpha.kubernetes.io/hostname: mdb-rs-2-ns.example.com

spec.externalAccess.externalService.spec

유형: 컬렉션

ServiceSpec 구성 . 자세한 내용은 spec.externalAccess.externalService 을(를) 참조하세요.

spec.podSpec.persistence.single

유형: 컬렉션

Kubernetes Operator가 하나의 퍼시스턴트 볼륨 클레임(Persistent Volume Claim, PVC)을 생성하고 데이터와 저널 및 로그에 대한 세 개의 디렉토리를 모두 동일한 퍼시스턴트 볼륨 마운트하도록 합니다.

참고

• spec.persistent : true 인 경우 이 컬렉션의 값을 설정해야 합니다.

• 이 컬렉션 또는 persistence.multiple 컬렉션을 설정할 수 있지만 둘 다 설정할 수는 없습니다.

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

spec.podSpec.persistence.multiple.data

유형: 컬렉션

Kubernetes Operator가 영구 볼륨 클레임 을 생성하도록 설정 자체 영구 볼륨 에 데이터의 디렉토리를 마운트합니다. .

참고

• spec.persistent : true 인 경우 이 컬렉션의 값을 설정해야 합니다.

• 이 컬렉션 또는 persistence.single 컬렉션을 설정할 수 있지만 둘 다 설정할 수는 없습니다.

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

spec.podSpec.persistence.multiple.journal

유형: 컬렉션

Kubernetes Operator가 영구 볼륨 클레임 을 생성하도록 설정 자체 영구 볼륨 에 저널용 디렉토리를 마운트합니다. .

참고

• spec.persistent : true 인 경우 이 컬렉션의 값을 설정해야 합니다.

• 이 컬렉션 또는 persistence.single 컬렉션을 설정할 수 있지만 둘 다 설정할 수는 없습니다.

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

spec.podSpec.persistence.multiple.logs

유형: 컬렉션

Kubernetes Operator가 영구 볼륨 클레임 을 생성하도록 설정 자체 영구 볼륨 에 로그용 디렉토리를 마운트합니다. .

참고

• spec.persistent : true 인 경우 이 컬렉션의 값을 설정해야 합니다.

• 이 컬렉션 또는 persistence.single 컬렉션을 설정할 수 있지만 둘 다 설정할 수는 없습니다.

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

spec.podSpec.podTemplate.affinity.nodeAffinity

유형: 구조체

Kubernetes 규칙 Pods 배치 특정 범위의 노드 에 있는 복제본 세트 의 경우 .

읽기-쓰기 성능을 최적화하려면 Pods 를 제한하는 노드 어피니티 규칙을 사용하세요. 특정 노드 에서 실행 또는 특정 노드 에서 실행하는 것을 선호합니다. .

spec.podSpec.podTemplate.affinity.podAffinity

유형: 구조체

Kubernetes 규칙 여러 MongoDB 리소스 파드 가 다른 Pod 와 함께 위치해야 합니다. . 사용 사례에 대해 자세히 알아보려면 선호도 및 반 선호도 를 참조하세요. Kubernetes 문서에서 확인 가능합니다.

spec.podSpec.podTemplate.affinity.podAntiAffinity

유형: 구조체

Default: kubernetes.io/hostname

규칙 설정 Pods 확산 MongoDB 리소스를 다른 위치에 호스팅합니다. 위치는 단일 노드, 랙 또는 리전일 수 있습니다. 기본적으로 Kubernetes Operator는 여러 노드에 파드를 분산하려고 시도합니다.

spec.podSpec.podTemplate.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.topologyKey

유형: 구조체

Default: kubernetes.io/hostname

이 키는 다음 레이블 을 정의합니다. 토폴로지 도메인 을 결정하는 데 사용됩니다. 노드가 속합니다.

spec.podSpec.podTemplate

유형: 컬렉션

템플릿 Kubernetes MongoDB Enterprise Kubernetes Operator MongoDB database 가 리소스에 대해 생성하는 Pods의 경우.

템플릿 값은 spec.podSpec에 지정된 값보다 우선합니다.

참고

Kubernetes Operator가 spec.podSpec.podTemplate에 제공한 필드의 유효성을 검사하지 않습니다.

spec.podSpec.podTemplate.metadata

유형: 컬렉션

MongoDB Enterprise Kubernetes Operator가 MongoDB 데이터베이스 리소스용으로 생성하는 Kubernetes Pods의 메타데이터입니다.

에추가할 수 있는 필드를 검토하려면 spec.podSpec.podTemplate.metadata Kubernetes 설명서를 참조하세요.

spec.podSpec.podTemplate.spec

유형: 컬렉션

MongoDB Enterprise Kubernetes Operator가 MongoDB 데이터베이스 리소스용으로 생성하는 Kubernetes 포드의 사양입니다.

에 추가할 수 spec.podSpec.podTemplate.spec Kubernetes 있는 필드를1 Core API 검토하려면 PodSpec v 를 참조하세요.

참고

spec.podSpec.podTemplate.spec.containers에 컨테이너를 추가하면 Kubernetes Operator가 컨테이너를 Kubernetes 포드에 추가합니다. 이러한 컨테이너는 포드의 MongoDB 데이터베이스 리소스 컨테이너에 추가됩니다.

이 설정을 사용하여 각 포드에 대한 CPU 및 RAM 할당을 지정합니다. 예제 는 의 샘플을 Github 참조하세요.

복제본 세트 설정

다음 설정은 복제본 세트 리소스 유형에 적용됩니다:

spec.backup

유형: 컬렉션

spec.backup.mode 의 collection 컨테이너로, Kubernetes Operator에서 MongoDB 리소스에 대한 지속적인 백업을 가능하게 합니다.

spec.backup.assignmentLabels

유형: 배열

쉼표로 구분된 레이블 목록으로, 특정 프로젝트 또는 그룹에 백업 데몬, oplog 저장소, 블록스토어, S3 스냅샷 저장소, 파일 시스템 저장소를 할당할 수 있습니다. 할당 레이블을 사용하여 특정 백업 저장소가 특정 프로젝트와 연결되어 있는지 식별합니다.

Kubernetes Operator를 사용하여 할당 레이블을 설정하는 경우 Kubernetes 구성 파일에서 설정한 할당 레이블 값이 Ops Manager UI에 정의된 값을 재정의합니다. Kubernetes Operator를 사용하여 설정하지 않은 할당 레이블은 Ops Manager UI에 설정된 값을 계속 사용합니다.

참고

이 매개변수를 설정하는 경우 spec.credentials 값으로 연결된 API 키에 Global Owner 역할이 있어야 합니다.

spec.backup.mode

유형: 문자열

MongoDB 리소스에 대한 지속적인 백업을 활성화합니다. 가능한 값은 enabled, disabled, terminated입니다.

참고

설정은 MongoDB Ops spec.backup.mode Manager에서 활성화된 백업 에 의존하며, MongoDB Ops Manager 리소스 spec.backup.enabled 사양 의 값이 으)로 설정되어야 true 합니다.

spec.backup.mode 를 사용하여 MongoDB 리소스에 대한 연속 백업을 활성화한 후 백업 상태를 확인할 수 있습니다.

spec.backup.encryption

유형: 객체

백업 암호화 구성 설정이 포함된 객체입니다.

spec.backup.encryption.kmip

유형: 객체

KMIP 백업 암호화 구성 설정을 포함하는 객체입니다. 자세히 알아보려면 운영 관리자를 위한 KMIP 백업 암호화 구성을 참조하세요.

spec.backup.encryption.kmip.client

유형: 객체

KMIP 백업 암호화 클라이언트 구성 설정을 포함하는 객체입니다.

spec.backup.encryption.kmip.client.clientCertificatePrefix

유형: 문자열

spec.backup.snapshotSchedule

유형: 컬렉션

Kubernetes Operator에서 MongoDB 리소스에 대한 연속 백업을 위한 스냅샷 일정 설정을 위한 collection 컨테이너입니다.

spec.backup.snapshotSchedule.snapshotIntervalHours

유형: 숫자

스냅샷 사이의 시간 간격입니다. 6, 8, 12 또는 24 값을 설정할 수 있습니다.

spec.backup.snapshotSchedule.snapshotRetentionDays

유형: 숫자

최근 스냅샷을 보관할 일수입니다. 2에서 5 사이의 값을 설정할 수 있습니다.

spec.backup.snapshotSchedule.dailySnapshotRetentionDays

유형: 숫자

일일 스냅샷을 보관할 수 있는 일수입니다. 1에서 365 사이의 값을 설정할 수 있습니다. 값을 0으로 설정하면 이 규칙이 비활성화됩니다.

spec.backup.snapshotSchedule.weeklySnapshotRetentionWeeks

유형: 숫자

주간 스냅샷을 보관할 주 수입니다. 1에서 52 사이의 값을 설정할 수 있습니다. 값을 0으로 설정하면 이 규칙이 비활성화됩니다.

spec.backup.snapshotSchedule.monthlySnapshotRetentionMonths

유형: 숫자

월별 스냅샷을 보관하는 개월 수입니다. 1에서 36 사이의 값을 설정할 수 있습니다. 값을 0으로 설정하면 이 규칙이 비활성화됩니다.

spec.backup.snapshotSchedule.pointInTimeWindowHours

유형: 숫자

특정 시점 스냅샷을 만들 수 있는 과거의 기간(시간 단위)입니다.

spec.backup.snapshotSchedule.referenceHourOfDay

유형: 숫자

24시간 형식을 사용하여 스냅샷을 예약할 날의 UTC 시간입니다. 0에서 23 사이의 값을 설정할 수 있습니다.

spec.backup.snapshotSchedule.referenceMinuteOfHour

유형: 숫자

스냅샷을 예약한 시간의 UTC 분입니다. 0에서 59 사이의 값을 설정할 수 있습니다.

spec.backup.snapshotSchedule.fullIncrementalDayOfWeek

유형: 문자열

Ops Manager가 전체 스냅샷을 찍는 요일입니다. 이 설정은 최근의 작업에 대한 완전한 백업을 보장합니다. Ops Manager의 기본값은 SUNDAY로 설정됩니다.

spec.clusterName

유형: 문자열

기본값: cluster.local

중요

spec.clusterName은 더 이상 사용되지 않습니다.

대신 spec.clusterDomain 를 사용하세요.

Kubernetes Operator를 배포하는 Kubernetes 클러스터의 도메인 이름입니다. Kubernetes가 StatefulSet 를 생성하는 경우 , Kubernetes는 각 Pod 를 할당합니다.FQDN . Cloud Manager 또는 MongoDB Ops Manager를 업데이트하기 위해 Kubernetes Operator는 각 Pod 의 FQDN을 계산합니다. 제공된 클러스터 이름을 사용합니다. Kubernetes는 이러한 호스트 이름을 쿼리하는 API 를 제공하지 않습니다.

경고

spec.clusterDomain Kubernetes 클러스터에 기본 도메인 이 있는 경우 cluster.local 을(를) 설정해야 합니다. 기본값 이외. 기본값을 사용하지 않거나 spec.clusterDomain 옵션을 설정하지 않으면 Kubernetes Operator가 예상대로 작동하지 않을 수 있습니다.

spec.connectivity.replicaSetHorizons

유형: 컬렉션

클라이언트 애플리케이션 및 MongoDB Agent에 대해 다양한 DNS 설정을 제공할 수 있습니다. Kubernetes Operator는 복제본 세트 멤버에 대해 분할 수평 DNS를 사용합니다. 이 기능을 사용하면 Kubernetes cluster 내부와 Kubernetes 외부 모두에서 통신할 수 있습니다.

호스트당 여러 개의 외부 매핑을 추가할 수 있습니다.

스플릿 호라이즌 요구 사항:

• 이 배열의 각 값이 고유한지 확인합니다.

• 이 배열의 항목 수가 spec.members 에 지정된 값과 일치하는지 확인합니다.

• spec.security.certsSecretPrefix 설정 값을 입력하여 TLS 를 활성화합니다. 분할 경계를 사용하는 이 방법에는 TLS 프로토콜의 MongoDB 서버 이름 표시 확장이 필요합니다.

• 외부 호스트 이름에 대한 라우팅을 구성합니다.

예시

이 예에서 복제본 세트 멤버는 example-localhost 경계에서 서로 통신합니다. 클라이언트는 example-website 경계를 사용하여 복제본 세트와 통신합니다.

언급된 지평의 이름은 이 예시 의 목적에 따라 임의적입니다. 수평선의 이름은 무엇이든 지정할 수 있지만 해당 수평선의 일부인 모든 호스트 이름에 대해 수평선 이름이 동일해야 합니다.

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDB
4
metadata:
5
  name: <my-replica-set>
6
spec:
7
  members: 3
8
  version: "4.2.2-ent"
9
  type: ReplicaSet
10
  opsManager:
11
    configMapRef:
12
      name: <configMap.metadata.name>
13
  credentials: <mycredentials>
14
  persistent: true

15
  security:
16
    tls:
17
      enabled: true
18
  connectivity:
19
    replicaSetHorizons:
20
      - "example-website": "web1.example.com:30907"
21
      - "example-website": "web2.example.com:32350"
22
      - "example-website": "web3.example.com:31185"
23
...

spec.externalAccess.externalDomain

유형: 문자열

복제본 세트 배포를 외부에 노출하는 데 사용되는 외부 도메인입니다.

기본적으로 각 복제본 세트 멤버는 Kubernetes Pod의 FQDN(*.svc.cluster.local)을 기본 호스트 이름으로 사용합니다. 하지만 이 설정에 외부 도메인을 추가하면 복제본 세트는 지정된 도메인의 하위 도메인을 호스트 이름으로 대신 사용합니다. 이 호스트 이름은 다음 형식을 사용합니다:

<replica-set-name>-<pod-idx>.<externalDomain>

예를 들면 다음과 같습니다.

replica-set-1.example.com

이 설정을 사용하여 복제본 세트를 배포한 후 Kubernetes Operator는 외부 도메인이 있는 호스트 이름을 사용하여 MongoDB Ops Manager 자동화 구성 의 processes[n].hostname 필드를 재정의합니다. 그런 다음 MongoDB Agent는 이 호스트 이름을 사용하여 mongod 에 연결합니다.

복제본 세트에 연결하기 위한 다른 호스트 이름을 지정하려면 spec.connectivity.replicaSetHorizons 설정을 사용할 수 있습니다. 그러나 다음 연결은 여전히 외부 도메인의 호스트 이름을 사용합니다.

• mongod 에 연결할 MongoDB Agent입니다.

• mongod 을(를) 다른 mongod 인스턴스에 연결합니다.

경고: 이 필드 지정하면 MongoDB Ops Manager 가 mongod 프로세스를 등록하는 방식이 변경됩니다. Kubernetes Operator 버전 1.19 부터 시작하는 새 복제본 세트 배포에 대해서만 이 필드 를 지정할 수 있습니다. 실행 복제본 세트 배포서버 서버에 대한 MongoDB Ops Manager 자동화 구성 의 이 필드 또는 processes[n].hostname 필드 값은 변경할 수 없습니다.

spec.members

유형: integer

필수 사항입니다. 복제본 세트의 멤버 수입니다.

spec.memberConfig

유형: 컬렉션

MongoDB 리소스에서 배포된 각 MongoDB 복제본 집합 구성원에 대한 사양입니다.

배열의 요소 순서는 복제 세트의 멤버 순서를 반영해야 합니다. 예를 들어 배열의 첫 번째 요소는 인덱스 0 에 있는 Pod에 영향을 주고, 두 번째 요소는 인덱스 1에 영향을 미칩니다.

예시

3개의 멤버로 구성된 복제본 세트에 대한 다음 예시 사양을 살펴보겠습니다.

spec:
  memberConfig:
    - votes: 1
      priority: "0.5"
      tags:
        tag1: "value1"
        environment: "prod"
    - votes: 1
      priority: "1.5"
      tags:
        tag2: "value2"
        environment: "prod"
    - votes: 0
      priority: "0.5"
      tags:
        tag2: "value2"
        environment: "prod"

spec.memberConfig.priority

유형: 문자열

MongoDB 복제본 세트 멤버가 프라이머리가 될 상대적인 가능성을 나타내는 숫자입니다.

• 복제 세트 멤버가 프라이머리가 될 가능성을 상대적으로 높이려면 더 높은 priority 값을 지정합니다.

• 복제 세트 멤버가 기본 멤버가 될 가능성을 상대적으로 줄이려면 더 낮은 priority 값을 지정하세요.

예를 들어 memberConfig.priority가 1.5인 노드는 memberConfig.priority가 0.5인 노드보다 프라이머리 노드가 될 가능성이 큽니다.

memberConfig.priority 가 0 인 멤버는 프라이머리가 될 수 없습니다. 자세히 알아보려면 멤버 우선순위를 참조하세요.

spec.memberConfig.tags

유형: 매핑

읽기 및 쓰기 작업을 MongoDB 복제본 세트의 특정 멤버로 전달하기 위한 복제본 세트 태그의 맵입니다.

spec.memberConfig.votes

유형: 숫자

MongoDB 복제본 세트 멤버가 투표 할 수 있는지 여부를 결정합니다. 멤버가 투표할 수 있도록 하려면 1 로 설정합니다. 멤버를 투표에서 제외하려면 0 로 설정합니다.

다음 설정은 복제본 세트 리소스 유형에만 적용됩니다.

spec.backup.autoTerminateOnDeletion

유형: 부울

MongoDB 리소스를 삭제할 때 Kubernetes Operator가 백업을 중지하고 종료할지 여부를 제어하는 플래그입니다. 생략하면 기본값은 false 입니다. 이 플래그를 true 로 설정하면 spec.backup.mode 설정이 enabled 로 설정된 상태에서 MongoDB 사용자 지정 리소스를 삭제하려는 경우에 유용합니다.

샤딩된 클러스터 설정

다음 설정은 샤딩된 클러스터 리소스 유형에만 적용됩니다.

spec.backup.snapshotSchedule.clusterCheckpointIntervalMin

유형: 숫자

연속 클러스터 체크포인트 사이의 시간(분)입니다. 이 설정은 기능 호환성 버전 이 4.0 이하인 MongoDB 를 실행 하는 샤딩된 클러스터에만 적용됩니다. 이 숫자는 샤딩된 클러스터에 대한 특정 시점 복원의 세분성을 결정합니다. 15, 30 또는 60 의 값을 설정하다 수 있습니다.

spec.configServerCount

유형: integer

필수. config 서버의 멤버 수입니다.

spec.configSrv.additionalMongodConfig

유형: 컬렉션

각 config 서버 멤버를 시작하는 데 사용할 추가 구성 옵션 입니다.

Kubernetes Operator는 MongoDB Agent를 통해 배포하는 MongoDB 버전의 모든 구성 옵션을 지원합니다. 단, 사용자가 다음 옵션에 제공한 값은 Kubernetes Operator에 의해 재정의됩니다.

• net.tls.certificateKeyFile

• net.tls.clusterFile

• replication.replSetName

• security.clusterAuthMode

• sharding.clusterRole

• storage.dbPath

• systemLog.destination

• systemLog.path

Kubernetes Operator가 소유하는 구성 옵션에 대해 자세히 알아보려면 MongoDB Kubernetes Operator전용 설정을 참조하세요.

사용할 수 있는 구성 옵션에 대해 알아보려면 Ops 관리자 설명서에서 MongoDB 배포를 위한 고급 옵션을 참조하세요.

spec.configSrv.agent

유형: 컬렉션

각 config 서버 멤버에 대한 MongoDB Agent 구성 설정입니다.

spec.configSrv.agent.startupOptions

유형: 컬렉션

각 config 서버 멤버를 시작할 MongoDB Agent 설정입니다.

MongoDB Agent 설정을 키-값 쌍으로 제공해야 합니다. 값은 문자열이어야 합니다.

지원되는 MongoDB Agent 설정 목록은 다음을 참조하세요.

• Cloud Manager 프로젝트에 대한 MongoDB Agent 설정 .

• Operator와 함께 배포한 MongoDB Ops Manager 버전에 대한MongoDB Agent 설정 입니다. Kubernetes

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDB
4
metadata:
5
  name: my-sharded-cluster-options
6
spec:
7
  version: "6.0.0-ent"
8
  type: ShardedCluster
9
  opsManager:
10
    configMapRef:
11
      name: my-project
12
  credentials: my-credentials
13
  persistent: true
14
  shardCount: 2
15
  mongodsPerShardCount: 3
16
  mongosCount: 2
17
  configServerCount: 1
18
19
  mongos:
20
    agent:
21
      startupOptions:
22
        maxLogFiles: "30"
23
24
  configSrv:
25
     agent:
26
       startupOptions:
27
         dialTimeoutSeconds: "40"
28
  shard:
29
     agent:
30
       startupOptions:
31
         serverSelectionTimeoutSeconds: "20"
32
...

spec.configSrvPodSpec

유형: 객체

MongoDB CustomResourceDefinition 의 사양이 포함된 객체 config 서버 Pods.

spec.configSrvPodSpec.persistence.single

유형: 컬렉션

Kubernetes Operator가 하나의 퍼시스턴트 볼륨 클레임(Persistent Volume Claim, PVC)을 생성하고 데이터와 저널 및 로그에 대한 세 개의 디렉토리를 모두 동일한 퍼시스턴트 볼륨 마운트하도록 합니다.

참고

• spec.persistent : true 인 경우 이 컬렉션의 값을 설정해야 합니다.

• 이 컬렉션 또는 persistence.multiple 컬렉션을 설정할 수 있지만 둘 다 설정할 수는 없습니다.

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

spec.configSrvPodSpec.persistence.multiple.data

유형: 컬렉션

Kubernetes Operator가 영구 볼륨 클레임 을 생성하도록 설정 자체 영구 볼륨 에 데이터의 디렉토리를 마운트합니다. .

참고

• spec.persistent : true 인 경우 이 컬렉션의 값을 설정해야 합니다.

• 이 컬렉션 또는 persistence.single 컬렉션을 설정할 수 있지만 둘 다 설정할 수는 없습니다.

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

spec.configSrvPodSpec.persistence.multiple.journal

유형: 컬렉션

Kubernetes Operator가 영구 볼륨 클레임 을 생성하도록 설정 자체 영구 볼륨 에 저널용 디렉토리를 마운트합니다. .

참고

• spec.persistent : true 인 경우 이 컬렉션의 값을 설정해야 합니다.

• 이 컬렉션 또는 persistence.single 컬렉션을 설정할 수 있지만 둘 다 설정할 수는 없습니다.

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

spec.configSrvPodSpec.persistence.multiple.logs

유형: 컬렉션

Kubernetes Operator가 영구 볼륨 클레임 을 생성하도록 설정 자체 영구 볼륨 에 로그용 디렉토리를 마운트합니다. .

참고

• spec.persistent : true 인 경우 이 컬렉션의 값을 설정해야 합니다.

• 이 컬렉션 또는 persistence.single 컬렉션을 설정할 수 있지만 둘 다 설정할 수는 없습니다.

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

spec.configSrvPodSpec.podTemplate

유형: 컬렉션

템플릿 MongoDB Enterprise Kubernetes Operator가 각 config 서버 멤버에 대해 생성하는 Kubernetes Pods에 대한

템플릿 값은 spec.configSrvPodSpec에 지정된 값보다 우선합니다.

참고

Kubernetes Operator가 spec.configSrvPodSpec.podTemplate에 제공한 필드의 유효성을 검사하지 않습니다.

spec.configSrvPodSpec.podTemplate.affinity.podAffinity

유형: 컬렉션

Kubernetes 규칙 여러 MongoDB 리소스 파드 가 다른 Pod 와 함께 위치해야 합니다. . 사용 사례에 대해 자세히 알아보려면 선호도 및 반 선호도 를 참조하세요. Kubernetes 문서에서 확인 가능합니다.

spec.configSrvPodSpec.podTemplate.affinity.nodeAffinity

유형: 컬렉션

Kubernetes 규칙 Pods 배치 특정 범위의 노드 에 있는 복제본 세트 의 경우 .

읽기-쓰기 성능을 최적화하려면 Pods 를 제한하는 노드 어피니티 규칙을 사용하세요. 특정 노드 에서 실행 또는 특정 노드 에서 실행하는 것을 선호합니다. .

spec.configSrvPodSpec.podTemplate.affinity.podAntiAffinity

유형: 문자열

Default: kubernetes.io/hostname

규칙 설정 Pods 확산 MongoDB 리소스를 다른 위치에 호스팅합니다. 위치는 단일 노드, 랙 또는 리전일 수 있습니다. 기본적으로 Kubernetes Operator는 여러 노드에 파드를 분산하려고 시도합니다.

spec.configSrvPodSpec.podTemplate.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.topologyKey

유형: 문자열

Default: kubernetes.io/hostname

이 키는 다음 레이블 을 정의합니다. 토폴로지 도메인 을 결정하는 데 사용됩니다. 노드가 속합니다.

spec.configSrvPodSpec.podTemplate.metadata

유형: 컬렉션

MongoDB Enterprise Kubernetes Operator가 각 config 서버 멤버에 대해 생성하는 Kubernetes Pods의 메타데이터입니다.

에추가할 수 있는 필드를 검토하려면 spec.configSrvPodSpec.podTemplate.metadata Kubernetes 설명서를 참조하세요.

spec.configSrvPodSpec.podTemplate.spec

유형: 컬렉션

각 config 서버 멤버에 대해 MongoDB Enterprise Kubernetes Operator 운영자가 생성하는 Kubernetes Pods의 사양입니다.

에 추가할 수 spec.configSrvPodSpec.podTemplate.spec Kubernetes 있는 필드를1 Core API 검토하려면 PodSpec v 를 참조하세요.

참고

spec.configSrvPodSpec.podTemplate.spec.containers 에 컨테이너를 추가하면 Kubernetes Operator가 컨테이너를 Kubernetes pod에 추가합니다. 이러한 컨테이너는 pod의 각 config 서버 멤버 컨테이너에 추가됩니다.

이 설정을 사용하여 각 포드에 대한 CPU 및 RAM 할당을 지정합니다. 예제 는 의 샘플을 Github 참조하세요.

spec.mongodsPerShardCount

유형: integer

필수. 샤드당 멤버 수입니다.

spec.mongosCount

유형: integer

필수. mongos 샤드 클러스터 의 인스턴스 수입니다.

spec.mongos.additionalMongodConfig

유형: 컬렉션

각 mongos 인스턴스를 시작하는 데 사용할 추가 구성 옵션 입니다.

Kubernetes Operator는 MongoDB Agent를 통해 배포하는 MongoDB 버전의 모든 구성 옵션을 지원합니다. 단, 사용자가 다음 옵션에 제공한 값은 Kubernetes Operator에 의해 재정의됩니다.

• net.tls.certificateKeyFile

• net.tls.clusterFile

• replication.replSetName

• security.clusterAuthMode

• sharding.clusterRole

• storage.dbPath

• systemLog.destination

• systemLog.path

Kubernetes Operator가 소유하는 구성 옵션에 대해 자세히 알아보려면 MongoDB Kubernetes Operator전용 설정을 참조하세요.

사용할 수 있는 구성 옵션에 대해 알아보려면 Ops 관리자 설명서에서 MongoDB 배포를 위한 고급 옵션을 참조하세요.

spec.mongos.agent

유형: 컬렉션

각 mongos 인스턴스에 대한 MongoDB Agent 구성 설정입니다.

spec.mongos.agent.startupOptions

유형: 컬렉션

각 mongos 인스턴스를 시작하는 데 사용할 MongoDB Agent 설정입니다.

MongoDB Agent 설정을 키-값 쌍으로 제공해야 합니다. 값은 문자열이어야 합니다.

지원되는 MongoDB Agent 설정 목록은 다음을 참조하세요.

• Cloud Manager 프로젝트에 대한 MongoDB Agent 설정 .

• Operator와 함께 배포한 MongoDB Ops Manager 버전에 대한MongoDB Agent 설정 입니다. Kubernetes

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDB
4
metadata:
5
  name: my-sharded-cluster-options
6
spec:
7
  version: "6.0.0-ent"
8
  type: ShardedCluster
9
  opsManager:
10
    configMapRef:
11
      name: my-project
12
  credentials: my-credentials
13
  persistent: true
14
  shardCount: 2
15
  mongodsPerShardCount: 3
16
  mongosCount: 2
17
  configServerCount: 1
18
19
  mongos:
20
    agent:
21
      startupOptions:
22
        maxLogFiles: "30"
23
24
  configSrv:
25
     agent:
26
       startupOptions:
27
         dialTimeoutSeconds: "40"
28
  shard:
29
     agent:
30
       startupOptions:
31
         serverSelectionTimeoutSeconds: "20"
32
...

spec.mongosPodSpec

유형: 객체

MongoDB CustomResourceDefinition 의 사양이 포함된 객체 mongos Pods.

spec.mongosPodSpec.podTemplate

유형: 컬렉션

템플릿 MongoDB Enterprise Kubernetes Operator가 각 인스턴스에 대해 생성하는 mongos Kubernetes Pods에 대한

템플릿 값은 spec.mongosPodSpec에 지정된 값보다 우선합니다.

참고

Kubernetes Operator가 spec.mongosPodSpec.podTemplate에 제공한 필드의 유효성을 검사하지 않습니다.

spec.mongosPodSpec.podTemplate.affinity.podAffinity

유형: 컬렉션

선택 사항. Kubernetes 규칙 여러 MongoDB 리소스 파드 가 다른 Pod 와 함께 위치해야 합니다. .

spec.mongosPodSpec.podTemplate.affinity.nodeAffinity

유형: 컬렉션

Kubernetes 규칙 Pods 배치 특정 범위의 노드 에 있는 복제본 세트 의 경우 .

읽기-쓰기 성능을 최적화하려면 Pods 를 제한하는 노드 어피니티 규칙을 사용하세요. 특정 노드 에서 실행 또는 특정 노드 에서 실행하는 것을 선호합니다. .

spec.mongosPodSpec.podTemplate.affinity.podAntiAffinity

유형: 문자열

Default: kubernetes.io/hostname

규칙 설정 Pods 확산 MongoDB 리소스를 다른 위치에 호스팅합니다. 위치는 단일 노드, 랙 또는 리전일 수 있습니다. 기본적으로 Kubernetes Operator는 여러 노드에 파드를 분산하려고 시도합니다.

spec.mongosPodSpec.podTemplate.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.topologyKey

유형: 문자열

Default: kubernetes.io/hostname

이 키는 다음 레이블 을 정의합니다. 토폴로지 도메인 을 결정하는 데 사용됩니다. 노드가 속합니다.

spec.mongosPodSpec.podTemplate.metadata

유형: 컬렉션

MongoDB Enterprise Kubernetes Operator가 각 mongos 인스턴스에 대해 생성하는 Kubernetes 파드의 메타데이터입니다.

에추가할 수 있는 필드를 검토하려면 spec.mongosPodSpec.podTemplate.metadata Kubernetes 설명서를 참조하세요.

spec.mongosPodSpec.podTemplate.spec

유형: 컬렉션

MongoDB Enterprise Kubernetes Operator가 각 mongos 인스턴스에 대해 생성하는 Kubernetes 파드의 사양입니다.

에 추가할 수 spec.mongosPodSpec.podTemplate.spec Kubernetes 있는 필드를1 Core API 검토하려면 PodSpec v 를 참조하세요.

참고

spec.mongosPodSpec.podTemplate.spec.containers 에 컨테이너를 추가하면 Kubernetes Operator가 컨테이너를 Kubernetes pod에 추가합니다. 이러한 컨테이너는 파드의 각 mongos 인스턴스 컨테이너에 추가됩니다.

이 설정을 사용하여 각 포드에 대한 CPU 및 RAM 할당을 지정합니다. 예제 는 의 샘플을 Github 참조하세요.

spec.shardCount

유형: integer

필수. 샤드 클러스터의 샤드 수입니다.

spec.shard.additionalMongodConfig

유형: 컬렉션

각 샤드 클러스터 샤드 멤버를 시작하는 데 사용할 추가 구성 옵션 입니다.

Kubernetes Operator는 MongoDB Agent를 통해 배포하는 MongoDB 버전의 모든 구성 옵션을 지원합니다. 단, 사용자가 다음 옵션에 제공한 값은 Kubernetes Operator에 의해 재정의됩니다.

• net.tls.certificateKeyFile

• net.tls.clusterFile

• replication.replSetName

• security.clusterAuthMode

• sharding.clusterRole

• storage.dbPath

• systemLog.destination

• systemLog.path

Kubernetes Operator가 소유하는 구성 옵션에 대해 자세히 알아보려면 MongoDB Kubernetes Operator전용 설정을 참조하세요.

사용할 수 있는 구성 옵션에 대해 알아보려면 Ops 관리자 설명서에서 MongoDB 배포를 위한 고급 옵션을 참조하세요.

spec.shard.agent

유형: 컬렉션

각 샤딩된 클러스터 샤드 구성원에 대한 MongoDB Agent 구성 설정입니다.

spec.shard.agent.startupOptions

유형: 컬렉션

각 샤딩된 클러스터 샤드 구성원을 시작할 MongoDB Agent 설정입니다.

MongoDB Agent 설정을 키-값 쌍으로 제공해야 합니다. 값은 문자열이어야 합니다.

지원되는 MongoDB Agent 설정 목록은 다음을 참조하세요.

• Cloud Manager 프로젝트에 대한 MongoDB Agent 설정 .

• Operator와 함께 배포한 MongoDB Ops Manager 버전에 대한MongoDB Agent 설정 입니다. Kubernetes

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDB
4
metadata:
5
  name: my-sharded-cluster-options
6
spec:
7
  version: "6.0.0-ent"
8
  type: ShardedCluster
9
  opsManager:
10
    configMapRef:
11
      name: my-project
12
  credentials: my-credentials
13
  persistent: true
14
  shardCount: 2
15
  mongodsPerShardCount: 3
16
  mongosCount: 2
17
  configServerCount: 1
18
19
  mongos:
20
    agent:
21
      startupOptions:
22
        maxLogFiles: "30"
23
24
  configSrv:
25
     agent:
26
       startupOptions:
27
         dialTimeoutSeconds: "40"
28
  shard:
29
     agent:
30
       startupOptions:
31
         serverSelectionTimeoutSeconds: "20"
32
...

spec.shardPodSpec

유형: 객체

MongoDB CustomResourceDefinition 의 사양이 포함된 객체 샤드 Pods.

spec.shardPodSpec.persistence.multiple.data

유형: 컬렉션

Kubernetes Operator가 영구 볼륨 클레임 을 생성하도록 설정 자체 영구 볼륨 에 데이터의 디렉토리를 마운트합니다. .

참고

• spec.persistent : true 인 경우 이 컬렉션의 값을 설정해야 합니다.

• 이 컬렉션 또는 persistence.single 컬렉션을 설정할 수 있지만 둘 다 설정할 수는 없습니다.

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

spec.shardPodSpec.persistence.multiple.journal

유형: 컬렉션

Kubernetes Operator가 영구 볼륨 클레임 을 생성하도록 설정 자체 영구 볼륨 에 저널용 디렉토리를 마운트합니다. .

참고

• spec.persistent : true 인 경우 이 컬렉션의 값을 설정해야 합니다.

• 이 컬렉션 또는 persistence.single 컬렉션을 설정할 수 있지만 둘 다 설정할 수는 없습니다.

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

spec.shardPodSpec.persistence.multiple.logs

유형: 컬렉션

Kubernetes Operator가 영구 볼륨 클레임 을 생성하도록 설정 자체 영구 볼륨 에 로그용 디렉토리를 마운트합니다. .

참고

• spec.persistent : true 인 경우 이 컬렉션의 값을 설정해야 합니다.

• 이 컬렉션 또는 persistence.single 컬렉션을 설정할 수 있지만 둘 다 설정할 수는 없습니다.

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

spec.shardPodSpec.podTemplate

유형: 컬렉션

템플릿 MongoDB Enterprise Kubernetes Operator가 각 샤드 클러스터 샤드 멤버에 대해 생성하는 Kubernetes Pods에 대한

템플릿 값은 spec.shardPodSpec에 지정된 값보다 우선합니다.

참고

Kubernetes Operator가 spec.shardPodSpec.podTemplate에 제공한 필드의 유효성을 검사하지 않습니다.

spec.shardPodSpec.podTemplate.affinity.podAffinity

유형: 문자열

Kubernetes 규칙 여러 MongoDB 리소스 파드 가 다른 Pod 와 함께 위치해야 합니다. . 사용 사례에 대해 자세히 알아보려면 선호도 및 반 선호도 를 참조하세요. Kubernetes 문서에서 확인 가능합니다.

spec.shardPodSpec.podTemplate.affinity.nodeAffinity

유형: 문자열

Kubernetes 규칙 Pods 배치 특정 범위의 노드 에 있는 복제본 세트 의 경우 .

읽기-쓰기 성능을 최적화하려면 Pods 를 제한하는 노드 어피니티 규칙을 사용하세요. 특정 노드 에서 실행 또는 특정 노드 에서 실행하는 것을 선호합니다. .

spec.shardPodSpec.podTemplate.affinity.podAntiAffinity

유형: 문자열

Default: kubernetes.io/hostname

규칙 설정 Pods 확산 MongoDB 리소스를 다른 위치에 호스팅합니다. 위치는 단일 노드, 랙 또는 리전일 수 있습니다. 기본적으로 Kubernetes Operator는 여러 노드에 파드를 분산하려고 시도합니다.

spec.shardPodSpec.podTemplate.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.topologyKey

유형: 문자열

Default: kubernetes.io/hostname

이 키는 다음 레이블 을 정의합니다. 토폴로지 도메인 을 결정하는 데 사용됩니다. 노드가 속합니다.

spec.shardPodSpec.podTemplate.metadata

유형: 컬렉션

MongoDB Enterprise Kubernetes Operator가 각 샤딩된 클러스터 샤드 멤버에 대해 생성하는 Kubernetes Pod의 메타데이터입니다.

에추가할 수 있는 필드를 검토하려면 spec.shardPodSpec.podTemplate.metadata Kubernetes 설명서를 참조하세요.

spec.shardPodSpec.podTemplate.spec

유형: 컬렉션

MongoDB Enterprise Kubernetes Operator가 각 샤딩된 클러스터 노드에 대해 생성하는 Kubernetes 파드의 설명서입니다.

에 추가할 수 spec.shardPodSpec.podTemplate.spec Kubernetes 있는 필드를1 Core API 검토하려면 PodSpec v 를 참조하세요.

참고

spec.shardPodSpec.podTemplate.spec.containers에 컨테이너를 추가하면 Kubernetes Operator가 컨테이너를 Kubernetes pod에 추가합니다. 이러한 컨테이너는 파드의 각 샤딩된 클러스터 샤드 멤버 컨테이너에 추가됩니다.

이 설정을 사용하여 각 포드에 대한 CPU 및 RAM 할당을 지정합니다. 예제 는 의 샘플을 Github 참조하세요.

spec.shardSpecificPodSpec

유형: 배열

샤드별로 StatefulSet에 대한 재정의 항목을 포함하는 목록입니다.

spec.shardSpecificPodSpec.podTemplate

유형: 컬렉션

템플릿 MongoDB Enterprise Kubernetes Operator가 특정 샤드에 대해 생성하는 Kubernetes Pods에 대한

템플릿 값은 spec.shardSpecificPodSpec에 지정된 값보다 우선합니다.

참고

Kubernetes Operator가 spec.shardSpecificPodSpec.podTemplate에 제공한 필드의 유효성을 검사하지 않습니다.

spec.shardSpecificPodSpec.podTemplate.affinity.podAffinity

유형: 문자열

Kubernetes 규칙 여러 MongoDB 리소스 파드 가 다른 Pod 와 함께 위치해야 합니다. . 사용 사례에 대해 자세히 알아보려면 선호도 및 반 선호도 를 참조하세요. Kubernetes 문서에서 확인 가능합니다.

spec.shardSpecificPodSpec.podTemplate.affinity.podAntiAffinity

유형: 문자열

Default: kubernetes.io/hostname

규칙 설정 Pods 확산 MongoDB 리소스를 다른 위치에 호스팅합니다. 위치는 단일 노드, 랙 또는 리전일 수 있습니다. 기본적으로 Kubernetes Operator는 여러 노드에 파드를 분산하려고 시도합니다.

spec.shardSpecificPodSpec.podTemplate.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution.topologyKey

유형: 문자열

Default: kubernetes.io/hostname

이 키는 다음 레이블 을 정의합니다. 토폴로지 도메인 을 결정하는 데 사용됩니다. 노드가 속합니다.

spec.shardSpecificPodSpec.podTemplate.metadata

유형: 컬렉션

MongoDB Enterprise Kubernetes Operator가 특정 샤드에 대해 생성하는 Kubernetes Pods의 메타데이터입니다.

에추가할 수 있는 필드를 검토하려면 spec.shardSpecificPodSpec.podTemplate.metadata Kubernetes 설명서를 참조하세요.

spec.shardSpecificPodSpec.podTemplate.spec

유형: 컬렉션

MongoDB Enterprise Kubernetes Operator가 특정 샤드에 대해 생성하는 Kubernetes 파드의 사양입니다.

에 추가할 수 spec.shardSpecificPodSpec.podTemplate.spec Kubernetes 있는 필드를1 Core API 검토하려면 PodSpec v 를 참조하세요.

참고

spec.shardSpecificPodSpec.podTemplate.spec.containers에 컨테이너를 추가하면 Kubernetes Operator가 컨테이너를 Kubernetes pod에 추가합니다. 이러한 컨테이너는 pod의 특정 샤드 컨테이너에 추가됩니다.

이 설정을 사용하여 각 포드에 대한 CPU 및 RAM 할당을 지정합니다. 예제 는 의 샘플을 Github 참조하세요.

spec.topology

유형: 문자열

옵션

기본값: SingleCluster

샤딩된 클러스터 의 토폴로지 를 정의합니다. 기존 배포서버 서버에 대해서는 변경할 수 없습니다. MultiCluster 로 설정하다 경우:

• 모든 샤딩된 클러스터 구성 요소에는 clusterSpecList 이(가) 정의되어 있어야 합니다: - spec.mongos.clusterSpecList - spec.configSrv.clusterSpecList - spec.shard.clusterSpecList

• 다음 필드는 spec.<section>.clusterSpecList 객체의 각 클러스터 에 대해 동등한 값이 전달되므로 무시됩니다. - spec.mongodsPerShardCount 는 spec.shard.clusterSpecList.members 에 정의되어 있습니다. - spec.mongosCount 는 spec.mongos.clusterSpecList.members 에 정의되어 있습니다. - spec.configServerCount 는 spec.configSrv.clusterSpecList.members 0}에 정의되어 있습니다. - spec.shardOverrides.memberConfig 은 spec.shardOverrides.clusterSpecList.memberConfig 에 정의되어 있음 - spec.shardOverrides.members 는 spec.shardOverrides.clusterSpecList.members 에 정의되어 있음 - spec.shardOverrides.statefulSet 은 spec.shardOverrides.clusterSpecList.statefulSet에 정의되어 있음

예시:

apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: sc
spec:
  shardCount: 3
  # we don't specify mongodsPerShardCount, mongosCount and configServerCount as they don't make sense for multi-cluster
  topology: MultiCluster
  type: ShardedCluster
  version: 7.0.12
  cloudManager:
    configMapRef:
      name: my-project
  credentials: my-credentials
  persistent: true
  shard:
    clusterSpecList:
      - clusterName: member-cluster-0
        members: 2 # each shard will have 2 members in cluster 0, unless overriden
      - clusterName: member-cluster-1
        members: 2
      - clusterName: member-cluster-2
        members: 1
  shardOverrides:
    - shardNames: [sc-2] # this override will apply to the third shard (here, shards are indexed from 0 to 2 as we have 3 shards)
      clusterSpecList:
        - clusterName: member-cluster-0 # all other fields are optional, if not provided the fields from matching member cluster from shard.clusterSpecList will be taken by default
          members: 3
        - clusterName: member-cluster-1 # we don't deploy this shard to member-cluster-1
          # Note that it is also possible to make it explicit with members: 0
        # we don't provide entry for clusterName: member-cluster-1, so it won't be deployed there
        - clusterName: member-cluster-2
          members: 2
  configSrv:
    clusterSpecList:
      - clusterName: member-cluster-0
        members: 2 # config server will have 2 members in this cluster
      - clusterName: member-cluster-1
        members: 1
      - clusterName: member-cluster-2
        members: 2
  mongos:
    clusterSpecList:
      - clusterName: member-cluster-0
        members: 2 # router will have 2 members in this cluster
      - clusterName: member-cluster-1
        members: 1

다음 필드는 topology=MultiCluster 인 배포에만 독점적으로 관련됩니다.

spec.configSrv.clusterSpecList

참고

이 필드 는 현재 공개 미리 보기로 제공되는 멀티 클러스터 샤딩된 클러스터 배포에만 사용할 수 있습니다.

유형: 객체 배열

topology=MultiCluster인 경우 필수

다음과 같은 최상위 필드가 있는 멀티 클러스터 샤딩된 클러스터 배포에 사용할 객체 배열 입니다.

clusterName

유형: 문자열

가 StatefulSet 를 예약하는 클러스터 의 이름 .MongoDB Enterprise Kubernetes Operator

externalAccess

유형: 컬렉션

외부 연결을 위해 다중 Kubernetes 클러스터 MongoDB deployment 를 노출하는 사양입니다. Kubernetes 클러스터 외부에서 멀티-Kubernetes 클러스터 MongoDB deployment 에 연결하는 방법을 학습 보려면 Kubernetes 외부 Kubernetes 멀티-클러스터 리소스에 연결하기를 참조하세요.

이러한 설정은 모든 클러스터의 서비스에 적용 됩니다. 특정 클러스터 에서 이러한 전역 설정을 재정의하려면 spec.clusterSpecList.externalAccess.externalService를 사용합니다.

spec.externalAccess 추가하면 Kubernetes Operator가 복제본 세트의 각 파드에 대한 외부 서비스를 생성합니다. 외부 서비스는 클러스터의 각 MongoDB database 파드에 대한 외부 진입점을 제공합니다. 각 외부 서비스에는 선택기 가 있습니다. 외부 서비스를 특정 Pod와 일치시킵니다.

이 설정을 값없이 추가하면 Kubernetes Operator는 다음과 같은 기본값을 사용하여 외부 서비스를 생성합니다.

필드	값	설명
Name	<pod-name>-svc-external	외부 서비스의 이름입니다. 이 값은 변경할 수 없습니다.
Type	LoadBalancer	외부 LoadBalancer 서비스를 생성합니다.
Port	<Port Number>	mongod 에 대한 포트입니다.
publishNotReadyAddress	true	DNS 레코드 가 파드가 준비되지 않은 경우에도 생성됩니다. 데이터베이스 Pod에 대해 false 로 설정하지 마세요.

참고

spec.clusterSpecList.externalAccess.externalDomain 을 설정하다 하면 외부 서비스가 백업을 위해 다른 포트(Port Number + 1)를 추가합니다.

members

유형: 숫자

MongoDB 복제본 세트의 멤버 수입니다.

memberConfig

유형: 컬렉션

다중 Kubernetes 클러스터 MongoDB deployment 의 각 MongoDB 샤드 및 해당 멤버에 대한 사양입니다.

샤드 객체 의 요소 순서는 복제본 세트 의 멤버 순서를 반영해야 합니다. 예를 예시 첫 번째 요소는 인덱스 0 에서 Pod에 영향을 주고, 두 번째 요소는 인덱스 1 에 영향을 줍니다.

예시

3개의 복제본 세트가 있는 다중 Kubernetes 클러스터 MongoDB 배포에 대한 다음 예시 사양을 고려하세요.

apiVersion: mongodb.com/v1
kind: MongoDBMultiCluster
metadata:
  name: multi-replica-set
spec:
  version: 6.0.0-ent
  type: ReplicaSet
  duplicateServiceObjects: false
  credentials: my-credentials
  opsManager:
    configMapRef:
      name: my-project
  clusterSpecList:
    - clusterName: cluster1.example.com
      members: 2
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"
          - votes: 1
            priority: "1.5"
            tags:
                  tag2: "value2"
                  environment: "prod"
    - clusterName: cluster2.example.com
      members: 1
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"
    - clusterName: cluster3.example.com
      members: 1
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"

podSpec.persistence

유형: 컬렉션

spec.configSrv.clusterSpecList 및 spec.shard.clusterSpecList 에 전달된 clusterSpecItem 객체에서만 사용할 수 있습니다. 지정된 클러스터 에 대한 기존 지속성 구성을 재정의합니다.

statefulSet

유형: 컬렉션

StatefulSet 에 대한 구성을 제공합니다. 다중 Kubernetes 클러스터 MongoDB deployment 에서 클러스터의 각 StatefulSet에 대해 재정의합니다. 다중 Kubernetes 클러스터 MongoDB deployment 의 모든 클러스터에 적용되는 글로벌 구성을 설정하다 하려면 spec.statefulSet.spec을 참조하세요.

이 설정은 다중 Kubernetes 클러스터 MongoDB 배포의 복제본 세트 리소스 유형에만 적용됩니다.

spec.duplicateServiceObjects

참고

이 필드 는 현재 공개 미리 보기로 제공되는 멀티 클러스터 샤딩된 클러스터 배포에만 사용할 수 있습니다.

유형: 부울

옵션

기본값: true

토폴로지 가 MultiCluster 이(가) 아닌 경우 무시됩니다. 모든 샤딩된 클러스터 구성 요소에 대한 서비스에 적용됩니다: mongos, configSrv 및 shards.

true 로 설정하다 경우:

Kubernetes Operator는 각 멤버 클러스터 의 모든 멤버 cluster에서 모든 Pod Services 을(를) 생성합니다.

false 로 설정하다 경우:

Kubernetes Operator는 다음 항목만 생성합니다.

spec.mongos.clusterSpecList

참고

이 필드 는 현재 공개 미리 보기로 제공되는 멀티 클러스터 샤딩된 클러스터 배포에만 사용할 수 있습니다.

유형: 객체 배열

topology=MultiCluster인 경우 필수

다음과 같은 최상위 필드가 있는 멀티 클러스터 샤딩된 클러스터 배포에 사용할 객체 배열 입니다.

clusterName

유형: 문자열

가 StatefulSet 를 예약하는 클러스터 의 이름 .MongoDB Enterprise Kubernetes Operator

externalAccess

유형: 컬렉션

외부 연결을 위해 다중 Kubernetes 클러스터 MongoDB deployment 를 노출하는 사양입니다. Kubernetes 클러스터 외부에서 멀티-Kubernetes 클러스터 MongoDB deployment 에 연결하는 방법을 학습 보려면 Kubernetes 외부 Kubernetes 멀티-클러스터 리소스에 연결하기를 참조하세요.

이러한 설정은 모든 클러스터의 서비스에 적용 됩니다. 특정 클러스터 에서 이러한 전역 설정을 재정의하려면 spec.clusterSpecList.externalAccess.externalService를 사용합니다.

spec.externalAccess 추가하면 Kubernetes Operator가 복제본 세트의 각 파드에 대한 외부 서비스를 생성합니다. 외부 서비스는 클러스터의 각 MongoDB database 파드에 대한 외부 진입점을 제공합니다. 각 외부 서비스에는 선택기 가 있습니다. 외부 서비스를 특정 Pod와 일치시킵니다.

이 설정을 값없이 추가하면 Kubernetes Operator는 다음과 같은 기본값을 사용하여 외부 서비스를 생성합니다.

필드	값	설명
Name	<pod-name>-svc-external	외부 서비스의 이름입니다. 이 값은 변경할 수 없습니다.
Type	LoadBalancer	외부 LoadBalancer 서비스를 생성합니다.
Port	<Port Number>	mongod 에 대한 포트입니다.
publishNotReadyAddress	true	DNS 레코드 가 파드가 준비되지 않은 경우에도 생성됩니다. 데이터베이스 Pod에 대해 false 로 설정하지 마세요.

참고

spec.clusterSpecList.externalAccess.externalDomain 을 설정하다 하면 외부 서비스가 백업을 위해 다른 포트(Port Number + 1)를 추가합니다.

members

유형: 숫자

MongoDB 복제본 세트의 멤버 수입니다.

memberConfig

유형: 컬렉션

다중 Kubernetes 클러스터 MongoDB deployment 의 각 MongoDB 샤드 및 해당 멤버에 대한 사양입니다.

샤드 객체 의 요소 순서는 복제본 세트 의 멤버 순서를 반영해야 합니다. 예를 예시 첫 번째 요소는 인덱스 0 에서 Pod에 영향을 주고, 두 번째 요소는 인덱스 1 에 영향을 줍니다.

예시

3개의 복제본 세트가 있는 다중 Kubernetes 클러스터 MongoDB 배포에 대한 다음 예시 사양을 고려하세요.

apiVersion: mongodb.com/v1
kind: MongoDBMultiCluster
metadata:
  name: multi-replica-set
spec:
  version: 6.0.0-ent
  type: ReplicaSet
  duplicateServiceObjects: false
  credentials: my-credentials
  opsManager:
    configMapRef:
      name: my-project
  clusterSpecList:
    - clusterName: cluster1.example.com
      members: 2
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"
          - votes: 1
            priority: "1.5"
            tags:
                  tag2: "value2"
                  environment: "prod"
    - clusterName: cluster2.example.com
      members: 1
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"
    - clusterName: cluster3.example.com
      members: 1
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"

statefulSet

유형: 컬렉션

StatefulSet 에 대한 구성을 제공합니다. 다중 Kubernetes 클러스터 MongoDB deployment 에서 클러스터의 각 StatefulSet에 대해 재정의합니다. 다중 Kubernetes 클러스터 MongoDB deployment 의 모든 클러스터에 적용되는 글로벌 구성을 설정하다 하려면 spec.statefulSet.spec을 참조하세요.

이 설정은 다중 Kubernetes 클러스터 MongoDB 배포의 복제본 세트 리소스 유형에만 적용됩니다.

spec.shard.clusterSpecList

참고

이 필드 는 현재 공개 미리 보기로 제공되는 멀티 클러스터 샤딩된 클러스터 배포에만 사용할 수 있습니다.

유형: 객체 배열

topology=MultiCluster인 경우 필수

다음과 같은 최상위 필드가 있는 멀티 클러스터 샤딩된 클러스터 배포에 사용할 객체 배열 입니다.

clusterName

유형: 문자열

가 StatefulSet 를 예약하는 클러스터 의 이름 .MongoDB Enterprise Kubernetes Operator

externalAccess

유형: 컬렉션

외부 연결을 위해 다중 Kubernetes 클러스터 MongoDB deployment 를 노출하는 사양입니다. Kubernetes 클러스터 외부에서 멀티-Kubernetes 클러스터 MongoDB deployment 에 연결하는 방법을 학습 보려면 Kubernetes 외부 Kubernetes 멀티-클러스터 리소스에 연결하기를 참조하세요.

이러한 설정은 모든 클러스터의 서비스에 적용 됩니다. 특정 클러스터 에서 이러한 전역 설정을 재정의하려면 spec.clusterSpecList.externalAccess.externalService를 사용합니다.

spec.externalAccess 추가하면 Kubernetes Operator가 복제본 세트의 각 파드에 대한 외부 서비스를 생성합니다. 외부 서비스는 클러스터의 각 MongoDB database 파드에 대한 외부 진입점을 제공합니다. 각 외부 서비스에는 선택기 가 있습니다. 외부 서비스를 특정 Pod와 일치시킵니다.

이 설정을 값없이 추가하면 Kubernetes Operator는 다음과 같은 기본값을 사용하여 외부 서비스를 생성합니다.

필드	값	설명
Name	<pod-name>-svc-external	외부 서비스의 이름입니다. 이 값은 변경할 수 없습니다.
Type	LoadBalancer	외부 LoadBalancer 서비스를 생성합니다.
Port	<Port Number>	mongod 에 대한 포트입니다.
publishNotReadyAddress	true	DNS 레코드 가 파드가 준비되지 않은 경우에도 생성됩니다. 데이터베이스 Pod에 대해 false 로 설정하지 마세요.

참고

spec.clusterSpecList.externalAccess.externalDomain 을 설정하다 하면 외부 서비스가 백업을 위해 다른 포트(Port Number + 1)를 추가합니다.

members

유형: 숫자

MongoDB 복제본 세트의 멤버 수입니다.

memberConfig

유형: 컬렉션

다중 Kubernetes 클러스터 MongoDB deployment 의 각 MongoDB 샤드 및 해당 멤버에 대한 사양입니다.

샤드 객체 의 요소 순서는 복제본 세트 의 멤버 순서를 반영해야 합니다. 예를 예시 첫 번째 요소는 인덱스 0 에서 Pod에 영향을 주고, 두 번째 요소는 인덱스 1 에 영향을 줍니다.

예시

3개의 복제본 세트가 있는 다중 Kubernetes 클러스터 MongoDB 배포에 대한 다음 예시 사양을 고려하세요.

apiVersion: mongodb.com/v1
kind: MongoDBMultiCluster
metadata:
  name: multi-replica-set
spec:
  version: 6.0.0-ent
  type: ReplicaSet
  duplicateServiceObjects: false
  credentials: my-credentials
  opsManager:
    configMapRef:
      name: my-project
  clusterSpecList:
    - clusterName: cluster1.example.com
      members: 2
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"
          - votes: 1
            priority: "1.5"
            tags:
                  tag2: "value2"
                  environment: "prod"
    - clusterName: cluster2.example.com
      members: 1
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"
    - clusterName: cluster3.example.com
      members: 1
      memberConfig:
          - votes: 1
            priority: "0.5"
            tags:
                tag1: "value1"
                environment: "prod"

podSpec.persistence

유형: 컬렉션

spec.configSrv.clusterSpecList 및 spec.shard.clusterSpecList 에 전달된 clusterSpecItem 객체에서만 사용할 수 있습니다. 지정된 클러스터 에 대한 기존 지속성 구성을 재정의합니다.

statefulSet

유형: 컬렉션

StatefulSet 에 대한 구성을 제공합니다. 다중 Kubernetes 클러스터 MongoDB deployment 에서 클러스터의 각 StatefulSet에 대해 재정의합니다. 다중 Kubernetes 클러스터 MongoDB deployment 의 모든 클러스터에 적용되는 글로벌 구성을 설정하다 하려면 spec.statefulSet.spec을 참조하세요.

이 설정은 다중 Kubernetes 클러스터 MongoDB 배포의 복제본 세트 리소스 유형에만 적용됩니다.

spec.shardOverrides

참고

이 필드 는 현재 공개 미리 보기로 제공되는 멀티 클러스터 샤딩된 클러스터 배포에만 사용할 수 있습니다.

유형: 객체 배열

옵션

샤드 당 재정의가 포함된 목록입니다. 각 객체 에는 다음 필드가 포함되어 있습니다.

• shardNames

  필수 사항

  이 재정의가 적용되는 샤드 의 이름입니다.

• podSpec.Persistence

  옵션

  Kubernetes Operator가 영구 볼륨을 생성하고 샤드에 바인딩하는 방법을 정의합니다. topology=MultiCluster 의 경우 모든 구성원 클러스터에 대한 지속성 설정을 설정합니다. spec.shardOverrides.clusterSpecList.persistence 에서 특정 멤버 클러스터 에 대한 지속성 설정을 정의할 수 있습니다.

• additionalMongodConfig

  옵션

  spec.shard.additionalMongodConfig 에 대한 샤드별 재정의입니다.

• agent

  옵션

  spec.shard.agent 에 대한 샤드별 재정의입니다.

• statefulSet

  옵션

  spec.shardPodSpec.podTemplate 및 spec.shard.clusterSpecList.statefulSet 에 대한 샤드별 재정의입니다.

• members

  옵션

  topology=SingleCluster 경우에만 사용할 수 있습니다. spec.mongodsPerShardCount 에 대한 재정의를 위한 샤드별 재정의입니다.

• memberConfig

  옵션

  topology=SingleCluster 경우에만 사용할 수 있습니다. spec.shard.memberConfig 에 대한 샤드별 재정의입니다.

spec.shardPodSpec.persistence.single

유형: 컬렉션

Kubernetes Operator가 하나의 퍼시스턴트 볼륨 클레임(Persistent Volume Claim, PVC)을 생성하고 데이터와 저널 및 로그에 대한 세 개의 디렉토리를 모두 동일한 퍼시스턴트 볼륨 마운트하도록 합니다.

참고

• spec.persistent : true 인 경우 이 컬렉션의 값을 설정해야 합니다.

• 이 컬렉션 또는 persistence.multiple 컬렉션을 설정할 수 있지만 둘 다 설정할 수는 없습니다.

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