对于 AI 代理：可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单
Docs 主页
/ /
配置
Docs 主页
/ /
部署数据库资源
/
配置
Docs 主页
/
管理
/
Kubernetes Operator 的控制器
/
部署数据库资源
/
配置

使用 ConfigMap 为每个MongoDB部署创建一个项目

MongoDB Controllers for Kubernetes Operator 使用Kubernetes ConfigMap 链接到单个且唯一的Ops Manager项目。如果引用的项目不存在， Kubernetes Operator 会根据您在 ConfigMap 中提供的 projectName 创建该项目。

要创建 Kubernetes Operator ConfigMap，您可以编辑示例 ConfigMap YAML 文件的几行并应用 ConfigMap。要查看完整示例，请参阅项目.yaml文件。

Alternatively, you can use the MongoDB Cloud Manager UI or the Ops Manager UI to create or choose a project, and automatically generate the ConfigMap YAML file, which you can then apply to your Kubernetes environment.

Considerations

  1. 每个项目只能部署一个 MongoDB 资源。 应用此限制是因为 Ops Manager 仅支持针对每个项目的数据库用户访问的一种身份验证方法。 要了解更多信息，请参阅部署 MongoDB database 资源。

  2. You must pair a MongoDB Controllers for Kubernetes Operator deployment to a unique Ops Manager Project. You can either create a distinct ConfigMap for each MongoDB Controllers for Kubernetes Operator instance you deploy, or you can reuse the same ConfigMap for any number of deployments by omitting the data.projectName from your ConfigMap, so that project names align with deployed resource names. Where a project name is provided in the config map, if that project does not exist yet it will be created.

重要

  • 您可以使用 Kubernetes Operator 通过 Cloud Manager 和 Ops Manager 6.0.x 版或更高版本来部署 MongoDB 资源。

  • 可以使用 Atlas Operator 将 MongoDB 资源部署到 Atlas。

先决条件

  • Kubernetes 版本 1.11 或更高版本或者 Openshift 版本 3.11 或更高版本。

  • 适用于Kubernetes Operator 的MongoDB控制器

    已安装。

使用 ConfigMap 创建一个项目

1

将kubectl 配置为默认命名空间。

如果您尚未执行，请运行以下命令，执行所创建命名空间的所有 kubectl 命令。

注意

MongoDB Ops Manager如果要在多 Kubernetes 集群 部署中部署MongoDB 资源：

  • 将 context 设置为中心集群的名称，例如：kubectl config set context "$MDB_CENTRAL_CLUSTER_FULL_NAME"。

  • 将--namespace设置为您用于多 Kubernetes 集群 MongoDB 部署的相同范围，例如： kubectl config --namespace "mongodb" 。

kubectl config set-context $(kubectl config current-context) --namespace=<metadata.namespace>
2

调用以下命令来创建 ConfigMap。

cat <<EOF | kubectl apply -f -
apiVersion: v1
kind: ConfigMap
metadata:
  name: my-project
  namespace: mongodb
data:
  projectName: myProjectName # this is an optional parameter; when omitted, the Operator creates a project with the resource name
  orgId: 5b890e0feacf0b76ff3e7183 # this is a required parameter
  baseUrl: https://ops.example.com:8443
EOF
键
类型
说明
例子

metadata.name

字符串

Kubernetes 对象的名称。

资源名称必须少于或等于 44 个字符。

此名称必须遵循 RFC1123 命名规范，仅包含小写字母数字字符或 -，并以字母数字字符开头和结尾。

要学习；了解更多信息，请参阅有关名称的Kubernetes文档。

my-project

metadata.namespace

字符串

Kubernetes Operator 在其中创建 资源和其他对象的Kubernetes命名空间。MongoDB

mongodb

data.projectName

字符串

您的 Ops Manager 项目的标签。

The Kubernetes Operator creates the Ops Manager project if it does not exist. If you omit the projectName, the Kubernetes Operator creates a project with the same name as your Kubernetes resource.

如需使用 Cloud Manager 或 Ops Manager 组织中的现有项目，请单击 Cloud Manager 或 Ops Manager 页面左上方的 All Clusters 链接找到 projectName，然后在 Search 框中按名称搜索，或滚动到列表中查找名称。此列表中的每张卡片都代表单个“Cloud Manager 或 Ops Manager 组织和项目”的组合。

myProjectName

data.orgId

字符串

必需。 24 字符的十六进制string ，用于唯一标识您的Cloud Manager或MongoDB Ops Manager组织。

您可以使用 Kubernetes Operator 通过 Cloud Manager 和 Ops Manager 6.0.x 版或更高版本来部署 MongoDB 资源。

可以使用 Atlas Operator 将 MongoDB 资源部署到 Atlas。

Specify an existing Organization:

  1. 查找该组织的 ID。

    点击左侧导航栏中的 Settings。

  2. 将 orgId 复制并粘贴到 URL 中。

    选择您的组织，在浏览器中查看当前 URL，然后复制 <orgId> 占位符中显示的值，如下所示：

    https://ops.example.com:8443/ v2#/org/<orgId>/projects

必须具备组织项目创建者角色才能在现有 Cloud Manager 或 Ops Manager 组织中创建新项目。

如果您提供空字符串作为 orgId，Kubernetes Operator 会创建一个与您的项目同名的组织。

5b890e0feacf0b76ff3e7183

data.baseUrl

字符串

Ops Manager 应用程序的 URL，包括 FQDN 和端口号。

重要提示： 如果您使用MongoDB Ops Manager KubernetesOperator部署MongoDB Ops Manager MongoDBKubernetes，并且 将管理部署在其所部署到的 集群 外部 的 数据库资源，则必须设立data.baseUrl 设置为与spec.configuration.mms.centralUrl 中的MongoDB Ops Manager 设置相同的值 资源规范。要学习；了解更多信息，请参阅管理外部MongoDB部署。

如果使用 Cloud Manager，请将 data.baseUrl 值设置为 https://cloud.mongodb.com。

https://ops.example.com:8443

3

调用以下Kubernetes命令来验证您的ConfigMap。

kubectl describe configmaps <configmap-name>

此命令在 shell 中返回 ConfigMap 描述：

Name:           <configmap-name>
Namespace:      <namespace>
Labels:         <none>
Annotations:    <none>
Data
====
baseUrl:
----
<myOpsManagerURL>
Events:  <none>

使用自定义 CA 连接到启用 HTTPS 的 Ops Manager

您可能已选择使用自己的TLS证书为 Ops Manager 实例启用HTTPS 。 如果您使用自定义证书，则需要将签署该自定义证书的 CA 添加到 Kubernetes Operator。 要添加自定义 CA，请完成以下操作：

1

为证书颁发机构 (CA) 证书创建 ConfigMap。

Kubernetes Operator 需要颁发Ops Manager主机证书的 CA 的根 CA 证书。运行以下命令，在数据库Pod 的同一命名空间中创建包含根 CA 的 ConfigMap：

kubectl -n <metadata.namespace> create configmap <root-ca-configmap-name> \
  --from-file=mms-ca.crt

重要

Kubernetes 操作符要求您在 ConfigMap 中命名 Ops Manager 资源的证书mms-ca.crt 。

2

复制以下示例ConfigMap 的突出显示部分。

1---
2apiVersion: v1
3kind: ConfigMap
4metadata:
5  name: <my-configmap>
6  namespace: <my-namespace>
7data:
8  projectName: <my-ops-manager-project-name> # this is an optional parameter
9  orgId: <org-id> # this is a required parameter
10  baseUrl: https://<my-ops-manager-URL>
11  sslMMSCAConfigMap: <root-ca-configmap-name>
12  sslRequireValidMMSServerCertificates: ‘true’
13...
3

将突出显示的部分添加到项目的 ConfigMap 中。

  1. 调用以下命令，在默认配置编辑器中编辑项目的 ConfigMap：

    kubectl edit configmaps <my-configmap> -n <metadata.namespace>

  2. 在示例ConfigMap中，将突出显示的部分粘贴到项目ConfigMap末尾。

4

指定 TLS 设置

更改以下TLS密钥：

键
类型
说明
例子

sslMMSCAConfigMap

字符串

ConfigMap 的名称 在第一步中创建的证书，其中包含用于签署 主机证书的根 CA MongoDB Ops Manager证书。这会将 CA 证书挂载到 Kubernetes Operator 和数据库资源。

my-root-ca

sslRequireValidMMSServerCertificates

布尔

Forces the Operator to require a valid TLS certificate from Ops Manager.

重要提示：该值必须用单引号括起来，否则操作符将引发错误。

'true'

5

保存更新后的 ConfigMap。

6

调用Kubernetes命令来验证您的 ConfigMap 。

kubectl describe configmaps <my-configmap> -n <metadata.namespace>

重要

始终包含带有 kubectl 的命名空间选项。如果您不指定 选项，kubectl-n 默认使用空命名空间，从而导致部署失败。您必须指定 <metadata.namespace>字段的值。Kubernetes Operator、密钥 和 MongoDB 资源应在同一唯一命名空间中运行。

此命令在 shell 中返回 ConfigMap 描述：

Name:           <my-configmap>
Namespace:      <namespace>
Labels:         <none>
Annotations:    <none>
Data
====
sslMMSCAConfigMap:
----
<root-ca-configmap-name>
sslRequireValidMMSServerCertificates:
----
true
Events:  <none>

后续步骤

现在您已经创建了 ConfigMap，在开始 部署 MongoDB 资源 之前，请 为 Kubernetes Operator 创建档案 。

后退
创建档案
来年
生成 X.509 证书
给本页内容打分

在此页面上