Kubernetes 외부에서 MongoDB 데이터베이스 리소스에 연결하기

Kubernetes 연산자를 사용하여 독립형 리소스를 배포합니다.

독립형 리소스를 배포하지 않은 경우 지침에 따라 리소스를 배포하세요.

이 절차에서는 다음 예시를 사용합니다.

20
---
21
apiVersion: mongodb.com/v1
22
kind: MongoDB
23
metadata:
24
  name: <my-standalone>
25
spec:
26
  version: "8.0.0"
27
  opsManager:
28
    configMapRef:
29
      name: <configMap.metadata.name>
30
            # Must match metadata.name in ConfigMap file
31
  credentials: <mycredentials>
32
  type: Standalone
33
...

MongoDB Pod에 대한 외부 서비스를 생성합니다.

외부 리소스에서 독립형 리소스에 연결하려면 spec.externalAccess를 구성하세요. 설정:

externalAccess: {}

이 설정은 Kubernetes Operator가 독립형 리소스 에서 MongoDB Pod에 대한 외부 LoadBalancer 서비스를 생성하도록 지시합니다. 외부 서비스는 외부 연결을 위한 진입 점 제공합니다. 값 없이 이 설정을 추가하면 다음 기본값 을 사용하여 외부 서비스가 생성됩니다.

선택적으로 서비스에 값을 추가하거나 기본값을 재정의해야 하는 경우 다음을 지정합니다.

• cloud 제공자 와 관련된 주석 spec.externalAccess.externalService.annotations

• spec.externalAccess.externalService.spec 의 서비스 사양에 대한 재정의.

예를 들어, 다음 설정은 외부 서비스의 기본값을 재정의하여 독립형 리소스를 구성하여 MongoDB Pod를 노출하는 NodePort 서비스를 생성하도록 합니다.

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

외부 서비스를 확인합니다.

독립형 리소스에서 다음 명령을 실행하여 Kubernetes Operator가 배포서버용 외부 서비스를 생성했는지 확인합니다.

$ kubectl get services

이 명령은 다음 출력과 유사한 서비스 목록을 반환합니다. 크럴스터의 각 데이터베이스 Pod에 대해 Kubernetes 연산자는 <pod-name>-0-svc-external이라는 외부 서비스를 만듭니다. 이 서비스는 외부 서비스 사양에서 제공하는 값 및 재정의에 따라 구성됩니다.

NAME                                  TYPE         CLUSTER-IP   EXTERNAL-IP       PORT(S)           AGE
<my-standalone>-0-svc-external   LoadBalancer   10.102.27.116    <lb-ip-or-fqdn>   27017:27017/TCP    8m30s

클러스터 구성 또는 클라우드 공급자에 따라 LoadBalancer 서비스의 IP 주소는 외부에서 액세스할 수 있는 IP 주소 또는 FQDN입니다. IP 주소 또는 FQDN을 사용하여 외부 도메인의 트래픽을 라우팅할 수 있습니다.

독립형 리소스에 대한 연결을 테스트합니다.

Kubernetes 클러스터 외부에서 배포서버에 연결하려면 MongoDB Shell(mongosh)을 사용하고 외부 도메인을 통해 노출한 MongoDB Pod 주소를 지정합니다.

mongosh "mongodb://<my-standalone>.<external-domain>"

Kubernetes Operator로 복제본 세트 를 배포합니다.

복제본 세트를 배포하지 않은 경우 지침에 따라 배포하세요.

spec.security.certsSecretPrefix 설정에 값을 제공하여 복제본 세트 에 대해 TLS를 활성화 해야 합니다. 복제본 세트 spec.security.tls.ca에 저장된 사용자 지정 CA 인증서를 사용해야 합니다.

MongoDB 파드에 대한 외부 서비스를 생성합니다.

외부 리소스 에서 복제본 세트 에 연결하려면 spec.externalAccess 를 구성합니다. 설정:

externalAccess: {}

이 설정은 Kubernetes Operator에게 복제본 세트 의 MongoDB 파드에 대한 외부 LoadBalancer 서비스를 생성하도록 지시합니다. 외부 서비스는 외부 연결을 위한 진입 점 제공합니다. 값 없이 이 설정을 추가하면 다음 기본값 을 사용하여 외부 서비스가 생성됩니다.

선택적으로 서비스에 값을 추가하거나 기본값을 재정의해야 하는 경우 다음을 지정합니다.

• cloud 제공자 와 관련된 주석 spec.externalAccess.externalService.annotations

• spec.externalAccess.externalService.spec 의 서비스 사양에 대한 재정의.

예시 를 들어 다음 설정은 외부 서비스의 기본값 을 재정의하여 MongoDB 파드를 노출하는 NodePort 서비스를 생성하도록 복제본 세트 구성합니다.

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

TLS 인증서에 주체 대체 이름을 추가합니다.

각 외부 DNS 이름을 인증서 SAN 에 추가합니다.

외부 서비스를 확인합니다.

복제본 세트 에서 다음 명령을 실행 하여 Kubernetes Operator가 배포서버 서버를 위한 외부 서비스를 생성했는지 확인합니다.

$ kubectl get services

이 명령은 다음 출력과 유사한 서비스 목록을 반환합니다. 클러스터 의 각 데이터베이스 Pod에 대해 Kubernetes Operator는 <pod-name>-<pod-idx>-svc-external라는 외부 서비스를 생성합니다. 이 서비스는 외부 서비스 사양에서 제공하는 값 및 재정의에 따라 구성됩니다.

NAME                                  TYPE         CLUSTER-IP   EXTERNAL-IP       PORT(S)           AGE
<my-replica-set>-0-svc-external   LoadBalancer   10.102.27.116    <lb-ip-or-fqdn>   27017:27017/TCP    8m30s

클러스터 구성 또는 클라우드 공급자에 따라 LoadBalancer 서비스의 IP 주소는 외부에서 액세스할 수 있는 IP 주소 또는 FQDN입니다. IP 주소 또는 FQDN을 사용하여 외부 도메인의 트래픽을 라우팅할 수 있습니다.

복제본 세트 리소스 YAML 파일 엽니다.

샘플 복제본 세트 리소스 복사합니다.

원하는 복제본 세트 구성과 일치하도록 이 YAML 파일 의 설정을 변경합니다.

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDB
4
metadata:
5
  name: <my-replica-set>
6
spec:
7
  members: 3
8
  version: "8.0.0"
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 섹션의 리소스 파일 끝에 객체 사양을 붙여넣습니다.

강조 표시된 설정을 원하는 값으로 변경합니다.

복제본 세트 리소스 에서 외부 호스트 이름 및 외부 서비스 값을 확인합니다.

spec.connectivity.replicaSetHorizons 설정의 외부 호스트 이름이 올바른지 확인하세요.

외부 호스트 이름은 Kubernetes 작업자 노드의 DNS 이름과 일치해야 합니다. 이는 Kubernetes 클러스터의 모든 노드가 될 수 있습니다. Kubernetes 노드는 파드가 다른 노드에서 실행되는 경우 내부 라우팅을 사용합니다.

spec.connectivity.replicaSetHorizons 의 포트를 외부 서비스 값으로 설정합니다.

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
...

복제본 세트 구성 파일 저장합니다.

복제본 세트 배포서버 업데이트하고 다시 시작합니다.

임의의 디렉토리 에서 다음 Kubernetes 명령을 호출하여 복제본 세트 업데이트 하고 다시 시작합니다.

kubectl apply -f <replica-set-conf>.yaml

복제본 세트에 대한 연결을 테스트합니다.

개발 환경에서 복제본 세트의 각 호스트에 대해 다음 명령을 실행합니다.

mongosh --host <my-replica-set>/web1.example.com \
      --port 30907
      --ssl \
      --sslAllowInvalidCertificates

프로덕션 환경에서는 복제본 세트 의 각 호스팅하다 에 대해 클라이언트 도구 또는 애플리케이션에 안전하게 연결할 수 있도록 TLS 인증서와 CA를 지정합니다.

mongosh --host <my-replica-set>/web1.example.com \
  --port 30907 \
  --tls \
  --tlsCertificateKeyFile server.pem \
  --tlsCAFile ca-pem

연결에 성공하면 다음과 같은 내용이 표시됩니다.

Enterprise <my-replica-set> [primary]

Kubernetes Operator로 샤딩된 클러스터 를 배포합니다.

샤드 클러스터를 배포하지 않은 경우 지침에 따라 샤딩된 클러스터 를 배포 합니다.

다음 설정을 구성하여 샤딩된 클러스터 에 대해 TLS를 활성화 해야 합니다.

mongos 파드에 대한 외부 서비스를 생성합니다.

외부 리소스 에서 샤딩된 클러스터 를 구성합니다. 설정:

externalAccess: {}

이 설정은 Kubernetes 연산자가 샤딩된 클러스터 의 mongos 파드에 대한 외부 LoadBalancer 서비스를 생성하도록 지시합니다. 외부 서비스는 외부 연결을 위한 진입 점 제공합니다. 값 없이 이 설정을 추가하면 다음 기본값 을 사용하여 외부 서비스가 생성됩니다.

선택적으로 서비스에 값을 추가하거나 기본값을 재정의해야 하는 경우 다음을 지정합니다.

• cloud 제공자 와 관련된 주석 spec.externalAccess.externalService.annotations

• spec.externalAccess.externalService.spec 의 서비스 사양에 대한 재정의.

예시 들어, 다음 설정은 mongos 파드를 노출하는 NodePort 서비스를 생성하도록 샤딩된 클러스터 구성하기 위해 외부 서비스의 기본값 을 재정의합니다.

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

TLS 인증서에 주체 대체 이름을 추가합니다.

각 외부 DNS 이름을 인증서 SAN 에 추가합니다.

각 MongoDB 호스팅하다 다음 SAN을사용합니다.

<my-sharded-cluster>-<shard>-<pod-index>.<external-domain>
<my-sharded-cluster>-config-<pod-index>.<external-domain>
<my-sharded-cluster>-mongos-<pod-index>.<external-domain>

mongos 인스턴스 다음 SAN을 사용합니다:

<my-sharded-cluster>-mongos-<pod-index>-svc-external.<external-domain>

다음 예시 와 유사하게 spec.security.tls.additionalCertificateDomains 설정을 구성합니다. 사용하는 각 TLS 인증서에는 샤드, config 서버 또는 mongos 인스턴스 에 해당하는 SAN이 포함되어야 합니다. Kubernetes Operator가 구성의 유효성을 검사합니다.

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDB
4
metadata:
5
  name: <my-sharded-cluster>
6
spec:
7
  version: "8.0.0"
8
  opsManager:
9
    configMapRef:
10
      name: <configMap.metadata.name>
11
            # Must match metadata.name in ConfigMap file
12
  shardCount: 2
13
  mongodsPerShardCount: 3
14
  mongosCount: 2
15
  configServerCount: 3
16
  credentials: my-secret
17
  type: ShardedCluster
18
  externalAccess: {}
19
  security:
20
    tls:
21
      certsSecretPrefix: <prefix>
22
      additionalCertificateDomains:
23
         - "<external-domain>"
24
...

외부 서비스를 확인합니다.

샤딩된 클러스터 에서 다음 명령을 실행 하여 Kubernetes Operator가 배포서버 서버를 위한 외부 서비스를 생성했는지 확인합니다.

$ kubectl get services

이 명령은 다음 출력과 유사한 서비스 목록을 반환합니다. 클러스터 의 각 mongos 인스턴스 에 대해 Kubernetes Operator는 <pod-name>-<pod-idx>-svc-external 이라는 외부 서비스를 생성합니다. 이 서비스는 외부 서비스 사양에서 제공하는 값 및 재정의에 따라 구성됩니다.

NAME                                              TYPE         CLUSTER-IP     EXTERNAL-IP       PORT(S)           AGE
<my-sharded-cluster>-mongos-0-svc-external    LoadBalancer   10.102.27.116  <lb-ip-or-fqdn>   27017:27017/TCP    8m30s
<my-sharded-cluster>-mongos-1-svc-external    LoadBalancer   10.102.27.116  <lb-ip-or-fqdn>   27017:27017/TCP    8m30s

클러스터 구성 또는 cloud 제공자 에 따라 LoadBalancer 서비스의 IP 주소 외부에서 액세스할 수 있는 IP 주소 또는 FQDN입니다. IP 주소 또는 FQDN을 사용하여 외부 도메인의 트래픽을 라우팅할 수 있습니다. 이 예시 에는 두 개의 mongos 인스턴스가 있으므로 Kubernetes Operator는 두 개의 외부 서비스를 생성합니다.

샤딩된 클러스터 에 대한 연결을 테스트합니다.

Kubernetes 클러스터 외부에서 배포서버 서버에 연결하려면 MongoDB Shell (mongosh)을 사용하고 외부 도메인을 통해 노출한 mongos 인스턴스의 주소를 지정합니다.

mongosh ""