从运营商0.9或更早版本升级

MongoDB 工具

MongoDB工具 >MongoDB Kubernetes运营商 >安装操作员 >从先前版本升级Kubernetes Operator > 从运营商0.9或更早版本升级

在本页面

先决条件
升级Kubernetes运营商
重新创建MongoDB资源并删除0.9版CRD
故障排除

警告

MongoDB Enterprise Kubernetes Operator的0.10版包含重大更改，并且需要一些额外的准备才能升级。以下过程概述了Kubernetes Operator 0.9及更早版本的升级过程。如果您已经在运行0.10或更高版本，请参阅从操作员0.10或更高版本升级以获取升级说明。

在Kubernetes运营商的0.10版本巩固了 MongoDbStandalone，MongoDbShardedCluster和 MongoDbReplicaSet CustomResourceDefinitions成一个单一的CustomResourceDefinition所谓的MongoDB。

重要

以下升级过程使您可以将数据存储在Kubernetes Operator管理的先前部署的持久卷中。如果您不希望保留以前部署中的数据并计划部署新资源，请跳至“ 升级”部分。

前提条件¶

如果尚未安装，请运行以下命令以执行创建kubectl的名称空间中的所有命令：
复制
```
kubectl config set-context $(kubectl config current-context) --namespace=<namespace>
```
验证您.yaml是否拥有已部署的每个MongoDB资源的配置文件。

独立资源

如果您具有独立资源，但没有独立资源.yaml ，请运行以下命令来生成配置文件：
复制
```
kubectl mst <standalone-name> -o yaml > <standalone-conf-name>.yaml
```
副本集资源

如果您具有副本集资源，但没有这些资源的.yaml 配置文件，请运行以下命令来生成配置文件：
复制
```
kubectl get mrs <replicaset-name> -o yaml > <replicaset-conf-name>.yaml
```
分片群集资源

如果您已分片群集资源，但没有.yaml 针对它们的配置文件，请运行以下命令来生成配置文件：
复制
```
kubectl get msc <shardedcluster-name> -o yaml > <shardedcluster-conf-name>.yaml
```

编辑每个.yaml与新的CustomResourceDefinition匹配的配置文件：

更改kind为MongoDB
添加spec.type字段，并将它设置为Standalone， ReplicaSet或ShardedCluster根据您的资源。

注意

Kubernetes Operator不支持更改现有配置的类型，即使它会接受其他类型的有效配置。

例如，如果您的MongoDB资源是独立资源，则不能将spec.typeto 的值ReplicaSet设置为 set spec.members。如果这样做，那么Kubernetes Operator会抛出错误，并要求您恢复到以前的工作配置。

编辑每个.yaml文件后，它们应类似于以下示例：

单机版
副本集
分片集群

复制

---
apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: <my-standalone>
spec:
  version: 4.2.2-ent
  opsManager:
    configMapRef:
      name: <configMap.metadata.name>
            # Must match metadata.name in ConfigMap file
  credentials: <mycredentials>
  type: Standalone
  persistent: true
...

复制

---
apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: <my-replica-set>
spec:
  members: 3
  version: 4.2.2-ent
  opsManager:
    configMapRef:
      name: <configMap.metadata.name>
            # Must match metadata.name in ConfigMap file
  credentials: <mycredentials>
  type: ReplicaSet
  persistent: true
...

复制

---
apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: <my-sharded-cluster>
spec:
  shardCount: 2
  mongodsPerShardCount: 3
  mongosCount: 2
  configServerCount: 3
  version: 4.2.2-ent
  opsManager:
    configMapRef:
      name: <configMap.metadata.name>
            # Must match metadata.name in ConfigMap file
  credentials: <mycredentials>
  type: ShardedCluster
  persistent: true
...

警告

如果更改该metadata.name字段，则将丢失资源的数据。

升级Kubernetes运算符¶

要从v0.9或更早版本升级到最新版本的Kubernetes Operator：

以下步骤取决于您的环境的配置方式：

Kubernetes
OpenShift

在线使用kubectl
在线使用Helm
使用Helm和Docker脱机

1个

切换到克隆存储库的目录。¶

使用以下命令为MongoDB部署升级CustomResourceDefinitions`kubectl`：¶

复制

kubectl apply -f crds.yaml

您可以编辑Operator YAML文件以在升级之前进一步自定义Operator。¶

mongodb-enterprise.yaml在您喜欢的文本编辑器中打开。

您可能需要添加以下一个或多个选项：

环境变量何时使用

OPERATOR_ENV

运营商部署环境的标签。该env 值会影响默认超时以及日志记录的格式和级别。

如果`OPERATOR_ENV`是	日志级别设置为	日志格式设置为
`dev`	调试	文本
`prod`	信息	json

可接受的值为： dev，prod。

默认值为：prod。

您可以设置以下一对值：

复制

spec.template.spec.containers.name.env.name: OPERATOR_ENV
spec.template.spec.containers.name.env.value: prod

例

复制

spec:
  template:
    spec:
      serviceAccountName: mongodb-enterprise-operator
      containers:
      - name: mongodb-enterprise-operator
        image: <operatorVersionUrl>
        imagePullPolicy: <policyChoice>
        env:
        - name: OPERATOR_ENV
          value: prod

WATCH_NAMESPACE

操作员监视MongoDB Kubernetes资源更改的命名空间。如果此名称空间与默认名称空间不同，请确保操作员的ServiceAccount 可以访问该其他名称空间。

*表示所有名称空间，并且需要分配给ServiceAccount 的 ClusterRole，该mongodb-enterprise-operatorServiceAccount是用于运行Kubernetes Operator的ServiceAccount。

默认值为：<metadata.namespace>。

重要

要在部署Kubernetes Operator 的另一个名称空间中查看Ops Manager和MongoDB Kubernetes资源，请参阅Kubernetes Operator部署范围以获取必须使用的值以及可能必须执行的其他步骤。

您可以设置以下一对值：

复制

spec.template.spec.containers.name.env.name: WATCH_NAMESPACE
spec.template.spec.containers.name.env.value: "<testNamespace>"

例

复制

spec:
  template:
    spec:
      serviceAccountName: mongodb-enterprise-operator
      containers:
      - name: mongodb-enterprise-operator
        image: <operatorVersionUrl>
        imagePullPolicy: <policyChoice>
        env:
        - name: WATCH_NAMESPACE
          value: "<testNamespace>"

MONGODB_ENTERPRISE_DATABASE_IMAGE

URL MongoDB的企业数据库图像Kubernetes运营商部署的。

默认值为 quay.io/mongodb/mongodb-enterprise-database。

复制

spec.template.spec.containers.name.env.name:
MONGODB_ENTERPRISE_DATABASE_IMAGE
spec.template.spec.containers.name.env.value:
quay.io/mongodb/mongodb-enterprise-database

例

复制

spec:
  template:
    spec:
      serviceAccountName: mongodb-enterprise-operator
      containers:
      - name: mongodb-enterprise-operator
        image: <operatorVersionUrl>
        imagePullPolicy: <policyChoice>
        env:
        - name: MONGODB_ENTERPRISE_DATABASE_IMAGE
          value: quay.io/mongodb/mongodb-enterprise-database
        - name: IMAGE_PULL_POLICY
          value: Always

IMAGE_PULL_POLICY

Kubernetes Operator部署的MongoDB Enterprise数据库映像的拉出策略。

可接受的值是Always，IfNotPresent，Never。

默认值为Always。

复制

spec.template.spec.containers.name.env.name:
IMAGE_PULL_POLICY
spec.template.spec.containers.name.env.value:
<policy>

例

复制

spec:
  template:
    spec:
      serviceAccountName: mongodb-enterprise-operator
      containers:
      - name: mongodb-enterprise-operator
        image: <operatorVersionUrl>
        imagePullPolicy: <policyChoice>
        env:
        - name: MONGODB_ENTERPRISE_DATABASE_IMAGE
          value: quay.io/mongodb/mongodb-enterprise-database
        - name: IMAGE_PULL_POLICY
          value: Always

OPS_MANAGER_IMAGE_REPOSITORY

从中下载Ops Manager资源的图像的存储库的URL。

默认值为 quay.io/mongodb/mongodb-enterprise-ops-manager。

复制

spec.template.spec.containers.name.env.name:
OPS_MANAGER_IMAGE_REPOSITORY
spec.template.spec.containers.name.env.value:
quay.io/mongodb/mongodb-enterprise-ops-manager

例

复制

spec:
  template:
    spec:
      serviceAccountName: mongodb-enterprise-operator
      containers:
      - name: mongodb-enterprise-operator
        image: <operatorVersionUrl>
        imagePullPolicy: <policyChoice>
        env:
        - name: OPS_MANAGER_IMAGE_REPOSITORY
          value: quay.io/mongodb/mongodb-enterprise-ops-manager
        - name: OPS_MANAGER_IMAGE_PULL_POLICY
          value: Always

OPS_MANAGER_IMAGE_PULL_POLICY

Kubernetes Operator部署的Ops Manager镜像的拉取策略。

可接受的值是：Always，IfNotPresent，Never。

默认值为Always。

复制

spec.template.spec.containers.name.env.name:
OPS_MANAGER_IMAGE_PULL_POLICY
spec.template.spec.containers.name.env.value:
<policy>

例

复制

spec:
  template:
    spec:
      serviceAccountName: mongodb-enterprise-operator
      containers:
      - name: mongodb-enterprise-operator
        image: <operatorVersionUrl>
        imagePullPolicy: <policyChoice>
        env:
        - name: OPS_MANAGER_IMAGE_REPOSITORY
          value: quay.io/mongodb/mongodb-enterprise-ops-manager
        - name: OPS_MANAGER_IMAGE_PULL_POLICY
          value: Always

INIT_OPS_MANAGER_IMAGE_REPOSITORY

从存储库的URL，可以从该存储库下载包含Ops Manager启动脚本和就绪探测器的initContainer映像。

默认值为 quay.io/mongodb/mongodb-enterprise-ops-manager-init。

复制

spec.template.spec.containers.name.env.name:
INIT_OPS_MANAGER_IMAGE_REPOSITORY
spec.template.spec.containers.name.env.value:
quay.io/mongodb/mongodb-enterprise-ops-manager-init

例

复制

spec:
  template:
    spec:
      serviceAccountName: mongodb-enterprise-operator
      containers:
      - name: mongodb-enterprise-operator
        image: <operatorVersionUrl>
        imagePullPolicy: <policyChoice>
        env:
        - name: INIT_OPS_MANAGER_IMAGE_REPOSITORY
          value: quay.io/mongodb/mongodb-enterprise-ops-manager-init

INIT_OPS_MANAGER_VERSION

包含Ops Manager启动脚本和就绪探测器的initContainer映像的版本。

默认值为latest。

复制

spec.template.spec.containers.name.env.name:
INIT_OPS_MANAGER_VERSION
spec.template.spec.containers.name.env.value:
latest

例

复制

spec:
  template:
    spec:
      serviceAccountName: mongodb-enterprise-operator
      containers:
      - name: mongodb-enterprise-operator
        image: <operatorVersionUrl>
        imagePullPolicy: <policyChoice>
        env:
        - name: INIT_APPDB_VERSION
          value: latest

APPDB_IMAGE_REPOSITORY

从中下载应用程序数据库映像的存储库的URL。

默认值为 quay.io/mongodb/mongodb-enterprise-appdb。

复制

spec.template.spec.containers.name.env.name:
APPDB_IMAGE_REPOSITORY
spec.template.spec.containers.name.env.value:
quay.io/mongodb/mongodb-enterprise-appdb

例

复制

spec:
  template:
    spec:
      serviceAccountName: mongodb-enterprise-operator
      containers:
      - name: mongodb-enterprise-operator
        image: <operatorVersionUrl>
        imagePullPolicy: <policyChoice>
        env:
        - name: APPDB_IMAGE_REPOSITORY
          value: quay.io/mongodb/mongodb-enterprise-appdb

INIT_APPDB_IMAGE_REPOSITORY

从中下载包含应用程序数据库启动脚本和就绪探测器的initContainer映像的存储库的URL。

默认值为 quay.io/mongodb/mongodb-enterprise-appdb-init。

复制

spec.template.spec.containers.name.env.name:
INIT_APPDB_IMAGE_REPOSITORY
spec.template.spec.containers.name.env.value:
quay.io/mongodb/mongodb-enterprise-init-appdb

例

复制

spec:
  template:
    spec:
      serviceAccountName: mongodb-enterprise-operator
      containers:
      - name: mongodb-enterprise-operator
        image: <operatorVersionUrl>
        imagePullPolicy: <policyChoice>
        env:
        - name: INIT_APPDB_IMAGE_REPOSITORY
          value: quay.io/mongodb/mongodb-enterprise-init-appdb

INIT_APPDB_VERSION

包含Ops Manager启动脚本和就绪探测器的initContainer映像的版本。

默认值为latest。

复制

spec.template.spec.containers.name.env.name:
INIT_APPDB_VERSION
spec.template.spec.containers.name.env.value:
latest

例

复制

spec:
  template:
    spec:
      serviceAccountName: mongodb-enterprise-operator
      containers:
      - name: mongodb-enterprise-operator
        image: <operatorVersionUrl>
        imagePullPolicy: <policyChoice>
        env:
        - name: INIT_APPDB_VERSION
          value: latest

使用以下`kubectl`命令升级Kubernetes Operator ：¶

复制

kubectl apply -f mongodb-enterprise.yaml

1个

使用以下`helm`命令升级Kubernetes Operator ：¶

复制

helm template helm_chart > operator.yaml \
-- values helm_chart/values.yaml
kubectl apply -f operator.yaml

您可以在安装前自定义头盔图。要对其进行修改，请向values.yaml文件添加以下一个或多个选项：

设置何时使用

namespace

要使用其他名称空间，您需要指定 namespace。

默认值为：mongodb。

例

复制

# Name of the Namespace to use
namespace: mongodb

operator.env

运营商部署环境的标签。该env 值会影响默认超时以及日志记录的格式和级别。

如果`operator.env`是	日志级别设置为	日志格式设置为
`dev`	调试	文本
`prod`	信息	json

可接受的值为： dev，prod。

默认值为：


	 MongoDB 中文网

MongoDB 工具

从运营商0.9或更早版本升级

前提条件¶

升级Kubernetes运算符¶

切换到克隆存储库的目录。¶

使用以下命令为MongoDB部署升级CustomResourceDefinitionskubectl：¶

您可以编辑Operator YAML文件以在升级之前进一步自定义Operator。¶

使用以下kubectl命令升级Kubernetes Operator ：¶

使用以下helm命令升级Kubernetes Operator ：¶

使用以下命令为MongoDB部署升级CustomResourceDefinitions`kubectl`：¶

使用以下`kubectl`命令升级Kubernetes Operator ：¶

使用以下`helm`命令升级Kubernetes Operator ：¶