从外部 Kubernetes 连接 MongoDB 数据库资源

使用 Kubernetes Operator 部署独立资源。

如果尚未部署独立资源，请按照说明部署一个独立资源。

此操作步骤使用以下示例：

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 服务。外部服务为外部连接提供入口点。添加此不带值的设置会创建具有以下默认值的外部服务：

（可选）如果您需要向服务添加值或覆盖默认值，请指定：

• 特定于您的云提供商的注释，位于 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 Operator 创建一个名为 <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 Pod 创建外部服务。

要从外部资源连接到副本集，请配置spec.externalAccess 设置：

externalAccess: {}

此设置指示Kubernetes Operator 为副本集的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

将主题备用名称添加到 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 集群中的任何节点。如果 pod 在另一个节点上运行，则 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 Pod 创建外部服务。

要从外部资源连接到分片分片集群，请配置spec.externalAccess 设置：

externalAccess: {}

此设置指示Kubernetes Operator 为分片集群中的 mongos Pod 创建外部 LoadBalancer 服务。外部服务为外部连接提供入口点。添加此不带值的设置会创建具有以下默认值的外部服务：

（可选）如果您需要向服务添加值或覆盖默认值，请指定：

• 特定于您的云提供商的注释，位于 spec.externalAccess.externalService.annotations

• 在 spec.externalAccess.externalService.spec 中覆盖服务规范。

示例，以下设置会覆盖用于配置分片集群的外部服务的默认值，从而创建公开 mongos 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

将主题备用名称添加到 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 证书都必须包含分片、配置服务器或 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

根据您的集群配置或云提供商，LoadBalancer 服务的IP解决是外部可访问的IP解决或 FQDN。您可以使用IP解决或 FQDN 路由来自外部域的流量。此示例有两个 mongos 实例，因此Kubernetes Operator 创建两个外部服务。

测试与分分片集群的连接。

要从Kubernetes集群外部连接到您的部署，请使用MongoDB Shell ( mongosh ) 并指定您通过外部域公开的mongos实例的地址。

mongosh ""