安装 MongoDB Enterprise Kubernetes Operator
先决条件和注意事项
在安装Kubernetes Operator 之前,请确保规划安装:
注意
本教程假定您具备一定的 Kubernetes 知识,并提供相关 Kubernetes 文档的链接。 如果您不熟悉 Kubernetes,请先查看该文档。
使用 Kubernetes 安装
安装过程因您想要配置环境的方式而异:
注意
自始至终使用相同的命名空间
默认,Kubernetes Kubernetes OperatorKubernetes集群中的所有资源部署到Kubernetes 命名空间mongodb
。您可以通过编辑 mongodb-enterprise.yaml
中 metadata.namespace
的所有值,将Kubernetes Operator 资源部署到不同的命名空间:
##--- # Source: mongodb-enterprise-operator/templates/serviceaccount.yaml apiVersion: v1 kind: ServiceAccount metadata: name: mongodb-enterprise-operator namespace: production ##--- # Source: mongodb-enterprise-operator/templates/operator.yaml apiVersion: apps/v1 kind: Deployment metadata: name: mongodb-enterprise-operator namespace: production # Example truncated ...
可选:在安装Kubernetes Operator YAML 之前对其进行自定义。
要了解可选的 Kubernetes Operator 安装设置,请参阅Operator kubectl 和 oc 安装设置。
注意
要启用静态容器的公共预览版以提高和简化安全性,请参阅静态容器(公共预览版) 。 当此功能处于公共预览阶段时,我们不建议在生产中使用此功能。
填充<version>
占位符并运行以下kubectl
命令,将所选版本的Kubernetes Operator部署到Kubernetes集群:
kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-enterprise-kubernetes/<version>/mongodb-enterprise.yaml
使用 适用于Kubernetes的MongoDB Helm Charts 。
为Kubernetes添加MongoDB Helm Charts 。
您可以通过运行以下命令在本地添加Kubernetes Operator Helm Chart:
helm repo add mongodb https://mongodb.github.io/helm-charts
在部署 Helm Chart 之前对其进行自定义。
要学习;了解可选的 Kubernetes Operator 安装设置,请参阅Operator Helm 安装设置。
部署Kubernetes Operator。
运行以下helm
命令,将Kubernetes Operator部署到Kubernetes集群中的默认命名空间:
helm install --upgrade enterprise-operator mongodb/enterprise-operator
您可以传递--namespace
和--create-namespace
标志,将Kubernetes Operator部署到非默认命名空间,如下所示:
helm install --upgrade enterprise-operator mongodb/enterprise-operator \ --namespace mongodb \ --create-namespace
使用 Helm 安装特定的每日构建版本
MongoDB 每天都会重建 Kubernetes 操作符映像,以集成最新的安全和操作系统更新。
默认情况下, helm
安装您指定的 Kubernetes 操作符版本的最新版本。
要安装较早的版本,请使用--set build=<build-id>
将版本 ID 指定为参数。 版本 ID 的格式始终为-b<YYYYMMDD>T000000Z
,其中<YYYYMMDD>
是要使用的版本的创建日期。
例子
此示例展示了如何使用最新映像安装 Kubernetes 操作符:
helm install enterprise-operator mongodb/enterprise-operator
此示例展示了如何使用 2021 年 2 月 5 日午夜创建的映像安装 Kubernetes 操作符:
helm install enterprise-operator mongodb/enterprise-operator \ --set build=-b20210205T000000Z
注意
MongoDB 建议使用默认(最新)版本。
使用 OpenShift 安装
开始之前,请确保在将Kubernetes Operator部署到OpenShift时将MANAGED_SECURITY_CONTEXT
标志设立为true
。 该值预定义在 values-openshift.yaml 文件。
安装过程因您想要配置环境的方式而异:
注意
自始至终使用相同的命名空间
默认, Kubernetes Operator 将Kubernetes集群中的所有资源部署到 命名空间mongodb
。您可以通过编辑mongodb-enterprise-openshift.yaml
中metadata.namespace
的所有值,将Kubernetes Operator 资源部署到不同的命名空间:
##--- # Source: mongodb-enterprise-operator/templates/serviceaccount.yaml apiVersion: v1 kind: ServiceAccount metadata: name: enterprise-operator namespace: production ##--- # Source: mongodb-enterprise-operator/templates/operator.yaml apiVersion: apps/v1 kind: Deployment metadata: name: enterprise-operator namespace: production # Example truncated ...
MongoDBEnterprise Kubernetes Operator克隆MongoDB Enterprise Kubernetes Operator存储库。
调用以下 git
命令:
git clone https://github.com/mongodb/mongodb-enterprise-kubernetes.git
导航到您在其中克隆MongoDB EnterpriseMongoDBEnterprise Kubernetes Operator Kubernetes Operator存储库的目录。
例如,如果您将存储库克隆到主目录中,请运行:
cd ~/mongodb-enterprise-kubernetes
为MongoDB部署安装 CustomResourceDefinitions。
调用以下 oc 命令:
oc apply -f crds.yaml
可选:在安装Kubernetes Operator YAML 之前对其进行自定义。
要了解可选的 Kubernetes Operator 安装设置,请参阅Operator kubectl 和 oc 安装设置。
注意
要启用静态容器的公共预览版以提高和简化安全性,请参阅静态容器(公共预览版) 。 当此功能处于公共预览阶段时,我们不建议在生产中使用此功能。
<openshift-pull-secret>
ServiceAccount
在安装之前,将 添加到Kubernetes Operator YAML 中的 定义中。
# Source: mongodb-enterprise-operator/templates/serviceaccount.yaml apiVersion: v1 kind: ServiceAccount metadata: name: enterprise-operator namespace: mongodb imagePullSecrets: - name: <openshift-pull-secret> apiVersion: v1 kind: ServiceAccount metadata: name: mongodb-enterprise-appdb namespace: mongodb imagePullSecrets: - name: <openshift-pull-secret> apiVersion: v1 kind: ServiceAccount metadata: name: mongodb-enterprise-database-pods namespace: mongodb imagePullSecrets: - name: <openshift-pull-secret>
要了解更多信息,请参阅Helm 安装设置中的registry.imagePullSecrets
设置。
使用 适用于Kubernetes的MongoDB Helm Charts 。
您可以使用 Helm 安装 Kubernetes Operator 3。
将MongoDB Helm Charts for Kubernetes存储库添加到 Helm。
helm repo add mongodb https://mongodb.github.io/helm-charts
使用 安装Kuberneteshelm
Operator。
安装 适用于Kubernetes的MongoDB Helm Charts :
helm install enterprise-operator mongodb/enterprise-operator \ --values https://raw.githubusercontent.com/mongodb/helm-charts/main/charts/enterprise-operator/values-openshift.yaml
使用 values-openshift.yaml 设置。要学习;了解可选的 Kubernetes Operator 安装设置,请参阅Operator Helm 安装设置。
注意
要启用静态容器的公共预览版以提高和简化安全性,请参阅静态容器(公共预览版) 。 当此功能处于公共预览阶段时,我们不建议在生产中使用此功能。
使用 Helm 安装特定的每日构建版本
MongoDB 每天都会重建 Kubernetes 操作符映像,以集成最新的安全和操作系统更新。
默认情况下, helm
安装您指定的 Kubernetes 操作符版本的最新版本。
要安装较早的版本,请使用--set build=<build-id>
将版本 ID 指定为参数。 版本 ID 的格式始终为-b<YYYYMMDD>T000000Z
,其中<YYYYMMDD>
是要使用的版本的创建日期。
例子
此示例展示了如何使用最新映像安装 Kubernetes 操作符:
helm install enterprise-operator mongodb/enterprise-operator
此示例展示了如何使用 2021 年 2 月 5 日午夜创建的映像安装 Kubernetes 操作符:
helm install enterprise-operator mongodb/enterprise-operator \ --set build=-b20210205T000000Z
注意
MongoDB 建议使用默认(最新)版本。
验证安装
要验证 Kubernetes 操作符是否正确安装,请运行以下命令并验证输出:
kubectl describe deployments mongodb-enterprise-operator -n <metadata.namespace>
oc describe deployments mongodb-enterprise-operator -n <metadata.namespace>
默认情况下,部署存在于mongodb
命名空间中。 如果出现以下错误消息,请确保使用正确的命名空间:
Error from server (NotFound): deployments.apps "mongodb-enterprise-operator" not found
要对 Kubernetes 操作符进行故障排除,请参阅查看 Kubernetes 操作符的日志和其他故障排除主题。
重要
如果需要删除 Kubernetes 操作符 或命名空间,则必须首先删除 MongoDB 资源。
后续步骤
安装 MongoDB Enterprise Kubernetes Operator 后,您可以: