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 서비스를 생성하도록 지시합니다. 외부 서비스는 외부 연결을 위한 진입점을 제공합니다. 값 없이 이 설정을 추가하면 다음 기본값을 사용하여 외부 서비스가 생성됩니다.

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

• 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

클러스터 구성 또는 cloud 제공자 에 따라 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가 외부 LoadBalancer 를 생성하도록 지시합니다. 복제본 세트 의 MongoDB 파드에 대한 서비스입니다. 외부 서비스는 외부 연결을 위한 진입 점 을 제공합니다. 값 없이 이 설정을 추가하면 다음 기본값 을 사용하여 외부 서비스가 생성됩니다.

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

• cloud 제공자 와 관련된 주석 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 서비스를 생성합니다.

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

externalAccess: {}

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

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

• cloud 제공자 와 관련된 주석 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

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

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

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

mongosh ""