Kubernetes Operator 快速入门

为 Kubernetes 添加 MongoDB Helm Charts 存储库到 Helm。

helm repo add mongodb https://mongodb.github.io/helm-charts

安装 MongoDB Enterprise Kubernetes Operator

要使用 Helm Chart 安装 Kubernetes Operator，请参阅存储库说明。

例子

以下命令使用可选的 --create-namespace 选项在 mongodb 命名空间中安装 MongoDB Enterprise Kubernetes Operator。默认情况下，Kubernetes Operator 使用 default 命名空间。

helm install enterprise-operator mongodb/enterprise-operator --namespace mongodb --create-namespace

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

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

kubectl config set-context $(kubectl config current-context) --namespace=mongodb

配置 Kubernetes Operator

1. 转到 Cloud Manager UI 中的 Kubernetes 设置页面。

2. 单击 Create New API Keys 或 Use Existing API Keys。

3. 填写表格。 要了解更多信息，请参阅对 Cloud Manager 的编程访问。

4. 单击 Generate Key and YAML（连接）。

复制并保存 ConfigMap。

复制并保存生成的 config-map.yaml 文件。

示例：

apiVersion: v1
kind: ConfigMap
metadata:
  name: my-project
  namespace: mongodb
data:
  baseUrl: https://cloud.mongodb.com
  projectName: my-project # this is an optional parameter
  orgId: 5ecd252f8c1a75033c74106c # this is a required parameter

要了解更多信息，请参阅参数说明。

复制并保存密钥。

复制并保存生成的 secret.yaml 文件。

示例：

apiVersion: v1
kind: Secret
metadata:
  name: organization-secret
  namespace: mongodb
stringData:
  user: <public_key>
  publicAPIKey: <private_key>

出于安全目的，MongoDB Cloud Manager 仅显示该文件一次。

应用 ConfigMap 和密钥。

运行以下命令：

kubectl apply -f secret.yaml -f config-map.yaml

部署 副本集 资源。

1. 复制并保存以下 YAML 文件：

   apiVersion: mongodb.com/v1
   kind: MongoDB
   metadata:
     name: demo-mongodb-cluster-1
     namespace: mongodb
   spec:
     members: 3
     version: 4.4.5-ent
     type: ReplicaSet
     security:
       authentication:
         enabled: true
         modes: ["SCRAM"]
     cloudManager:
       configMapRef:
         name: my-project
     credentials: organization-secret
     persistent: true
     podSpec:
       podTemplate:
         spec:
          containers:
           - name: mongodb-enterprise-database
             resources:
               limits:
                 cpu: 2
                 memory: 1.5G
               requests:
                 cpu: 1
                 memory: 1G
               persistence:
                 single:
                   storage: 10Gi

2. 运行以下命令：

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

使用数据库用户密码创建密钥

您可以选择使用明文密码或 Base64 编码密码。明文密码使用 stringData.password，Base64 编码密码使用 data.password。

对于明文密码，创建并保存以下 YAML 文件：

apiVersion: v1
kind: Secret
metadata:
  name: mms-user-1-password
  # corresponds to user.spec.passwordSecretKeyRef.name
type: Opaque
stringData:
  password: <my-plain-text-password>
  # corresponds to user.spec.passwordSecretKeyRef.key

对于 Base64 编码密码，创建并保存以下 YAML 文件：

apiVersion: v1
kind: Secret
metadata:
  name: mms-user-1-password
  # corresponds to user.spec.passwordSecretKeyRef.name
type: Opaque
data:
  password: <base-64-encoded-password>
  # corresponds to user.spec.passwordSecretKeyRef.key

创建数据库用户。

1. 复制并保存以下 MongoDB 用户资源规范 文件：

   apiVersion: mongodb.com/v1
   kind: MongoDBUser
   metadata:
     name: mms-scram-user-1
   spec:
     passwordSecretKeyRef:
       name: mms-user-1-password
       # Match to metadata.name of the User Secret
       key: password
     username: "mms-scram-user-1"
     db: "admin" #
     mongodbResourceRef:
       name: "demo-mongodb-cluster-1"
       # Match to MongoDB resource using authenticaiton
     roles:
     - db: "admin"
       name: "clusterAdmin"
     - db: "admin"
       name: "userAdminAnyDatabase"
     - db: "admin"
       name: "readWrite"
     - db: "admin"
       name: "userAdminAnyDatabase"

2. 运行以下命令：

   kubectl apply -f <database-user-conf>.yaml

可选：在 Cloud Manager 或 Ops Manager 中查看新创建的用户。

您可以在 Cloud Manager 或 Ops Manager 中查看新创建的用户：

1. 从项目的 Deployment 视图中，点击 Security 选项卡。

2. 单击 MongoDB Users 嵌套标签页。

连接到 副本集 。

在 Cloud Manager 应用程序中执行以下步骤：

1. 单击左侧导航栏中的 Deployment。

2. 单击要连接到的部署的 。

3. 单击 Connect to this instance（连接）。

4. 在终端中运行连接命令，以连接到部署。