6.3. 使用 OperatorHub 手动升级 Operator

流程

1. 以集群管理员身份登录 OpenShift Container Platform Web 控制台。
2. 从项目中卸载现有的 AMQ Broker Operator。
3. 在左侧导航菜单中，点 Operators Installed Operators。
4. 在页面顶部的 Project 下拉菜单中选择您要卸载 Operator 的项目。
5. 找到您要卸载的 Red Hat Integration - AMQ Broker 实例。

6. 对于 Operator 实例，点右侧的 More Options 图标（三个垂直点）。点击 Uninstall Operator。

   警告

   确保未选中 Delete all operand instance for this operator 复选框。如果选择了此复选框，则在卸载 Operator 时，由 Operator 管理的代理实例会被删除。

7. 在确认对话框中，点 Uninstall。
8. 使用 OperatorHub 为 AMQ Broker 7.13 安装最新版本的 Operator。更多信息请参阅 第 3.3.2 节 “从 OperatorHub 部署 Operator”。
9. 在左侧导航菜单中，点 Operators Installed Operators。
10. 验证安装的 Red Hat Integration - AMQ Broker 实例下显示了正确的版本号。

流程

1. 以集群管理员身份登录 OpenShift Container Platform Web 控制台。

2. 从项目中卸载现有的 AMQ Broker Operator。

   1. 在左侧导航菜单中，点 Operators Installed Operators。
   2. 在页面顶部的 Project 下拉菜单中选择您要卸载 Operator 的项目。
   3. 找到您要卸载的 Red Hat Integration - AMQ Broker 实例。
   4. 对于 Operator 实例，点右侧的 More Options 图标（三个垂直点）。点击 Uninstall Operator。
   5. 在确认对话框中，点 Uninstall。

3. 当您升级 7.10.0 Operator 时，新 Operator 会删除 StatefulSet 来删除自定义和 Operator metering 标签，这些标签在 7.10.0 中被 Operator 错误地添加到 StatefulSet 选择器中。当 Operator 删除 StatefulSet 时，它还会删除现有的代理 pod，这会导致临时代理中断。如果要避免中断，请按照以下步骤删除 StatefulSet 并孤立代理 pod，以便它们继续运行。

   1. 作为包含现有 Operator 部署的项目的管理员登录到 OpenShift Container Platform CLI：

      $ oc login -u <user>

      Copy to Clipboard Toggle word wrap

   2. 切换到要升级 Operator 版本的 OpenShift 项目。

      $ oc project <project-name>

      Copy to Clipboard Toggle word wrap

   3. 使用- cascade=orphan 选项删除 StatefulSet，以孤立代理 pod。在 StatefulSet 被删除后，孤立的代理 pod 会继续运行。

      $ oc delete statefulset <statefulset-name> --cascade=orphan

      Copy to Clipboard Toggle word wrap

4. 检查您的主代理 CR 是否在 deploymentPlan.labels 属性中配置了名为 application 或 ActiveMQArtemis 的标签。

   在 7.10.0 中，可以在 CR 中配置这些自定义标签。这些标签为 Operator 保留，为 pod 分配标签，且无法在 7.10.0 后作为自定义标签添加。如果在 7.10.0 中的主代理 CR 中配置了这些自定义标签，则 pod 上的 Operator 分配标签会被自定义标签覆盖。如果 CR 具有其中任何一个标签，请完成以下步骤，恢复 pod 上的正确标签并从 CR 中删除标签。

   1. 在 OpenShift 命令行界面(CLI)中，运行以下命令来恢复正确的 pod 标签。在以下示例中，'ex-aao' 是部署的 StatefulSet 的名称。

      $ for pod in $(oc get pods | grep -o '^ex-aao[^ ]*'); do oc label --overwrite pods $pod ActiveMQArtemis=ex-aao application=ex-aao-app; done

      Copy to Clipboard Toggle word wrap

   2. 从 CR 中的 deploymentPlan.labels 属性中删除 application 和 ActiveMQArtemis 标签。

      1. 使用 OpenShift 命令行界面：

         1. 以有权在代理部署的项目中部署 CR 的用户身份登录 OpenShift。

            oc login -u <user> -p <password> --server=<host:port>

            Copy to Clipboard Toggle word wrap

         2. 编辑部署的 CR。

            oc edit ActiveMQArtemis <statefulset name> -n <namespace>

            Copy to Clipboard Toggle word wrap
         3. 在 CR 中的 deploymentPlan.labels 元素中，删除任何名为 application 或 ActiveMQArtemis 的自定义标签。
         4. 保存 CR。

      2. 使用 OpenShift Container Platform Web 控制台：

         1. 以有权在代理部署的项目中部署 CR 的用户身份登录控制台。
         2. 在左侧窗格中，单击 Administration Custom Resource Definitions。
         3. 单击 ActiveMQArtemis CRD。
         4. 点 实例 选项卡。
         5. 点代理部署的实例。

         6. 点 YAML 标签。

            在控制台中，会打开 YAML 编辑器，允许您配置 CR 实例。

         7. 在 CR 中的 deploymentPlan.labels 元素中，删除任何名为 application 或 ActiveMQArtemis 的自定义标签。
         8. 点击 Save。

5. 使用 OperatorHub 为 AMQ Broker 7.13 安装最新版本的 Operator。更多信息请参阅 第 3.3.2 节 “从 OperatorHub 部署 Operator”。

   新的 Operator 可以识别和管理您之前的代理部署。如果您在 CR 中的 image 或 version 字段中设置了值，Operator 的协调过程会在 Operator 启动时将代理 Pod 升级到对应的镜像。如需更多信息，请参阅 第 6.6 节 “限制代理容器镜像的自动升级”。否则，Operator 会将每个代理 pod 升级到最新的容器镜像。

   注意

   如果协调过程没有启动，您可以通过扩展部署来启动流程。更多信息请参阅 第 3.4.1 节 “部署基本代理实例”。

6. 根据需要，为升级代理中提供的新功能添加属性到 CR。

流程

1. 以集群管理员身份登录 OpenShift Container Platform Web 控制台。

2. 检查您的主代理 CR 是否在 deploymentPlan.labels 属性中配置了名为 application 或 ActiveMQArtemis 的标签。

   这些标签是为 Operator 为 pod 分配标签，在 7.10.1 后无法使用的标签。如果在主代理 CR 中配置了这些自定义标签，则 pod 上的 Operator 分配标签会被自定义标签覆盖。

3. 如果没有在主代理 CR 中配置这些自定义标签，请使用 OperatorHub 为 AMQ Broker 7.13 安装最新版本的 Operator。更多信息请参阅 第 3.3.2 节 “从 OperatorHub 部署 Operator”。

4. 如果在主代理 CR 中配置了其中任何一个自定义标签，请完成以下步骤，在安装新 Operator 前恢复正确的 pod 标签并从 CR 中删除标签。

   注意

   通过卸载 Operator，您可以在不删除 StatefulSet 的情况下删除自定义标签，这也会删除现有代理 pod 并导致临时代理中断。

   1. 从项目中卸载现有的 AMQ Broker Operator。

      1. 在左侧导航菜单中，点 Operators Installed Operators。
      2. 在页面顶部的 Project 下拉菜单中选择您要卸载 Operator 的项目。
      3. 找到您要卸载的 Red Hat Integration - AMQ Broker 实例。
      4. 对于 Operator 实例，点右侧的 More Options 图标（三个垂直点）。点击 Uninstall Operator。
      5. 在确认对话框中，点 Uninstall。

   2. 在 OpenShift 命令行界面(CLI)中，运行以下命令来恢复正确的 pod 标签。在以下示例中，'ex-aao' 是部署的 StatefulSet 的名称。

      $ for pod in $(oc get pods | grep -o '^ex-aao[^ ]*'); do oc label --overwrite pods $pod ActiveMQArtemis=ex-aao application=ex-aao-app; done

      Copy to Clipboard Toggle word wrap

   3. 从 CR 中的 deploymentPlan.labels 属性中删除 application 和 ActiveMQArtemis 标签。

      1. 使用 OpenShift 命令行界面：

         1. 以有权在代理部署的项目中部署 CR 的用户身份登录 OpenShift。

            oc login -u <user> -p <password> --server=<host:port>

            Copy to Clipboard Toggle word wrap

         2. 编辑部署的 CR。

            oc edit ActiveMQArtemis <statefulset name> -n <namespace>

            Copy to Clipboard Toggle word wrap
         3. 在 CR 中的 deploymentPlan.labels 属性中，删除任何名为 application 或 ActiveMQArtemis 的自定义标签。
         4. 保存 CR 文件。

      2. 使用 OpenShift Container Platform Web 控制台：

         1. 以有权在代理部署的项目中部署 CR 的用户身份登录控制台。
         2. 在左侧窗格中，单击 Administration Custom Resource Definitions。
         3. 单击 ActiveMQArtemis CRD。
         4. 点 实例 选项卡。
         5. 点代理部署的实例。

         6. 点 YAML 标签。

            在控制台中，会打开 YAML 编辑器，允许您配置 CR 实例。

         7. 在 CR 中的 deploymentPlan.labels 属性中，删除任何名为 application 或 ActiveMQArtemis 的自定义标签。
         8. 点击 Save。

5. 使用 OperatorHub 为 AMQ Broker 7.13 安装最新版本的 Operator。更多信息请参阅 第 3.3.2 节 “从 OperatorHub 部署 Operator”。

   新的 Operator 可以识别和管理您之前的代理部署。如果您在 CR 中的 image 或 version 字段中设置了值，Operator 的协调过程会在 Operator 启动时将代理 Pod 升级到对应的镜像。如需更多信息，请参阅 第 6.6 节 “限制代理容器镜像的自动升级”。否则，Operator 会将每个代理 pod 升级到最新的容器镜像。

   注意

   如果协调过程没有启动，您可以通过扩展部署来启动流程。更多信息请参阅 第 3.4.1 节 “部署基本代理实例”。

6. 根据需要，为升级代理中提供的新功能添加属性到 CR。