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

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

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

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

20
---
21
apiVersion: mongodb.com/v1
22
kind: MongoDB
23
metadata:
24
  name: <my-standalone>
25
spec:
26
  version: "4.2.2-ent"
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 연산자가 독립형 리소스에서 MongoDB Pod에 대한 외부 LoadBalancer 서비스를 생성하도록 지시합니다. 외부 서비스는 외부 연결을 위한 진입점을 제공합니다. 값 없이 이 설정을 추가하면 다음 기본값을 사용하여 외부 서비스가 생성됩니다.

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

• 클라우드 공급자에 특정한 주석, 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 셸(mongosh)을 사용하고 외부 도메인을 통해 노출한 MongoDB Pod 주소를 지정합니다.

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

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

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

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

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

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

externalAccess: {}

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

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

• 클라우드 공급자에 특정한 주석, spec.externalAccess.externalService.annotations

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

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

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

cluster 구성 또는 클라우드 공급자에 따라 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: "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 붙여넣습니다. 섹션의 리소스 파일 끝에 있습니다.

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

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

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 서비스를 생성합니다.

외부 리소스에서 샤드 클러스터에 연결하려면 spec.externalAccess 설정을 구성합니다.

externalAccess: {}

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

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

• 클라우드 공급자에 특정한 주석, spec.externalAccess.externalService.annotations

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

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

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: "4.2.2-ent"
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

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

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

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

mongosh ""