Kubernetes Operator용 MongoDB 컨트롤러 는 사용자가 쓰기 (write) 사양 파일을 사용하여 컨테이너화된 MongoDB Ops Manager 배포서버 생성합니다.
MongoDB Ops Manager 리소스 사양을 만들거나 업데이트 후 Kubernetes Operator용 MongoDB 컨트롤러가 이 사양을 Kubernetes 환경에 적용 지시합니다. Kubernetes Operator는 MongoDB Ops Manager 필요한 서비스 및 사용자 지정 Kubernetes 리소스를 생성한 다음, MongoDB Ops Manager 와 해당 지원 애플리케이션 데이터베이스를 Kubernetes 환경의 컨테이너에 배포합니다.
각 Ops Manager 리소스 YAML의 객체 사양을 사용하여 배포서버 의 특성 및 설정을 정의합니다.
예시
다음 예에서는 Ops Manager 배포를 위한 리소스 사양을 보여줍니다.
1 apiVersion: mongodb.com/v1 2 kind: MongoDBOpsManager 3 metadata: 4 name: om 5 spec: 6 topology: SingleCluster # optional, SingleCluster by default 7 opsManagerURL: https://link.to.configured.load-balancer.example.com # optional OM URL for the operator 8 replicas: 1 9 version: "8.0.0" 10 adminCredentials: ops-manager-admin-secret 11 configuration: 12 mms.fromEmailAddr: admin@example.com 13 mms.security.allowCORS: "false" 14 security: 15 tls: 16 ca: issuer-ca 17 backup: 18 enabled: true 19 encryption: 20 kmip: 21 server: 22 url: kmip.corp.mongodb.com:5696 23 ca: mongodb-kmip-certificate-authority-pem 24 headDB: 25 storage: "30Gi" 26 labelSelector: 27 matchLabels: 28 app: my-app 29 opLogStores: 30 - name: oplog1 31 # Sets labels for the oplog store. 32 assignmentLabels: ["test1", "test2"] 33 mongodbResourceRef: 34 name: my-oplog-db 35 mongodbUserRef: 36 name: my-oplog-user 37 s3Stores: 38 - name: s3store1 39 # Sets labels for the S3 store. 40 assignmentLabels: ["test1", "test2"] 41 42 mongodbResourceRef: 43 name: my-s3-metadata-db 44 mongodbUserRef: 45 name: my-s3-store-user 46 s3SecretRef: 47 name: my-s3-credentials 48 pathStyleAccessEnabled: true 49 s3BucketEndpoint: s3.region.amazonaws.com 50 s3BucketName: my-bucket 51 applicationDatabase: 52 passwordSecretKeyRef: 53 name: om-db-user-secret 54 key: password 55 members: 3 56 topology: SingleCluster 57 version: "7.0.21-ubi8" 58 featureCompatibilityVersion: "6.0" # During upgrade, set this FCV value to your currently deployed AppDB version. 59 security: 60 certsSecretPrefix: appdb 61 tls: 62 ca: issuer-ca
1 apiVersion: mongodb.com/v1 2 kind: MongoDBOpsManager 3 metadata: 4 name: om 5 spec: 6 topology: MultiCluster # optional, SingleCluster by default 7 opsManagerURL: https://link.to.configured.lb.example.com # optional OM URL for the operator 8 clusterSpecList: # optional ClusterSpecOMItem list, the type is different than ClusterSpecItem for AppDB and MongoDB 9 - clusterName: cluster-1 # required 10 replicas: 1 # required, OM application replicas 11 # optional parameters to override those defined at MongoDBOpsManager level 12 clusterDomain: cluster-1.example.com # optional, default cluster.local 13 jvmParameters: ["-Xmx4352m","-Xms4352m"] 14 externalConnectivity: # optional to override 15 type: LoadBalancer 16 port: 9090 17 annotations: 18 key: value 19 statefulSet: # StatefulSetSpecWrapper override 20 spec: {} 21 metadata: {} 22 configuration: 23 automation.versions.source: mongodb 24 mms.adminEmailAddr: cloud-manager-support@mongodb.com 25 backup: # MongoDBOpsManagerBackup, optional, we only support a subset of fields 26 members: 1 # backup daemon replicas, optional, default=1 27 assignmentLabels: [] # assignment labels to override 28 jvmParameters: ["-Xmx4352m","-Xms4352m"] # optional 29 statefulSet: # mdbc.StatefulSetConfiguration, optional to override for backup daemon 30 spec: {} 31 metadata: {} 32 - clusterName: cluster-2 33 replicas: 1 34 35 .... 36 37 replicas: 1 38 version: "8.0.0" 39 adminCredentials: ops-manager-admin-secret 40 configuration: 41 mms.fromEmailAddr: admin@example.com 42 mms.security.allowCORS: "false" 43 backup: 44 enabled: true 45 encryption: 46 kmip: 47 server: 48 url: kmip.corp.mongodb.com:5696 49 ca: mongodb-kmip-certificate-authority-pem 50 headDB: 51 storage: "30Gi" 52 labelSelector: 53 matchLabels: 54 app: my-app 55 opLogStores: 56 - name: oplog1 57 # Sets labels for the oplog store. 58 assignmentLabels: ["test1", "test2"] 59 mongodbResourceRef: 60 name: my-oplog-db 61 mongodbUserRef: 62 name: my-oplog-user 63 s3Stores: 64 - name: s3store1 65 # Sets labels for the S3 store. 66 assignmentLabels: ["test1", "test2"] 67 68 mongodbResourceRef: 69 name: my-s3-metadata-db 70 mongodbUserRef: 71 name: my-s3-store-user 72 s3SecretRef: 73 name: my-s3-credentials 74 pathStyleAccessEnabled: true 75 s3BucketEndpoint: s3.region.amazonaws.com 76 s3BucketName: my-bucket 77 security: 78 tls: 79 ca: issuer-ca 80 applicationDatabase: 81 passwordSecretKeyRef: 82 name: om-db-user-secret 83 key: password 84 version: "8.0.0-ubi8" 85 topology: MultiCluster 86 clusterSpecList: 87 - clusterName: cluster1.example.com 88 members: 4 89 - clusterName: cluster2.example.com 90 members: 3 91 - clusterName: cluster3.example.com 92 members: 2 93 security: 94 certsSecretPrefix: appdb 95 tls: 96 ca: issuer-ca
MongoDB Ops Manager 필수 설정
이 섹션에서는 모든 Ops Manager 리소스에 대해 사용해야 하는 설정에 대해 설명합니다.
spec.adminCredentials유형: 문자열
필수. MongoDB Ops Manager 관리자를 위해 생성한 Kubernetes 시크릿의 이름입니다. MongoDB Ops Manager 리소스 배포 Kubernetes Operator는 이러한 자격 증명 가진 사용자를 생성합니다.
참고
단일 클러스터 Kubernetes 배포에 시크릿이 저장되지 않도록 하려면 모든 시크릿 을 시크릿 저장 도구로 마이그레이션 할 수 있습니다. 여러 Kubernetes 클러스터에 대한 배포는 HashiCorp Vault와 같은 시크릿 저장 도구에 시크릿을 저장하는 것을 지원하지 않습니다.
관리 사용자에게는 전역 소유자 역할이 부여됩니다.
spec.replicas유형: integer
Conditional. Number of Ops Manager instances to run in parallel. If you specify
SingleClusterinspec.topology, this parameter is required. The mimimum accepted value is1.If you specify
MultiClusterinspec.topology, this parameter is ignored.
MongoDB Ops Manager 선택적 설정
MongoDB Ops Manager 리소스는 다음 설정을 사용할 수도 있습니다.
spec.backup.fileSystemStores유형: 문자열
파일 시스템 스냅샷 저장소 식별하는 이름입니다. 자세한 학습 은 Kubernetes Operator로 파일 시스템 백업 저장소 구성을 참조하세요.
spec.backup.logging.LogBackAccessRef유형: 문자열
MongoDB Ops Manager 백업 로그를 구성하기 위한 사용자 지정
logback-access.xml파일 이 포함된 ConfigMap에 대한 참조입니다.ConfigMap의 키는 MongoDB Ops Manager 파드의 기본값 파일 을 대체하도록
logback-access.xml의 이름과 정확히 일치해야 합니다.
spec.backup.logging.LogBackRef유형: 문자열
사용자 지정
logback.xml파일 이 포함된 ConfigMap에 대한 참조입니다. 이 파일 은 로그 로테이션 정책, 로그 수준 및 기타 로깅 매개변수를 포함하여 MongoDB Ops Manager 백업에 대한 일반적인 로깅 동작을 구성합니다.ConfigMap의 키는 MongoDB Ops Manager 파드의 기본값 파일 을 대체하도록
logback-access.xml의 이름과 정확히 일치해야 합니다. 학습 내용 은 CRD를 사용하여 MongoDB Ops Manager 로그 구성을 참조하세요.
spec.logging.LogBackAccessRef유형: 문자열
MongoDB Ops Manager 로그를 구성하기 위한 사용자 지정
logback-access.xml파일 이 포함된 ConfigMap에 대한 참조입니다.MongoDB Ops Manager 파드의 기본값 파일 을 대체하려면 ConfigMap의 키는 정확히
logback-access.xml여야 합니다.
spec.logging.LogBackRef유형: 문자열
사용자 지정
logback.xml파일 이 포함된 ConfigMap에 대한 참조입니다. 이 파일 은 로그 로테이션 정책, 로그 수준 및 기타 로깅 매개변수를 포함하여 MongoDB Ops Manager 의 일반적인 로깅 동작을 구성합니다.MongoDB Ops Manager 파드의 기본값 파일 을 대체하려면 ConfigMap의 키는 정확히
logback.xml여야 합니다.학습 내용 은 CRD를 사용하여 MongoDB Ops Manager 로그 구성을 참조하세요.
참고
If the size of files the Ops Manager dashboard generates is larger than the storage space available in the
emptyDirvolume, consider overriding theemptyDirvolume with a Persistent Volume to prevent pod crashes. To learn more, seespec.statefulSet.spec.template.spec.volumes.
spec.opsManagerURL유형: 문자열
선택 사항. Operator의 URL MongoDB Ops Manager 리소스 (예:Kubernetes
https://link.to.configured.lb.example.com)입니다.이 매개변수를 생략하는 경우, Kubernetes Operator는 MongoDB Ops Manager 인스턴스에 연결하기 위해 다음 URL 을 MongoDB Ops Manager 인스턴스의 기본값으로 사용합니다:
<om-name>-svc.{namespace}.svc.cluster.local. MongoDB Ops Manager용 헤드리스 서비스의 FQDN 입니다.이 매개변수를 지정하면 이 URL을 다른 URL로 변경할 수 있습니다.
참고
Don't confuse the
spec.opsManagerURLwith the URL that you specify in a ConfigMap for a particular deployment to configure MongoDB deployments and Monitoring Agents for the Application Database. The Kubernetes Operator requires to have thespec.opsManagerURLto directly connect to Ops Manager instances and to configure Ops Manager and Application Database deployments. The Kubernetes Operator doesn't use thespec.opsManagerURLto manage particular MongoDB databases.Change the
spec.opsManagerURLparameter to a custom URL in the following cases:여러 Kubernetes 클러스터에 MongoDB Ops Manager를 배포하고 MongoDB Ops Manager 호스팅 파드에서 기본 URL 에 액세스할 수 없는 경우. 예를 들어, Kubernetes Operator를 배포한 클러스터가 아닌 다른 Kubernetes 클러스터에 MongoDB Ops Manager를 배포하는 경우, MongoDB Ops Manager 서비스의 FQDN 에 액세스하지 못할 수 있습니다. 이 경우 사용자 지정 URL을 지정할 수 있습니다.
외부 도메인에서 MongoDB Ops Manager 인스턴스에 대한 외부 액세스를 구성할 때 사용자 지정 URL 을 지정할 수 있습니다. 또한 이를 위해서는 Kubernetes 연산자 및 애플리케이션 데이터베이스의 모니터링 에이전트가 기본 URL 대신 이 사용자 지정 URL을 사용해야 합니다.
spec.clusterDomain유형: 문자열
Kubernetes assigns each Pod a FQDN. The Kubernetes Operator calculates the FQDN for each Pod using a provided
clusterDomain. Kubernetes doesn't provide an API to query these hostnames.
spec.clusterName유형: 문자열
Kubernetes assigns each Pod a FQDN. The Kubernetes Operator calculates the FQDN for each Pod using a provided
clusterName. Kubernetes doesn't provide an API to query these hostnames.
spec.configuration유형: 컬렉션
Ops Manager configuration properties. See Ops Manager Configuration Settings for property names and descriptions. Each property takes a value of type
string.중요
Ops Manager가 배포된 Kubernetes 클러스터 외부에 배포된 MongoDB 리소스를 관리하는 경우
mms.centralUrl설정을spec.configuration에 추가해야 합니다.Ops Manager가 Kubernetes cluster 외부에 노출되는 URL로 값을 설정합니다.
학습 내용은 외부 MongoDB 배포 관리를 참조하세요.
spec.configuration.mms.featureFlag.automation.verifyDownloads유형: 문자열
enabled로 설정하면 MongoDB Agent는 Ops Manager 인스턴스가 managed하는 모든 MongoDB 배포에 대한 서명 파일이 필요합니다.이 옵션을 활성화한 상태에서 MongoDB Agent를 업그레이드하면 현재 버전의 MongoDB Agent에는 새 MongoDB Agent 바이너리의 서명 파일이 필요합니다.
자세한 내용은 MongoDB 서명 확인을 참조하세요.
spec.configuration.mms.featureFlag.backup.queryable유형: 부울
쿼리 가능 백업을 사용하지 않으려면
false로 설정합니다.
spec.configuration.mms.featureFlag.backup.wt.queryable유형: 부울
WiredTiger를 사용할 때 쿼리 가능한 백업 을 비활성화하려면
false로 설정합니다.
spec.configuration.mms.mongoDbUsage.defaultUsageType유형: 문자열
The Kubernetes service's default server type.
허용되는 값은
PRODUCTION_SERVER,TEST_SERVER,DEV_SERVER및RAM_POOL입니다.
spec.jvmParameters유형: 문자열 배열
선택 사항. 컨테이너를 통해 Ops Manager 애플리케이션으로 전달되는 JVM 매개변수입니다. 제공된 모든 매개변수는 Ops Manager 애플리케이션의 기본 JVM 매개변수를 대체합니다.
이 Kubernetes 연산자 매개변수의 기본값은 빈 목록입니다.
spec: jvmParameters: ["-XX:+HeapDumpOnOutOfMemoryError","-XX:HeapDumpPath=/tmp"] 중요
JVM 메모리 힙(Memory Heap) 값 변경에 대한 책임은 본인이 감수해야 합니다.
Kubernetes 연산자는 컨테이너의 메모리를 기반으로 Ops Manager 애플리케이션의 JVM 메모리 힙 값을 계산합니다.
-Xms및-Xmx값을 변경하면 MongoDB Ops Manager에서 문제가 발생할 수 있습니다.
spec.security.certsSecretPrefix유형: 문자열
시크릿 에 접두사로 Kubernetes 붙일 텍스트 MongoDB Ops Manager의 TLS 키 및 인증서가 포함된 사용자 생성.
시크릿 이름을
<prefix>-<metadata.name>-cert으로 지정해야 합니다.HTTPS 를 통해 실행되도록 Ops Manager 인스턴스를 구성하는 방법을 알아보려면 Ops Manager 리소스 배포를 참조하세요.
spec.security.tls.caConfigMap 의 이름 여기에는 MongoDB Ops Kubernetes Manager용 사용자 지정 CA 파일이 포함되어 있습니다.
중요
spec.security.tls.cais required if you use a custom CA to sign your Ops Manager TLS certificates.Kubernetes 연산자는 ConfigMap에서 Ops Manager 리소스
mms-ca.crt에 대한 인증서 이름을 지정해야 합니다.이 CA 는 다음을 충족하는 인증서에 서명합니다.
클라이언트가 Ops Manager 애플리케이션에 연결하는 데 사용합니다.
애플리케이션 데이터베이스 파드 의 에이전트가 MongoDB Ops Manager 와 통신하는 데 사용합니다.
경고
애플리케이션 데이터베이스가 다시 시작될 경우 Ops Manager가 작동하지 않도록 방지하려면
downloads.mongodb.com에서 사용자 지정 CA 파일과 전체 TLS 인증서 체인을 연결해야 합니다.
spec.security.tls.enabled중요
spec.security.tls.enabled더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. TLS를 활성화하려면spec.security.certsSecretPrefix설정에 대한 값을 제공합니다.클라이언트와 Ops Manager 간의 TLS 인증서를 사용하여 통신을 암호화합니다.
spec.statefulSet.spec유형: 컬렉션
Kubernetes Operator용 MongoDB 컨트롤러가 MongoDB Ops Manager 용으로 생성하는 StatefulSet의 사양입니다.
spec.statefulSet.spec에 추가할 수 있는 필드를 검토 하려면 Kubernetes 문서에서 StatefulSetSpec v1 앱을 참조하세요.
spec.statefulSet.spec.template유형: 컬렉션
Kubernetes Operator용 MongoDB 컨트롤러가 MongoDB Ops Manager 위해 생성하는 StatefulSet의 Kubernetes 파드에 대한 템플릿입니다.
참고
The Kubernetes Operator doesn't validate the fields you provide in
spec.statefulSet.spec.template.
spec.statefulSet.spec.template.metadata유형: 컬렉션
Kubernetes Operator용 MongoDB 컨트롤러가 MongoDB Ops Manager 위해 생성하는 StatefulSet 에 있는 Kubernetes Pods에 대한 메타데이터입니다.
spec.statefulSet.spec.template.metadata에 추가할 수 있는 필드를 검토 하려면 Kubernetes 문서를 참조하세요.
spec.statefulSet.spec.template.spec유형: 컬렉션
Kubernetes Operator용 MongoDB 컨트롤러가 MongoDB Ops Manager 위해 생성하는 StatefulSet 에 있는 Kubernetes 파드의 사양입니다.
spec.statefulSet.spec.template.spec에 추가할 수 있는 필드의 전체 목록을 검토 하려면 Kubernetes 문서를 참조하세요.다음 예시
spec.statefulSet.spec.template.spec는 Kubernetes Operator용 MongoDB 컨트롤러가 배포하는 하나의 MongoDB Ops Manager 컨테이너 대한 최소 및 최대 CPU 및 메모리 용량 정의합니다.팁
For more information on the hardware, software, and networking requirements for the hosts that run the Ops Manager components, see Ops Manager System Requirements in the Ops Manager Documentation.
statefulSet: spec: template: spec: containers: - name: mongodb-ops-manager resources: requests: cpu: "4" memory: "16Gi" limits: cpu: "8" memory: "32Gi"
spec.statefulSet.spec.template.spec.containers유형: 컬렉션
Kubernetes Operator용 MongoDB 컨트롤러가 MongoDB Ops Manager 용으로 생성하는 StatefulSet 의 Kubernetes Pods에 속하는 컨테이너 목록입니다.
Ops Manager container의 사양을 수정하려면 다음 예와 같이
name필드를 사용하여 container의 정확한 이름을 제공해야 합니다.backup: statefulSet: spec: template: spec: containers: - name: mongodb-ops-manager 참고
spec.statefulSet.spec.template.spec.containers에 container를 추가하면 Kubernetes 연산자가 container를 Kubernetes 파드에 추가합니다. 이러한 컨테이너는 포드의 Ops Manager 컨테이너에 추가됩니다.
spec.statefulSet.spec.template.spec.containers.resources.requests.cpu유형: 문자열
MongoDB Ops Manager 호스팅하다 위해 Kubernetes 노드 에서 사용할 수 있어야 하는 최소 CPU 용량 입니다.
The requested value must be less than or equal to
spec.statefulSet.spec.template.spec.containers.resources.limits.cpu.
spec.statefulSet.spec.template.spec.containers.resources.limits.cpu유형: 문자열
Ops Manager 를 호스팅하다 위해 생성되는 노드 의 최대 CPU 용량 . 생략하면 이 값은
spec.statefulSet.spec.template.spec.containers.resources.requests.cpu로 설정하다 됩니다.
spec.statefulSet.spec.template.spec.containers.resources.requests.memory유형: 문자열
Kubernetes 에서 Ops Manager 호스팅하다 위해 Kubernetes 노드 에서 사용할 수 있어야 하는 최소 메모리 용량 입니다. 이 값은 JEDEC 표기법으로 정수와 그 뒤에 오는 메모리 단위로 표현됩니다.
예시
Kubernetes의 Ops Manager에 6기가바이트의 메모리가 필요한 경우 이 값을
6Gi로 설정합니다.참고
MongoDB는 이 값을 최소
5Gi이상으로 설정할 것을 권장합니다.The requested value must be less than or equal to
spec.statefulSet.spec.template.spec.containers.resources.limits.memory.
spec.statefulSet.spec.template.spec.containers.resources.limits.memory유형: 문자열
Ops Manager 를 호스팅하다 위해 생성되는 노드 의 최대 메모리 용량 입니다. 생략하면 이 값은
spec.statefulSet.spec.template.spec.containers.resources.requests.memory로 설정하다 됩니다.Kubernetes Operator는 컨테이너의 메모리를 기반으로 Java 힙 크기에 대한 매개변수를 계산하고 설정합니다.
경고
이 값을 32GB 미만으로 제한
이 값을 32GB(
32Gi)보다 큰 값으로 설정하면 백업 서비스에 문제가 발생할 수 있습니다. 과도한 힙은 Ops Manager에서 예기치 않은 결과를 초래할 수 있습니다.
spec.statefulSet.spec.template.spec.volumes유형: 컬렉션
Kubernetes Operator용 MongoDB 컨트롤러가 Ops Manager 용으로 생성하는 StatefulSet 에 컨테이너가 마운트할 수 있는 볼륨의 목록입니다.
Ops Manager 대시보드 사용하여 배포서버 에 대한 로그를 요청하고 임시 파일의 크기가 상당히 큰 경우,
dataOps Manager StatefulSet의 Kubernetes 볼륨에 영구 볼륨을 사용하는 것이 좋습니다.dataKubernetes 볼륨은 기본값 으로emptyDir유형을 사용합니다. 이를 재정의하고 영구 볼륨을 사용하려면MongoDBOpsManager리소스 에 다음 구성을 추가합니다.statefulSet: spec: template: spec: volumes: - name: data persistentVolumeClaim: claimName: <my-pvc>
외부 연결 설정
This section describes optional settings related to external connectivity in Ops Manager. For optional external connectivity settings specific to your multi-cluster Ops Manager deployment, see Multi-Cluster Settings.
spec.externalConnectivity유형: 컬렉션
MongoDB Ops Manager 에 대한 외부 연결을 활성화하는 구성 객체 입니다. 제공된 경우, Kubernetes Operator는 Kubernetes 클러스터 외부에서 발생하는 트래픽이 MongoDB Ops Manager 애플리케이션 도달할 수 있도록 허용하는 Kubernetes 서비스를 생성합니다.
제공되지 않는 경우, Kubernetes 연산자는 Kubernetes 서비스를 생성하지 않습니다. 수동으로 생성하거나 외부 트래픽을 Kubernetes cluster의 Ops Manager 애플리케이션으로 라우팅할 수 있는 타사 솔루션을 사용해야 합니다.
spec.externalConnectivity.type유형: 문자열
MongoDB Ops Manager Kubernetes 외부에 노출하는 Kubernetes 서비스 ServiceType입니다.
Required if
spec.externalConnectivity.typeis present.허용되는 값은
LoadBalancer및NodePort입니다. cloud 공급자가 지원하는 경우LoadBalancer를 사용하는 것이 좋습니다. 로컬 배포에는NodePort을 사용합니다.
spec.externalConnectivity.port유형: integer
Kubernetes 서비스가 Ops Manager 애플리케이션을 노출하여 외부 트래픽에 사용해야 하는 포트를 나타내는 값입니다.
If
spec.externalConnectivity.typeisNodePort:Kubernetes 서비스는 이 포트를 통해 Ops Manager 애플리케이션을 외부 트래픽에 노출합니다.
If you don't provide a
spec.externalConnectivity.portvalue, the Kubernetes service routes traffic to the Ops Manager Application from an available port selected randomly from the following default range:30000-32767.참고
이 포트를 통한 트래픽을 허용하도록 네트워크 방화벽을 구성해야 합니다.
If
spec.externalConnectivity.typeisLoadBalancer:클라우드 공급자가 생성하는 밸런서 리소스는 이 포트를 통해 Ops Manager 애플리케이션을 노출합니다.
If you don't provide a
spec.externalConnectivity.portvalue, the Kubernetes service exposes the Ops Manager Application to external traffic through the default HTTP (8080) or HTTPS (8443) port.
spec.externalConnectivity.loadBalancerIP유형: 문자열
Kubernetes 연산자가 생성할 때 Kubernetes 서비스가 사용하는 IP 주소
LoadBalancer입니다.이 설정은 cloud 제공자 지원하고
spec.externalConnectivity.type이LoadBalancer인 경우에만 사용할 수 있습니다. 유형 LoadBalancer에 대해 자세히 학습 Kubernetes 문서를 참조하세요.
spec.externalConnectivity.externalTrafficPolicy유형: 문자열
Ops Manager Kubernetes 서비스에 대한 외부 트래픽에 대한 라우팅 정책입니다. 서비스는 이 설정의 값에 따라 외부 트래픽을 노드 로컬 또는 cluster 전체 엔드포인트로 라우팅합니다.
허용되는 값은
Cluster및Local입니다. 어떤 값이 요구 사항을 충족하는지 학습하려면 Kubernetes 문서에서 Kubernetes 의 소스 IP 를 참조하세요.참고
Cluster을 선택하면 Kubernetes 네트워크 경계에서 발생하는 네트워크 홉 중에 클라이언트의Source-IP가 손실됩니다.
백업 설정
이 섹션에서는 MongoDB Ops Manager의 백업과 관련된 선택적 설정에 대해 설명합니다. 멀티 클러스터 MongoDB Ops Manager 배포와 관련된 선택적 백업 설정은 멀티 클러스터 설정을 참조하세요.
spec.backup.assignmentLabels유형: 문자열 배열
백업 데몬 서비스 프로세스에 대한 할당 레이블 목록입니다. 할당 레이블을 사용하여 특정 백업 데몬 프로세스가 특정 프로젝트와 연결되어 있는지 식별합니다. Kubernetes Operator를 사용하여 할당 레이블을 설정하는 경우, 할당 레이블에 대해 Kubernetes 구성 파일에서 설정한 값이 MongoDB Ops Manager UI에 정의된 값을 재정의합니다. Kubernetes Operator를 사용하여 설정하지 않은 할당 레이블은 MongoDB Ops Manager UI에 설정된 값을 계속 사용합니다.
spec.backup.enabled유형: 부울
Ops Manager 리소스에 대해 백업을 활성화하는 플래그입니다.
false로 설정하면 백업이 비활성화됩니다.기본값은
true입니다.
spec.backup.encryption.kmip유형: 객체
Object that contains the KMIP backup encryption configuration settings. To learn more, see Configure KMIP Backup Encryption for Ops Manager.
참고
If you set this parameter, the API key linked with the value of
spec.credentialsmust have theGlobal Ownerrole.
spec.backup.encryption.kmip.server.ca유형: 문자열
KMIP 인증에 사용할 CA 인증서()에 대한 항목이 포함된 ConfigMap을 식별하는 인간 가독형
ca.pem레이블입니다.
spec.backup.encryption.kmip.server.url유형: 문자열
형식을 사용하는 KMIP 서버의URL 입니다(예시:
hostname.port192.168.1.3:5696my-kmip-server.mycorp.com:5696또는).
spec.backup.headDB유형: 컬렉션
헤드 데이터베이스 에 대한 구성 설정입니다. Kubernetes Operator가 Persistent Volume Claim 을 생성합니다. 지정된 구성으로.
스칼라데이터 유형설명labelSelector문자열
storage문자열
마운트해야 하는 영구 볼륨 의 최소 크기입니다. 이 값은 정수 뒤에 JEDEC 표기법으로 저장 단위를 붙여 표현합니다.
기본값은
30Gi입니다.학습 내용은 백업 디먼 하드웨어 요구 사항을 참조하세요.
예를 예시 헤드 데이터베이스 에 60 기가바이트의 저장 공간이 필요한 경우 이 값을
60Gi로 설정하다 합니다.storageClass문자열
영구 볼륨 클레임에 지정된 저장 유형입니다. 이 저장 유형을 StorageClass 객체로 생성한 후 이 객체 사양에서 사용할 수 있습니다.
StorageClass
reclaimPolicy를 Retain 으로 설정하다 해야 합니다. 이렇게 하면 영구 볼륨 클레임 이 제거될 때 데이터가 유지됩니다.
spec.backup.jvmParameters유형: 문자열 배열
선택 사항. container를 통해 Ops Manager 백업 서비스에 전달된 JVM 매개변수입니다.
이 Kubernetes 연산자 매개변수의 기본값은 빈 목록입니다.
spec: backup: jvmParameters: ["-XX:+UseStringCache"] 경고
JVM 메모리 힙(Memory Heap) 값 변경에 대한 책임은 본인이 감수해야 합니다.
Kubernetes 연산자는 컨테이너의 메모리를 기반으로 백업 서비스의 JVM 메모리 힙 값을 계산합니다.
-Xms및-Xmx값을 변경하면 MongoDB Ops Manager에서 문제가 발생할 수 있습니다.
spec.backup.members유형: integer
Optional. Number of backup daemon services to deploy in Kubernetes. If not specified, defaults to
1. To ensure high availability for your backup service, deploy multiple backup daemons in Ops Manager.
spec.backup.opLogStores유형: 컬렉션
Required if you enable backup. Array of oplog stores used for backup. Each item in the array references a MongoDB database resource deployed in the Kubernetes cluster by the Kubernetes Operator.
spec.backup.opLogStores.assignmentLabels유형: 문자열 배열
A list of assignment labels for the oplog store. Use assignment labels to identify that specific oplog stores are associated with particular projects. If you set assignment labels using the Kubernetes Operator, the values that you set in the Kubernetes configuration file for assignment labels override the values defined in the Ops Manager UI. Assignment labels that you don't set using the Kubernetes Operator continue to use the values set in the Ops Manager UI.
spec.backup.opLogStores.name유형: 문자열
백업을 활성화하는 경우 필수입니다. oplog 스토어의 이름입니다.
중요
지정한 후에는 oplog 스토어의 이름을 편집하지 마세요.
spec.backup.opLogStores.mongodbResourceRef.name유형: 문자열
백업을 활성화 하는 경우 필수입니다. oplog 슬라이스를 저장 하기 위해 생성하는
MongoDB리소스 또는MongoDBMultiCluster리소스 의 이름입니다. 이 리소스 는 MongoDB Ops Manager 리소스 와 동일한 네임스페이스 에 배포 해야 합니다.Oplog 데이터베이스는
SCRAM인증 메커니즘만 지원합니다. 다른 인증 메커니즘은 활성화할 수 없습니다.oplog 데이터베이스에서
SCRAM인증을 활성화하는 경우 다음을 수행해야 합니다.MongoDB 사용자 리소스를 생성하여 Ops Manager를 oplog 데이터베이스에 연결합니다.
Specify the
nameof the user in the Ops Manager resource definition.
이 이름을 가진 MongoDB database 리소스가 존재하지 않으면
backup리소스는Pending상태가 됩니다. Kubernetes 연산자는 이 이름의 MongoDB database 리소스가 생성될 때까지 10초마다 재시도합니다.참고
이 설정에서 참고하는 데이터베이스 리소스에 대한 보안 변경을 수행하면 Kubernetes 연산자가 Ops Manager 리소스를 자동으로 조정하기 시작합니다. Kubernetes 연산자는 변경 사항을 기반으로 Ops Manager 구성에서
mongoUri및ssl플래그를 업데이트합니다.
spec.backup.opLogStores.mongodbUserRef.name유형: 문자열
에서 SCRAM 인증이 활성화된 경우 필수입니다.Oplog Store Database 에 연결하는 데 사용되는 사용자 MongoDB Oplog Store Database 리소스의 이름입니다. 이 사용자 리소스를 MongoDB Ops Manager 리소스와 동일한 네임스페이스에 다음 역할을 모두 배포합니다.
spec.backup.blockStores유형: 컬렉션
Required if you enable Backup using a blockstore. Array of blockstores used for Backup. Each item in the array references a MongoDB database resource deployed in the Kubernetes cluster by the Kubernetes Operator.
spec.backup.blockStores.assignmentLabels유형: 문자열 배열
블록 저장소 의 할당 레이블 목록입니다. 할당 레이블을 사용하여 특정 블록 저장소가 특정 프로젝트와 연결되어 있는지 식별합니다. Kubernetes Operator를 사용하여 할당 레이블을 설정하는 경우, 할당 레이블에 대해 Kubernetes 구성 파일에서 설정한 값이 MongoDB Ops Manager UI에 정의된 값을 재정의합니다. Kubernetes Operator를 사용하여 설정하지 않은 할당 레이블은 MongoDB Ops Manager UI에 설정된 값을 계속 사용합니다.
spec.backup.blockStores.name유형: 문자열
블록 저장소를 사용하여 백업을 활성화하는 경우 필수입니다. 블록 저장소의 이름입니다.
중요
일단 지정한 후에는 블록 저장소의 이름을 편집하지 마세요.
spec.backup.blockStores.mongodbResourceRef.name유형: 문자열
블록 저장소를 사용하여 백업을 활성화하는 경우 필수입니다. 블록 저장소에 대해 생성하는 MongoDB database 리소스의 이름입니다. 이 데이터베이스 리소스를 MongoDB Ops Manager 리소스와 동일한 네임스페이스에 배포해야 합니다.
블록 저장소 데이터베이스는
SCRAM인증 메커니즘만 지원합니다. 다른 인증 메커니즘은 활성화할 수 없습니다.블록 저장소 데이터베이스에서
SCRAM인증을 활성화하는 경우 다음을 수행해야 합니다.Ops Manager를 블록 저장소 데이터베이스에 연결하는 MongoDB 사용자 리소스를 생성합니다.
Specify the
nameof the user in the Ops Manager resource definition.
이 이름을 가진 MongoDB database 리소스가 존재하지 않으면
backup리소스는Pending상태가 됩니다. Kubernetes 연산자는 이 이름의 MongoDB database 리소스가 생성될 때까지 10초마다 재시도합니다.참고
이 설정에서 참고하는 데이터베이스 리소스에 대한 보안 변경을 수행하면 Kubernetes 연산자가 Ops Manager 리소스를 자동으로 조정하기 시작합니다. Kubernetes 연산자는 변경 사항을 기반으로 Ops Manager 구성에서
mongoUri및ssl플래그를 업데이트합니다.
spec.backup.blockStores.mongodbUserRef.name유형: 문자열
블록 저장소 데이터베이스에서 SCRAM 인증이 활성화된 경우 필수입니다. 블록 저장소 데이터베이스에 연결하는 데 사용되는 MongoDB 사용자 리소스의 이름입니다. 이 사용자 리소스를 MongoDB Ops Manager 리소스와 동일한 네임스페이스에 다음 역할을 모두 배포합니다.
spec.backup.queryableBackupSecretRef.name유형: 문자열
Name of the secret that contains the queryable.pem file from Ops Manager that you will use for accessing and querying backups based on your deployment's TLS requirements.The PEM file contains a public key certificate and its associated private key that are needed to access and run queries on backup snapshots in Ops Manager. To query backups, specify the value for this parameter. If not set, backups are not affected, but you can't query them.
spec.backup.statefulSet.spec유형: 컬렉션
Kubernetes 연산자용 MongoDB 컨트롤러가 백업 데몬 서비스를 위해 생성하는 StatefulSet의 사양입니다.
spec.backup.statefulSet.spec에 추가할 수 있는 필드를 검토 하려면 Kubernetes 문서에서 StatefulSetSpec v1 앱을 참조하세요.
spec.backup.statefulSet.spec.template유형: 컬렉션
Kubernetes연산자용 MongoDB 컨트롤러가 백업 데몬 서비스를 위해 생성하는 StatefulSet의 Kubernetes 파드에 대한 템플릿입니다.
참고
The Kubernetes Operator doesn't validate the fields you provide in
spec.backup.statefulSet.spec.template.
spec.backup.statefulSet.spec.template.metadata유형: 컬렉션
Kubernetes 연산자용 MongoDB 컨트롤러가 백업 데몬 서비스를 위해 생성하는 StatefulSet에 있는 Kubernetes 파드의 메타데이터입니다.
spec.backup.statefulSet.spec.template.metadata에 추가할 수 있는 필드를 검토 하려면 Kubernetes 문서를 참조하세요.
spec.backup.statefulSet.spec.template.spec유형: 컬렉션
Kubernetes 연산자용 MongoDB 컨트롤러가 백업 데몬 서비스를 위해 생성하는 StatefulSet에 있는 Kubernetes 파드의 사양입니다.
spec.backup.statefulSet.spec.template.spec에 추가할 수 있는 필드의 전체 목록을 검토 하려면 Kubernetes 문서를 참조하세요.다음 예시
spec.backup.statefulSet.spec.template.spec는 Kubernetes 연산자용 MongoDB 컨트롤러가 배포하는 하나의 백업 데몬 서비스 컨테이너에 대한 최소 및 최대 CPU 및 메모리 용량 정의합니다.팁
For more information on the hardware, software, and networking requirements for the hosts that run the Ops Manager components, see Ops Manager System Requirements in the Ops Manager Documentation.
statefulSet: spec: template: spec: containers: - name: mongodb-backup-daemon resources: requests: cpu: "4" memory: "8Gi" limits: cpu: "8" memory: "16Gi"
spec.backup.statefulSet.spec.template.spec.containers유형: 컬렉션
Kubernetes Operator용 MongoDB 컨트롤러가 백업 데몬 서비스를 위해 생성하는 StatefulSet의 Kubernetes Pods에 속하는 컨테이너 목록입니다.
To modify the specifications of the backup daemon service container, you must provide the exact name of the container using the
namefield, as shown in the following example:backup: statefulSet: spec: template: spec: containers: - name: mongodb-backup-daemon 참고
spec.backup.statefulSet.spec.template.spec.containers에 컨테이너를 추가하면 Kubernetes Operator가 컨테이너를 Kubernetes pod에 추가합니다. 이러한 컨테이너는 포드의 백업 데몬 서비스 컨테이너에 추가됩니다.
spec.backup.statefulSet.spec.template.spec.containers.resources.requests.cpu유형: 문자열
백업 데몬 서비스를 호스팅하다 위해 Kubernetes 노드 에서 사용할 수 있어야 하는 최소 CPU 용량 입니다.
The requested value must be less than or equal to
spec.backup.statefulSet.spec.template.spec.containers.resources.limits.cpu.
spec.backup.statefulSet.spec.template.spec.containers.resources.limits.cpu유형: 문자열
백업 데몬 서비스를 호스팅하다 하기 위해 생성되는 노드 의 최대 CPU 용량 . 생략하면 이 값은
spec.backup.statefulSet.spec.template.spec.containers.resources.requests.cpu으로 설정하다 됩니다.
spec.backup.statefulSet.spec.template.spec.containers.resources.requests.memory유형: 문자열
Kubernetes 노드 에서 사용할 수 있어야 하는 최소 메모리 용량 Kubernetes에서 백업 데몬 서비스 를 호스팅합니다. 이 값은 JEDEC 표기법으로 정수와 그 뒤에 오는 메모리 단위로 표현됩니다.
참고
이 값을 최소
4.5Gi이상으로 설정합니다.4.5Gi보다 작은 값은 오류가 발생할 수 있습니다.The requested value must be less than or equal to
spec.backup.statefulSet.spec.template.spec.containers.resources.limits.memory.
spec.backup.statefulSet.spec.template.spec.containers.resources.limits.memory유형: 문자열
백업 데몬 서비스를 호스팅하다 하기 위해 생성되는 노드 의 최대 메모리 용량 입니다. 생략하면 이 값은
spec.backup.statefulSet.spec.template.spec.containers.resources.requests.memory으로 설정하다 됩니다.Kubernetes Operator는 컨테이너의 메모리를 기반으로 Java 힙 크기에 대한 매개변수를 계산하고 설정합니다.
경고
이 값을 32GB 미만으로 제한
이 값을 32GB(
32Gi)보다 큰 값으로 설정하면 백업 서비스에 문제가 발생할 수 있습니다. 과도한 힙은 Ops Manager에서 예기치 않은 결과를 초래할 수 있습니다.
S3 설정
Oplog 및 백업 스냅샷을 저장하는 데 S3 를 사용하고 사용자 지정 CA 에서 발급한 키를 사용하여 TLS 로 S3 에 대한 연결을 보호하도록 Ops Manager를 구성할 수 있습니다.
To configure custom CA keys, use the ConfigMap with which you configured TLS for your Application Database as described on the TLS-Encrypted Connection (HTTPS) tab of Deploy an Ops Manager Resource. Set spec.applicationDatabase.security.tls.ca to this ConfigMap.
S3 와 애플리케이션 데이터베이스 모두에 TLS 를 사용하거나, S3 에만 TLS를 사용할 수 있습니다.
두 가지 모두에 TLS를 사용하려면 ConfigMap에서 참조된 동일한
ca-pem에서 두 가지 목적에 대한 인증서를 가져오십시오.S3 에만 TLS 를 사용하려면
spec.security.applicationDatabase.certsSecretPrefixConfigMap에 를 정의하지 마세요.
spec.backup.s3OpLogStores.assignmentLabels유형: 문자열 배열
S3 oplog 저장소의 할당 레이블 목록입니다. 할당 레이블을 사용하여 특정 S3 oplog 저장소가 특정 프로젝트와 연결되어 있는지 식별합니다. Kubernetes Operator를 사용하여 할당 레이블을 설정하다 경우 Kubernetes 구성 파일 에서 설정하다 할당 레이블 값이 Ops Manager UI 에 정의된 값을 재정의합니다. Kubernetes Operator를 사용하여 설정하다 하지 않은 할당 레이블은 Ops Manager UI 에 설정하다 값을 계속 사용합니다.
spec.backup.s3OpLogStores.customCertificate유형: 부울
Deprecated. Use
spec.backup.s3OpLogStores.customCertificateSecretRefsinstead.AppDB 인증서()를
appdb-caS3 oplog 저장의 사용자 지정 TLS 인증서로 사용할지 여부를 나타내는 플래그입니다. 기본값은False입니다.
spec.backup.s3OpLogStores.customCertificateSecretRefs유형: 객체 배열
Kubernetes 시크릿을 사용하는 S3 oplog 저장 의 사용자 지정 인증서 목록입니다. 기본64인코딩된 x.509 인증서는 키와 함께 Kubernetes 시크릿에 이미 존재해야 하며 Java CertifcateFactory로 구문 분석할 수 있어야 합니다. 하나의 시크릿 체인에 여러 인증서를 지정할 수 없습니다. 하나의 시크릿에서 체인에 여러 인증서를 지정하는 경우 Kubernetes Operator는 체인의 첫 번째 인증서만 사용합니다.
customCertificate설정도 제공하는 경우, Kubernetes Operator는spec.applicationDatabase.security.tls.ca을(를) 백업용 사용자 지정 인증서로 사용합니다.Each entry in the list specifies the
nameand thekey. If you specify multiple secrets, Kubernetes Operator uses all the certificates in the specified secrets.이 설정을 제공하지 않으면 Ops Manager는 Ops Manager에서 사용하는 JVM 기본 신뢰 저장소를 사용합니다.
spec.backup.s3OpLogStores.customCertificateSecretRefs.name유형: 문자열
S3 oplog 저장에 대한 사용자 지정 인증서를 사용하는 데 필요합니다. 사용자 지정 인증서가 포함된 Kubernetes 시크릿입니다.
spec.configuration.mms.mongoDbUsage.defaultUsageType유형: 문자열
The Kubernetes service's default server type.
spec.backup.s3OpLogStores.customCertificateSecretRefs.key유형: 문자열
Required to use custom certificates for your S3 oplog store. File that represents the key in the secret that contains the base64-encoded x.509 certificate. If you don't specify this setting, the Kubernetes Operator can't utilize the custom certificate for S3 oplog store backups.
spec.backup.s3OpLogStores.irsaEnabled유형: 부울
Flag that enables using AWS IAM roles for service accounts in AWS EKS to configure an S3 oplog store. The default is
False. If you aren't using AWS EKS, this flag has no effect. When set toFalse, using AWS IAM roles for service accounts in EKS to configure an S3 oplog store is disabled. To learn more, see IAM roles for service accounts in EKS.
spec.backup.s3OpLogStores.mongodbResourceRef.name유형: 문자열
S3 oplog 저장소에 대한 메타데이터를 저장하기 위해 생성하는 MongoDB 데이터베이스 리소스의 이름입니다. 이 데이터베이스 리소스는 MongoDB Ops Manager 리소스와 동일한 네임스페이스에 배포해야 합니다.
참고
애플리케이션 데이터베이스를 사용하여 S3 oplog 저장 에 대한 메타데이터 를 저장 하려면 이 설정을 생략합니다.
If you omit this setting, you must also omit the
spec.backup.s3OpLogStores.mongodbUserRef.namesetting. The Kubernetes Operator handlesSCRAMuser authentication internally.이 데이터베이스에서
SCRAM인증을 활성화하는 경우 다음을 수행해야 합니다.Ops Manager를 데이터베이스에 연결하는 MongoDB 사용자 리소스를 생성합니다.
Specify the
nameof the user in the Ops Manager resource definition.
spec.backup.s3OpLogStores.mongodbUserRef.name유형: 문자열
S3 oplog 메타데이터를 저장할 MongoDB 데이터베이스 리소스를 생성했고 이 데이터베이스에서 SCRAM이 활성화된 경우 필수입니다. S3 oplog 저장의 메타데이터 데이터베이스에 연결하는 데 사용되는 MongoDB 사용자 리소스의 이름입니다. Ops Manager 리소스와 동일한 네임스페이스와 다음 역할이 모두 포함된 이 사용자 리소스를 배포합니다.
중요
일단 지정한 후에는 S3 메타데이터 oplog 저장 사용자 이름의 이름을 편집하지 마세요.
spec.backup.s3OpLogStores.s3SecretRef.name유형: 문자열
spec.backup.s3OpLogStores.irsaEnabled가true로 설정하다 되지 않은 경우 S3 저장 사용하여 oplog 를 저장 데 필요합니다.accessKey및secretKey필드를 포함하는 시크릿의 이름입니다.백업 데몬 서비스는 이러한 필드의 값을 자격 증명 으로 사용하여 AWS S3 또는 S3호환 버킷에 액세스 .S3 oplog 저장 구성하려면 시크릿에 두 키를 모두 지정해야 합니다.spec.backup.s3OpLogStores.irsaEnabled를true로 설정하다 Amazon Web Services S3 자격 증명 파드 환경 변수로 마운트되므로s3SecretRef를 설정하다 필요가 없습니다.
spec.backup.s3OpLogStores.pathStyleAccessEnabled유형: 부울
버킷 엔드포인트 URL의 스타일을 나타냅니다.
값설명예시true경로 스타일 URL
s3.amazonaws.com/<bucket>false가상 호스트 스타일 URL
<bucket>.s3.amazonaws.comAmazon Web Services 의 주석 및 TLS 지원 에 대해 자세히 학습 Kubernetes 설명서를 참조하세요.
기본값은
true입니다.
spec.backup.s3OpLogStores.s3BucketEndpoint유형: 문자열
S3 저장소를 사용하여 oplog를 저장하는 데 필요합니다. oplog 저장을 호스팅하는 Amazon Web Services S3 버킷 또는 S3호환 버킷의 URL입니다.
참고
If your endpoint doesn't include a region in its URL, specify the
s3RegionOverridefield.
spec.backup.s3OpLogStores.s3BucketName유형: 문자열
S3 저장소를 사용하여 oplog를 저장하는 데 필요합니다. oplog 저장을 호스팅하는 Amazon Web Services S3 버킷 또는 S3호환 버킷의 이름입니다.
spec.backup.s3OpLogStores.s3RegionOverride유형: 문자열
S3호환 버킷이 있는 리전입니다. 이 필드 S3 oplog 스토어의
s3BucketEndpoint가 리전 범위를 지원 하지 않는 경우에만 사용하세요. 리전 범위 지정은 엔드포인트의 URL 에 리전 포함되지 않는 경우를 말합니다.이 필드 AWS S3 버킷과 함께 사용하지 마세요. 자세한 내용은 S3 블록 저장소 구성을 참조하세요.
spec.backup.s3Stores.assignmentLabels유형: 문자열 배열
데이터베이스 백업 스냅샷을 저장하는 S3 또는 S3 호환 버킷에 대한 할당 레이블 목록입니다. 할당 레이블을 사용하여 특정 S3 저장소가 특정 프로젝트와 연결되어 있는지 식별합니다. Kubernetes Operator를 사용하여 할당 레이블을 설정하다 경우 Kubernetes 구성 파일 에서 설정하다 할당 레이블 값이 Ops Manager UI 에 정의된 값을 재정의합니다. Kubernetes Operator를 사용하여 설정하다 하지 않은 할당 레이블은 Ops Manager UI 에 설정하다 값을 계속 사용합니다.
spec.backup.s3Stores.customCertificate유형: 부울
Deprecated. Use
spec.backup.s3Stores.customCertificateSecretRefsinstead.애플리케이션 데이터베이스의 인증서()를
appdb-caS3 백업의 사용자 지정 TLS 인증서로 사용할지 여부를 나타내는 플래그입니다. 기본값은False입니다.
spec.backup.s3Stores.customCertificateSecretRefs유형: 객체 배열
Kubernetes 시크릿을 사용하는 S3 스냅샷 저장소 의 사용자 지정 인증서 목록입니다. 기본64인코딩된 x.509 인증서는 키와 함께 Kubernetes 시크릿에 이미 존재해야 하며 Java CertifcateFactory로 구문 분석할 수 있어야 합니다. 하나의 시크릿 체인에 여러 인증서를 지정할 수 없습니다. 하나의 시크릿에서 체인에 여러 인증서를 지정하는 경우 Kubernetes Operator는 체인의 첫 번째 인증서만 사용합니다.
spec.backup.s3Stores.customCertificate설정도 제공하는 경우, Kubernetes Operator는spec.applicationDatabase.security.tls.ca을(를) 백업용 사용자 지정 인증서로 사용합니다.Each entry in the list specifies the
nameand thekey. If you specify multiple secrets, Kubernetes Operator uses all the specified secrets.이 설정을 제공하지 않으면 Kubernetes 연산자는 Ops Manager에서 백업에 사용하는 JVM 기본 신뢰 저장소를 사용합니다.
spec.backup.s3Stores.customCertificateSecretRefs.name유형: 문자열
S3 oplog 저장에 대한 사용자 지정 인증서를 사용하는 데 필요합니다. 사용자 지정 인증서가 포함된 Kubernetes 시크릿입니다.
spec.backup.s3Stores.customCertificateSecretRefs.key유형: 문자열
Required to use custom certificates for your S3 oplog store. File that represents the key in the secret that contains the base64-encoded x.509 certificate. If you don't specify this setting, Kubernetes Operator can't utilize the custom certificate for S3 snapshot store and defaults to the default trust store used by Ops Manager.
spec.backup.s3Stores.irsaEnabled유형: 부울
Flag that enables using AWS IAM roles for service accounts in AWS EKS to configure an S3 snapshot store. The default is
False. If you aren't using AWS EKS, this flag has no effect. When set toFalse, using AWS IAM roles for service accounts in EKS to configure an S3 snapshot store is disabled. To learn more, see IAM roles for service accounts in EKS.
spec.backup.s3Stores.name유형: 문자열
S3 저장소를 사용하여 oplog를 저장하는 데 필요합니다. S3 스냅샷 저장소 이름
중요
지정한 후에는 S3 스냅샷 저장소의 이름을 편집하지 마세요. 이 변경은 백업이 이전 이름을 사용하는 경우 실패할 가능성이 높습니다. 성공적인 변경의 결과는 예측할 수 없습니다.
spec.backup.s3Stores.mongodbResourceRef.name유형: 문자열
S3 스냅샷 저장소의 메타데이터를 저장하기 위해 생성하는
MongoDB리소스 또는MongoDBMultiCluster리소스의 이름입니다. 이 데이터베이스 리소스는 MongoDB Ops Manager 리소스와 동일한 네임스페이스에 배포해야 합니다.참고
애플리케이션 데이터베이스를 사용하여 S3 스냅샷 저장소 에 대한 메타데이터 를 저장 하려면 이 설정을 생략합니다.
If you omit this setting, you must also omit the
spec.backup.s3Stores.mongodbUserRef.namesetting. The Kubernetes Operator handlesSCRAMuser authentication internally.이 데이터베이스에서
SCRAM인증을 활성화하는 경우 다음을 수행해야 합니다.Ops Manager를 데이터베이스에 연결하는 MongoDB 사용자 리소스를 생성합니다.
Specify the
nameof the user in the Ops Manager resource definition.
중요
지정한 후에는 S3 스냅샷 저장소의 이름을 편집하지 마세요. 이 변경은 백업이 이전 이름을 사용하는 경우 실패할 가능성이 높습니다. 성공적인 변경의 결과는 예측할 수 없습니다.
이 이름을 가진 MongoDB database 리소스가 존재하지 않으면
backup리소스는Pending상태가 됩니다. Kubernetes 연산자는 이 이름의 MongoDB database 리소스가 생성될 때까지 10초마다 재시도합니다.참고
이 설정에서 참고하는 데이터베이스 리소스에 대한 보안 변경을 수행하면 Kubernetes 연산자가 Ops Manager 리소스를 자동으로 조정하기 시작합니다. Kubernetes 연산자는 변경 사항을 기반으로 Ops Manager 구성에서
mongoUri및ssl플래그를 업데이트합니다.
spec.backup.s3Stores.mongodbUserRef.name유형: 문자열
저장할 MongoDB 데이터베이스 리소스를 만든 경우 필수 |s3| 스냅샷 메타데이터이고 이 데이터베이스에서 SCRAM이 활성화되어 있어야 합니다. S3 스냅샷 저장소의 메타데이터 데이터베이스에 연결하는 데 사용되는 MongoDB 사용자 리소스 이름. Ops Manager 리소스와 동일한 네임스페이스와 다음 역할이 모두 포함된 이 사용자 리소스를 배포합니다.
중요
일단 지정한 후에는 S3 메타데이터 스냅샷 저장소 사용자 이름의 이름을 편집하지 마세요.
spec.backup.s3Stores.s3SecretRef.name유형: 문자열
S3 저장 사용하여 백업을 활성화 하고
spec.backup.s3Stores.irsaEnabled을true로 설정하다 하지 않은 경우 필요합니다.accessKey및secretKey필드를 포함하는 시크릿의 이름입니다.백업 데몬 서비스는 이러한 필드의 값을 자격 증명 으로 사용하여 AWS S3 또는 S3호환 버킷에 액세스 . 시크릿에 두 키 중 하나라도 누락된 경우 S3 스냅샷 저장소 구성할 수 없습니다.spec.backup.s3Stores.irsaEnabled를true로 설정하다 Amazon Web Services S3 자격 증명 파드 환경 변수로 마운트되므로s3SecretRef를 설정하다 필요가 없습니다.
spec.backup.s3Stores.objectLockEnabled유형: 부울
이 스냅샷 저장소를 지원하는 Amazon Web Services S3 또는 S3호환 버킷에 객체 잠금이 활성화되어 있는지 여부를 지정합니다. 이 필드를
true(으)로 설정하여 저장소에 대한 변경 불가능한 백업을 활성화합니다.This field is supported only with Ops Manager version 8.0.19 or later. For information about configuring immutable backups in Ops Manager, see Set Immutable Backup.
기본값은
false입니다.
spec.backup.s3Stores.pathStyleAccessEnabled유형: 부울
버킷 엔드포인트 URL의 스타일을 나타냅니다.
값설명예시true경로 스타일 URL
s3.amazonaws.com/<bucket>false가상 호스트 스타일 URL
<bucket>.s3.amazonaws.com기본값은
true입니다.
spec.backup.s3Stores.s3BucketEndpoint유형: 문자열
S3 스토어를 사용하여 백업을 활성화하는 경우 필수입니다. 스냅샷 저장소를 호스팅하는 Amazon Web Services S3 버킷 또는 S3호환 버킷의 URL
참고
If your endpoint doesn't include a region in its URL, specify the
s3RegionOverridefield.
spec.backup.s3Stores.s3BucketName유형: 문자열
S3 스토어를 사용하여 백업을 활성화하는 경우 필수입니다. 스냅샷 저장소를 호스팅하는 Amazon Web Services S3 버킷 또는 S3호환 버킷의 이름입니다.
spec.backup.s3Stores.s3RegionOverride유형: 문자열
S3호환 버킷이 있는 리전입니다. 이 필드 S3 스토어의
s3BucketEndpoint가 리전 범위를 지원 하지 않는 경우에만 사용하세요. 리전 범위 지정은 엔드포인트의 URL 에 리전 포함되지 않는 경우를 말합니다.이 필드 AWS S3 버킷과 함께 사용하지 마세요. 자세한 내용은 S3 블록 저장소 구성을 참조하세요.
애플리케이션 데이터베이스 필수 설정
This section describes settings that you must use in addition to the required Ops Manager settings in order to configure your Ops Manager Application Database.
spec.applicationDatabase.version유형: 문자열
필수입니다. Ops Manager 애플리케이션 데이터베이스에 설치된 MongoDB 의 버전입니다. 컨테이너 레지스트리의 태그를 지정하다 기반으로 호환되는 엔터프라이즈 MongoDB 버전을 지정해야 합니다. 예시:
8.0.0-ubi8. Kubernetes Operator 버전 1.20부터 태그가 더 이상-ent로 끝나지 않습니다.참고
If you update this value to a later version of MongoDB for the Application Database, the feature compatibility version remains at the MongoDB version you're upgrading from to give you the option to downgrade if necessary. If you want the feature compatibility version to match the new MongoDB version, you must manually set the
featureCompatibilityVersionparameter underspec.applicationDatabase.
애플리케이션 데이터베이스 선택적 설정
This section describes optional settings related to your Ops Manager Application Database. For optional application database settings specific to your multi-cluster Ops Manager deployment, see Multi-Cluster Settings.
spec.applicationDatabase유형: 컬렉션
Ops Manager Application Database resource definition.
복제본 세트 리소스 사양의 다음 설정은 선택 사항입니다.
spec.applicationDatabase.agent.logLevel유형: 문자열
기본값: INFO
Pod 내부의 자동화 에이전트 로깅 수준을 구성합니다. 허용되는 값은 다음과 같습니다.
DEBUGINFOWARNERRORFATAL
spec.applicationDatabase.agent.<component>.logRotate유형: 객체
구성 요소 를 다음 값 중 하나로 바꿉니다.
mongodmonitoringAgent
MongoDB configuration object for rotating the MongoDB logs of a process. To use the
agent.<component>.logRotatesettings, you must setsystemLog.destinationtofilebecause you can't use theagent.<component>.logRotatesettings if you're writing logs to the host's syslog system.참고
If the size of files the Ops Manager dashboard generates is larger than the storage space available in the
emptyDirvolume, consider overriding theemptyDirvolume with a Persistent Volume to prevent pod crashes. To learn more, seespec.statefulSet.spec.template.spec.volumes.
spec.applicationDatabase.agent.mongod.logRotate.numTotal유형: integer
기본값:
0Total number of log files that Ops Manager retains. If you don't change the default, Ops Manager bases rotation on your other
agent.<compenet>.logRotatesettings.
spec.applicationDatabase.agent.mongod.logRotate.numUncompressed유형: integer
기본값:
5현재 로그 파일을 포함하여 압축되지 않은 상태로 둘 수 있는 최대 총 로그 파일 수입니다.
spec.applicationDatabase.agent.mongod.logRotate.percentOfDiskspace유형: 숫자
기본값:
0.02Maximum percentage of total disk space that Ops Manager can use to store the log files expressed as decimal. If this limit is exceeded, Ops Manager deletes compressed log files until it meets this limit. Ops Manager deletes the oldest log files first.
spec.applicationDatabase.agent.<component>.logRotate.sizeThresholdMB유형: 숫자
구성 요소 를 다음 값 중 하나로 바꿉니다.
mongodmonitoringAgent
Required if rotating logs. Maximum size in MB for an individual log file before Ops Manager rotates it. Ops Manager rotates the log file immediately if it meets the value given in either this
sizeThresholdMBor thelogRotate.timeThresholdHrslimit.
spec.applicationDatabase.agent.<component>.logRotate.timeThresholdHrs유형: integer
구성 요소 를 다음 값 중 하나로 바꿉니다.
mongodmonitoringAgent
Required if rotating logs. Maximum duration in hours for an individual log file before the next rotation. The time is since the last rotation. Ops Manager rotates the log file immediately if it meets the value given in either
timeThresholdHrsor thelogRotate.sizeThresholdMlimit.
spec.applicationDatabase.agent.mongod.auditlogRotate유형: 객체
프로세스 의 MongoDB 감사 로그를 순환시키기 위한 MongoDB 구성 객체 입니다.
spec.applicationDatabase.agent.mongod.auditlogRotate.numTotal유형: integer
기본값:
0Total number of audit log files that Ops Manager retains. If you don't change the default value, Ops Manager bases rotation on your other
agent.mongod.auditlogRotatesettings.
spec.applicationDatabase.agent.mongod.auditlogRotate.numUncompressed유형: integer
기본값:
5현재 감사 로그 파일 을 포함하여 압축되지 않은 상태로 둘 수 있는 최대 총 감사 로그 파일 수입니다.
spec.applicationDatabase.agent.mongod.auditlogRotate.percentOfDiskspace유형: 숫자
기본값:
0.02Maximum percentage of total disk space that Ops Manager can use to store the audit log files expressed as decimal. If you exceed this limit, Ops Manager deletes compressed audit log files until it meets this limit. Ops Manager deletes the oldest audit log files first.
spec.applicationDatabase.agent.mongod.auditlogRotate.sizeThresholdMB유형: 숫자
Required if rotating audit logs. Maximum size in MB for an individual audit log file before Ops Manager rotates it. Ops Manager rotates the audit log file immediately if it reaches the value in either
sizeThresholdMBor theauditlogRotate.timeThresholdHrslimit.
spec.applicationDatabase.agent.mongod.auditlogRotate.timeThresholdHrs유형: integer
Required if rotating audit logs. Maximum duration in hours for an individual audit log file before the next rotation. The time is since the last rotation. Ops Manager rotates the audit log file immediately if it reaches the value in either
timeThresholdHrsor theauditlogRotate.sizeThresholdMlimit.
spec.applicationDatabase.agent.startupOptions유형: 객체
시작 옵션에 대한 MongoDB 구성 객체입니다. 사용 가능한 필드는 MongoDB Agent 설정 을 참조하세요.
spec.applicationDatabase.agent.systemLog.path유형: 문자열
기본값입니다:
/var/log/mongodb-mms-automation/mongodb.logThe path of the log file to which
mongodormongosshould send all diagnostic logging information, rather than the standard output or the host's syslog. MongoDB creates the log file at the specified path.Linux 패키지 init 스크립트는
systemLog.path이(가) 기본값에서 변경될 것으로 예상하지 않습니다. Linux 패키지를 사용하면서systemLog.path을(를) 변경하는 경우 자체 init 스크립트를 사용하고 내장 스크립트를 비활성화해야 합니다.
spec.applicationDatabase.agent.systemLog.logAppend유형: 부울
기본값입니다:
falseWhen
true,mongosormongodappends new entries to the end of the existing log file when themongosormongodinstance restarts. Without this option,mongodwill back up the existing log and create a new file.
spec.applicationDatabase.agent.systemLog.destination유형: 문자열
The destination to which MongoDB sends all log output. Specify either
fileorsyslog. If you specifyfile, you must also specifysystemLog.path.If you don't specify
systemLog.path, MongoDB sends all log output to standard output.경고
시스템 로그 데몬은 MongoDB가 메시지를 발행할 때가 아니라 메시지를 기록할 때 타임스탬프를 생성합니다. 이 동작은 특히 시스템 부하가 심한 경우 로그 항목에 대한 잘못된 타임스탬프를 초래할 수 있습니다. 정확한 타임스탬프를 보장하려면 프로덕션 시스템에 대해
file옵션을 사용하는 것이 좋습니다.
spec.applicationDatabase.externalAccess유형: 컬렉션
외부 연결을 위해 클러스터를 노출하는 사양입니다. Kubernetes 클러스터 외부에서 MongoDB 리소스에 연결하는 방법을 알아보려면 Kubernetes 외부에서 MongoDB 데이터베이스 리소스에 연결하기를 참조하세요.
spec.externalAccess를 추가하면 Kubernetes Operator는 복제본 세트 의 각 파드에 대한 외부 서비스를 생성합니다. 외부 서비스는 클러스터 의 각 MongoDB database 파드에 대한 외부 진입 점 제공합니다. 각 외부 서비스에는 외부 서비스를 특정 Pod와 일치시키는 선택기가 있습니다.이 설정을 값없이 추가하면 Kubernetes Operator는 다음과 같은 기본값을 사용하여 외부 서비스를 생성합니다.
필드값설명Name<pod-name>-svc-external외부 서비스의 이름입니다. 이 값은 변경할 수 없습니다.
TypeLoadBalancer외부 LoadBalancer 서비스를 생성합니다.
Port<Port Number>A port for
mongod.publishNotReadyAddresstrue파드가 준비되지 않은 경우에도 DNS 레코드 가 생성되도록 지정합니다. 데이터베이스 Pod에 대해
false로 설정하다 하지 마세요.
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유형: 컬렉션
배포서버 의 모든 클러스터에 cloud 제공자별 구성 설정을 추가할 수 있는 키-값 쌍입니다. 자세한 학습 은 주석 및 Kubernetes cloud 제공자 설명서를 참조하세요.
주석 을 사용하여 Kubernetes Operator 배포에서 사용하는 외부 서비스에 대한 자리 표시자 값을 지정할 수 있습니다. Kubernetes Operator는 다음 표에 설명된 대로 이러한 값을 올바른 값으로 자동으로 바꿉니다. 자리 표시자를 사용하면 특정 파드의 각 서비스에 특정 어노테이션을 제공할 수 있습니다.
값설명{resourceName}{namespace}{podIndex}StatefulSet 에 의해 할당되고 현재 외부 서비스의 대상이 되는 파드의 인덱스입니다.
{podName}{resourceName}-{podIndex}과 같습니다.{statefulSetName}StatefulSet.
{resourceName}와 동일합니다.{externalServiceName}지정한 자리 표시자 값을 기반으로 외부 서비스의 생성된 이름입니다.
{resourceName}-{podIndex}-svc-external과 같습니다.{mongodProcessDomain}The domain name of the server that is hosting the mongod process. Equal to
spec.externalAccess.externalDomainif specified. Otherwise, equal to the domain used for themongodprocess FQDN.예를 들어 프로세스 호스트 이름
mdb-rs-1.example.com의 경우example.com은 도메인 이름입니다.{mongodProcessFQDN}The
mongodprocess hostname set in the automation configuration.프로세스 호스트 이름은 배포서버 구성에 따라 다릅니다. 을(를) 사용하도록
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.applicationDatabase.memberConfig유형: 객체 배열
MongoDB Ops Manager 배포서버 서버의 각 애플리케이션 데이터베이스 복제본 세트 멤버에 대한 사양입니다.
중요
If you set
spec.topologytoMultiCluster, usespec.applicationDatabase.clusterSpecList.memberConfiginstead ofspec.applicationDatabase.memberConfig. In a multi-cluster Ops Manager deployment, the Kubernetes Operator ignores all parameters underspec.applicationDatabase.memberConfig.memberConfig목록의 요소 수는spec.applicationDatabase.members와 같아야 합니다.memberConfig목록의 요소 순서는 복제본 세트 의 멤버 순서를 반영해야 합니다. 예를 예시 배열 의 첫 번째 요소는 인덱스0에서 Pod에 영향을 주고, 두 번째 요소는 인덱스1에 영향을 줍니다.예시
애플리케이션 데이터베이스의 3개 멤버 복제본 세트 에 대한 다음 예시 사양을 살펴보세요.
spec: applicationDatabase: 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" tags: tag2: "value2" environment: "prod"
spec.applicationDatabase.memberConfig.priority유형: 문자열
애플리케이션 데이터베이스 복제본 세트 멤버가 프라이머리 멤버가 될 상대적인 가능성을 나타내는 숫자입니다.
복제 세트 멤버가 프라이머리가 될 가능성을 상대적으로 높이려면 더 높은
priority값을 지정합니다.복제 세트 멤버가 기본 멤버가 될 가능성을 상대적으로 줄이려면 더 낮은
priority값을 지정하세요.
예를 들어
memberConfig.priority가1.5인 노드는memberConfig.priority가0.5인 노드보다 프라이머리 노드가 될 가능성이 큽니다.A member with a
memberConfig.priorityof0is ineligible to become the primary. To learn more, see Member Priority.
spec.applicationDatabase.memberConfig.tags유형: 매핑
Map of replica set tags for directing read and write operations to specific members of your Application Database replica set.
spec.applicationDatabase.memberConfig.votes유형: 숫자
Determines whether an Application Database replica set member can vote in an election. Set to
1to allow the member to vote. Set to0to exclude the member from an election.
spec.applicationDatabase.passwordSecretKeyRef.name유형: 문자열
Ops Manager 데이터베이스 사용자
mongodb-ops-manager의 비밀번호가 포함된 시크릿 의 이름입니다. Ops Manager는 이 비밀번호를 사용 하여 애플리케이션 데이터베이스에 인증합니다.
spec.applicationDatabase.passwordSecretKeyRef.key유형: 문자열
Ops Manager 데이터베이스 사용자
mongodb-ops-manager의 비밀번호가 포함된 시크릿 필드의 이름입니다. Ops Manager는 이 비밀번호를 사용 하여 애플리케이션 데이터베이스에 인증합니다.기본값은
password입니다.
spec.applicationDatabase.security.certsSecretPrefix유형: 문자열
애플리케이션 데이터베이스의 TLS 키 및 인증서가 포함된, 사용자가 생성한 Kubernetes 시크릿에 접두사로 붙일 텍스트입니다.
시크릿 이름을
<prefix>-<metadata.name>-db-cert으로 지정해야 합니다.HTTPS 를 통해 실행되도록 Ops Manager 인스턴스를 구성하는 방법을 알아보려면 Ops Manager 리소스 배포를 참조하세요.
spec.applicationDatabase.security.tls.ca유형: 문자열
애플리케이션 데이터베이스의 CA 파일 포함된 Kubernetes ConfigMap의 이름입니다.
중요
spec.applicationDatabase.security.tls.cais required if you use a custom CA to sign your Application Database's TLS certificates.Kubernetes Operator를 사용하려면 ConfigMap에서 애플리케이션 데이터베이스의 인증서 이름을
ca-pem으로 지정해야 합니다.이 섹션에서 지정된 CA는
spec.backup.s3OpLogStores.customCertificate또는spec.backup.s3Stores.customCertificate가true로 설정하다 경우 S3 저장 에 대한 사용자 지정 TLS 인증서를 구성하는 데에도 사용됩니다.이 CA 는 다음을 충족하는 인증서에 서명합니다.
애플리케이션 데이터베이스 복제본 세트 멤버가 서로 통신하는 데 사용합니다.
MongoDB Ops Manager 가 애플리케이션 데이터베이스 복제본 세트 와 통신하는 데 사용합니다.
경고
애플리케이션 데이터베이스가 다시 시작될 경우 Ops Manager가 작동하지 않도록 방지하려면
downloads.mongodb.com에서 사용자 지정 CA 파일과 전체 TLS 인증서 체인을 연결해야 합니다.
spec.applicationDatabase.security.tls.enabled중요
spec.security.applicationDatabase.tls.enabled더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. TLS를 활성화하려면spec.security.applicationDatabase.certsSecretPrefix설정에 대한 값을 제공합니다.와 애플리케이션 데이터베이스 간의 TLS 인증서를 사용하여 통신을 암호화합니다.MongoDB Ops Manager
Prometheus 설정
다음 설정은 애플리케이션 데이터베이스와 함께 Prometheus를 사용할 때 적용 됩니다.
spec.applicationDatabase.prometheus.metricsPath유형: 문자열
기본값:
"/metrics"선택 사항입니다. 지표 엔드포인트의 경로를 나타내는 사람이 읽을 수 있는 문자열입니다. 이 설정을 지정하지 않으면 기본값이 적용됩니다.
spec.applicationDatabase.prometheus.passwordSecretRef유형: 객체
기본 HTTP 인증 을 위한 시크릿 의 세부 정보가 포함된 조건부 객체입니다. 애플리케이션 데이터베이스와 함께 Prometheus를 사용하려면 이 설정을 지정해야 합니다.
spec.applicationDatabase.prometheus.passwordSecretRef.key유형: 문자열
기본값:
"password"선택 사항. 기본 HTTP 인증 위한 비밀번호를 저장하는 시크릿(secret)의 키를 식별하는 사람이 읽을 수 있는 문자열입니다. 이 설정을 지정하지 않으면 기본값 적용됩니다.
spec.applicationDatabase.prometheus.passwordSecretRef.name유형: 문자열
조건부
기본 HTTP 인증 위한 비밀번호가 포함된 시크릿 을 식별하는 사람이 읽을 수 있는 레이블입니다. 애플리케이션 데이터베이스와 함께 Prometheus를 사용하려면 이 설정을 지정해야 합니다.
spec.applicationDatabase.prometheus.port유형: integer
기본값: 9216
선택 사항입니다. 지표 엔드포인트가 바인딩할 포트를 식별하는 숫자입니다. 이 설정을 지정하지 않으면 기본값이 적용됩니다.
spec.applicationDatabase.prometheus.tlseSecretKeyRef유형: 객체
선택 사항. TLS 인증 위한 시크릿의 세부 정보가 포함된 객체입니다.
spec.applicationDatabase.prometheus.tlseSecretKeyRef.key유형: 문자열
기본값:
"password"선택 사항. TLS 인증 위한 비밀번호를 저장하는 시크릿(secret)의 키를 식별하는 사람이 읽을 수 있는 문자열입니다. 이 설정을 지정하지 않으면 기본값 이 적용됩니다.
spec.applicationDatabase.prometheus.tlseSecretKeyRef.name유형: 문자열
조건부. TLS 인증 위한 비밀번호가 포함된 시크릿을 식별하는 사람이 읽을 수 있는 레이블입니다. 애플리케이션 데이터베이스와 함께 Prometheus를 사용하고 TLS 인증 사용하려면 이 설정을 지정해야 합니다.
멀티 클러스터 설정
MongoDB Ops Manager 필수 설정
이 섹션에서는 필수 MongoDB Ops Manager 설정 외에도 멀티 클러스터 MongoDB Ops Manager 배포에 사용해야 하는 설정에 대해 설명합니다.
spec.clusterSpecList.members유형: integer
Conditional. The number of Ops Manager members in the Ops Manager cluster in a multi-Kubernetes cluster MongoDB deployment. When you set
spec.topologytoMultiCluster, you must specify the value for this parameter. Omit this parameter for single-cluster deployments. If you set this parameter to zero, this removes this Ops Manager member cluster from the list of member clusters in the multi-Kubernetes cluster of Ops Manager instances.
spec.topology유형: 문자열
리소스에 Kubernetes 대한 배포서버 유형입니다.MongoDB Ops Manager
The values are
SingleClusterorMultiCluster. 생략하면 기본값은SingleCluster입니다.MultiCluster을 지정하는 경우:MongoDBMultiCluster리소스를 감시 리소스 목록에 추가 합니다. 이는 Kubernetes Operator에게 다중 Kubernetes 클러스터 모드에서 작동해야 하며 다중 Kubernetes 리소스를 처리하는 데 필요한 구성 작업을 수행해야 함을 나타냅니다.Specify at least one member cluster on which you want to deploy Ops Manager, using
spec.clusterSpecListand its nestedspec.clusterSpecList.clusterNameandspec.clusterSpecList.membersparameters.MultiCluster을 지정하면 Kubernetes Operator는spec.members에 설정하다 한 모든 값을 무시합니다. 리소스 사양의 예시 를 참조하세요.
MongoDB Ops Manager 선택적 설정
MongoDB Ops Manager 리소스는 멀티 클러스터 MongoDB Ops Manager 배포와 관련된 다음 설정도 사용할 수 있습니다.
spec.clusterSpecList유형: 컬렉션
Conditional. Details of selected Kubernetes member clusters in a multi-Kubernetes cluster where you intend to deploy Ops Manager or Backup Daemon instances. See also the example of the resource specification.
When you set
spec.topologytoMultiCluster, you must specify the value forspec.clusterSpecList.members. All other parameters underspec.clusterSpecListare optional.When you set
spec.topologytoSingleCluster, the Kubernetes Operator ignores all parameters underspec.clusterSpecList.
spec.clusterSpecList.clusterName유형: 문자열
선택 사항. Kubernetes Operator용 MongoDB 컨트롤러가 MongoDB Ops Manager 또는 백업 디먼 용 StatefulSet 를 예약하는 멀티 Kubernetes 클러스터 MongoDB deployment 에서 멤버 Kubernetes 클러스터 의 이름입니다.
spec.clusterSpecList.clusterDomain유형: 문자열
선택 사항. 특정 Ops Manager 멤버 클러스터 에 대한
spec.clusterDomain의 재정의입니다. 이 값을 생략하면spec.clusterDomain에 설정하다 값이 기본값이 됩니다. Kubernetes 각 Pod에 FQDN을 할당합니다. Kubernetes Operator는 제공된clusterDomain값을 사용하여 각 Pod의 FQDN을 계산합니다. Kubernetes 이러한 호스트 이름을 쿼리 하는 API 제공하지 않습니다.
spec.clusterSpecList.configuration유형: 컬렉션
Optional. Ops Manager configuration properties that override properties you set in
spec.configurationfor the specific cluster. See Ops Manager Configuration Settings for property names and descriptions. Each property takes a value of typestring. For example, setting these properties allows you to change environment variables that you must pass to Ops Manager and the Backup Daemon in that particular member cluster.If you omit specifying values, defaults to the values set in
spec.configuration.
spec.clusterSpecList.jvmParameters유형: 문자열 배열
선택 사항. 이 멤버 클러스터 에 대해 및 백업 디먼 인스턴스에 전달된JVM 매개 변수입니다.MongoDB Ops Manager
If you specify this parameter, its values override the values specified in
spec.jvmParameters. For example values, see the example of the resource specification.If you omit this parameter, values from the
spec.jvmParametersare used for the Ops Manager and Backup Daemon instances in this member cluster.
spec.clusterSpecList.externalConnectivity유형: 컬렉션
Optional. Configuration object that enables external connectivity to Ops Manager for the specific cluster. This is an override for
spec.externalConnectivityfor the specific cluster.이 매개변수의 값을 지정하여 MongoDB Ops Manager 애플리케이션 이 다양한 클러스터에서 외부에 노출되는 방식을 변경합니다. 예를 예시 ,MongoDB Ops Manager Kubernetes 서로 다른 cloud 제공자의 노드에 를 배포 경우, 이 매개변수에 cloud 제공자별 값을 지정해야 할 수 있습니다.
이 매개변수를 설정하면 다음과 같습니다.
The Kubernetes Operator doesn't use
spec.externalConnectivityvalues for this member Ops Manager cluster.Kubernetes Operator는 Kubernetes 클러스터 외부에서 발생하는 트래픽이 이 멤버 클러스터 의 MongoDB Ops Manager 애플리케이션 에 도달할 수 있도록 하는 라는 이름의 Kubernetes 서비스를 생성합니다.
<om-name>-svc-ext
If you omit this parameter, the Kubernetes Operator uses values from
spec.externalConnectivityfor this member cluster.
spec.clusterSpecList.statefulSet.spec유형: 컬렉션
선택 사항. Kubernetes 연산자용 MongoDB 컨트롤러가 다중 Kubernetes 클러스터 Ops Manager 배포서버 의 특정 멤버 클러스터 에 대해 생성하는 StatefulSet에 대한 사양입니다. 이 매개변수는
spec.statefulSet.spec에 대한 재정의입니다. 이를 생략하면 Kubernetes Operator는spec.statefulSet.spec의 값을 사용합니다. 예시 들어, 이 매개변수를 사용하여 다중 Kubernetes 클러스터 MongoDB deployment 에서 각 Ops Manager 클러스터에 대해 서로 다른 저장 값을 지정할 수 있습니다.spec.clusterSpecList.statefulSet.spec에 추가할 수 있는 필드를 검토 하려면 Kubernetes 문서에서 StatefulSetSpec v1 앱을 참조하세요.
spec.clusterSpecList[*].backup선택 사항. 해당 특정 구성원 클러스터에 대해
spec.backup에 지정된 값을 재정의하는 백업 설정입니다.You can set these values only if
spec.backup.enabledis set totrue.이 매개변수에 대한 값 설정을 생략하면 기본값 은
spec.backup아래의 설정에 지정된 값입니다.이 재정의에서는 모든 백업 설정이 지원되지 않습니다. 다음 백업 설정은
spec.backup아래에 지정된 경우 모든 멤버 클러스터에 전역적으로 적용되므로 재정의할 수 없습니다.externalServiceEnabledheadDBopLogStoresblockStoress3StoresfileSystemStoresqueryableBackupSecretRefencryption
spec.clusterSpecList[*].backup.members유형: integer
Optional. Override for
spec.backup.members. The number of Backup Daemon instances to deploy in this cluster. if you omit this value or provide a value of0, the Kubernetes Operator won't deploy Backup Daemon instances in a particular member cluster.
spec.clusterSpecList[*].backup.assignmentLabels유형: 문자열 배열
Optional. Override for
spec.backup.assignmentLabels. If specified, the Kubernetes Operator uses the values you specify in this override for all Backup Daemon instances in a particular member cluster. If you omit values for this parameter, the values default to those specified inspec.backup.assignmentLabelsfor all Backup Daemon instances in a member cluster.
spec.clusterSpecList[*].backup.jvmParameters유형: 문자열 배열
Optional. Override for
spec.backup.jvmParameters. Allows you to customize the JVM value for Backup Daemon instances in a particular member cluster.
spec.clusterSpecList[*].backup.statefulSet유형: 문자열
선택 사항.
spec.backup.statefulSet.spec에 대한 재정의. 특정 구성원 클러스터 에서 백업 디먼 의 값을 사용자 지정할 수 있습니다.spec.clusterSpecList[*].backup.statefulSet에 추가할 수 있는 필드를 검토 하려면 Kubernetes 문서에서 StatefulSetSpec v1 앱을 참조하세요.
애플리케이션 데이터베이스 필수 설정
이 섹션에서는 애플리케이션 데이터베이스에 사용해야 하는 멀티 클러스터 MongoDB Ops Manager 배포와 관련된 설정에 대해 설명합니다.
spec.applicationDatabase.clusterSpecList유형: 컬렉션
애플리케이션 데이터베이스를 호스팅하다 하는 노드 제공 을 하는 다중 Kubernetes 클러스터 MongoDB deployment 에서 선택한 Kubernetes 멤버 클러스터의 세부 정보입니다.
spec.applicationDatabase.clusterSpecList.clusterName유형: 문자열
Kubernetes Operator용 MongoDB 컨트롤러가 애플리케이션 데이터베이스에 대한 StatefulSet 를 예약하는 다중 Kubernetes 클러스터 MongoDB deployment 에서 멤버 Kubernetes 클러스터 의 이름입니다.
중요
You can't convert a single cluster Ops Manager instance to a multi-Kubernetes cluster MongoDB deployment instance by modifying the
topologyand theclusterSpecListsettings in the CRD.
spec.applicationDatabase.clusterSpecList.members유형: 숫자
지정된 멤버 클러스터에 있는 statefulSet 노드의 수입니다. 멤버 클러스터는 다중 Kubernetes 클러스터 MongoDB 배포에서 애플리케이션 데이터베이스를 호스팅하는 멤버 클러스터 중 하나입니다.
spec.applicationDatabase.topology유형: 문자열
애플리케이션 데이터베이스에 대한 Kubernetes 배포 유형입니다.
The values are
SingleClusterorMultiCluster. 생략하면 기본값은SingleCluster입니다.MultiCluster를 지정하는 경우 멤버를 하나 이상 지정해야 합니다.cluster on which you want to deploy the Application Database using the
clusterSpecList,clusterName,membersparameters.MultiCluster을 지정하면 Kubernetes Operator는spec.applicationDatabase.members필드 에 설정하다 한 값을 무시합니다.
자세히 알아보려면 멀티 클러스터 리소스 사양의 예를 참조하세요.
애플리케이션 데이터베이스 선택적 설정
이 섹션에서는 애플리케이션 데이터베이스에 사용할 수 있는 멀티 클러스터 MongoDB Ops Manager 배포서버 와 관련된 설정에 대해 설명합니다.
spec.applicationDatabase.clusterSpecList.externalAccess유형: 문자열
복제본 세트 배포를 외부에 노출하는 데 사용되는 외부 도메인입니다.
기본적으로 각 복제본 세트 멤버는 Kubernetes 파드의 FQDN(
*.svc.cluster.local)을 기본 호스트명으로 사용합니다. 하지만 이 설정에 외부 도메인을 추가하면 복제본 세트는 지정된 도메인의 하위 도메인인 호스트 이름을 대신 사용합니다. 이 호스트 이름은 다음 형식을 사용합니다:<replica-set-name>-<cluster-idx>-<pod-idx>.<externalDomain>예를 들면 다음과 같습니다.
multi-replica-set-0-1.cluster-0.example.com중요
서비스 메시 없이 애플리케이션 데이터베이스 배포서버 배포할 때만 이 설정을 사용합니다. 서비스 메시가 없는 멀티 클러스터 MongoDB Ops Manager참조하세요.
spec.applicationDatabase.clusterSpecList.memberConfig유형: 문자열 배열
멀티 클러스터 MongoDB Ops Manager 배포서버 의 각 애플리케이션 데이터베이스 복제본 세트 멤버에 대한 사양입니다.
중요
If you set
spec.topologytoSingleCluster, usespec.applicationDatabase.memberConfiginstead ofspec.applicationDatabase.clusterSpecList.memberConfig.The number of elements in the
memberConfiglist must equalspec.applicationDatabase.clusterSpecList.members.memberConfig목록의 요소 순서는 복제본 세트 의 멤버 순서를 반영해야 합니다. 예를 예시 배열 의 첫 번째 요소는 인덱스0에서 Pod에 영향을 주고, 두 번째 요소는 인덱스1에 영향을 줍니다.예시
애플리케이션 데이터베이스의 3개 멤버 복제본 세트 에 대한 다음 예시 사양을 살펴보세요.
spec: replicas: 3 version: 8.0.0 backup: enabled: true storage: resources: requests: storage: 10Gi storageClassName: standard applicationDatabase: clusterSpecList: - name: appdb members: 3 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" tags: tag2: "value2" environment: "prod"
spec.applicationDatabase.clusterSpecList.memberConfig.priority유형: 문자열
애플리케이션 데이터베이스 복제본 세트 멤버가 프라이머리 멤버가 될 상대적인 가능성을 나타내는 숫자입니다.
복제 세트 멤버가 프라이머리가 될 가능성을 상대적으로 높이려면 더 높은
priority값을 지정합니다.복제 세트 멤버가 기본 멤버가 될 가능성을 상대적으로 줄이려면 더 낮은
priority값을 지정하세요.
예를 들어
memberConfig.priority가1.5인 노드는memberConfig.priority가0.5인 노드보다 프라이머리 노드가 될 가능성이 큽니다.A member with a
memberConfig.priorityof0is ineligible to become the primary. To learn more, see Member Priority.
spec.applicationDatabase.clusterSpecList.memberConfig.tags유형: 매핑
Map of replica set tags for directing read and write operations to specific members of your Application Database replica set.
spec.applicationDatabase.clusterSpecList.memberConfig.votes유형: 숫자
Determines whether an Application Database replica set member can vote in an election. Set to
1to allow the member to vote. Set to0to exclude the member from an election.