6.3. 使用 OperatorHub 手动升级 Operator

流程

1. 以集群管理员身份登录 OpenShift Container Platform Web 控制台。
2. 从项目中卸载现有的 AMQ Broker Operator。
3. 在左侧导航菜单中，点 InstalledOperators 。
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.12 安装最新版本的 Operator。更多信息请参阅 第 3.3.2 节 “从 OperatorHub 部署 Operator”。
9. 在左侧导航菜单中，点 InstalledOperators 。
10. 验证安装的 Red Hat Integration - AMQ Broker 实例下显示了正确的版本号。

流程

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

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

   1. 在左侧导航菜单中，点 InstalledOperators 。
   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 标签，这些标签被 Operator 在 7.10.0 中错误地添加到 StatefulSet 选择器中。当 Operator 删除 StatefulSet 时，它还会删除现有代理 pod，这会导致临时代理中断。如果要避免中断，请完成以下步骤删除 StatefulSet 和孤立代理 pod，以便它们继续运行。

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

      $ oc login -u <user>

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

      $ oc project <project-name>

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

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

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

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

      1. 使用 OpenShift 命令行界面：

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

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

         2. 编辑部署的 CR。

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

         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.12 安装最新版本的 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.12 安装最新版本的 Operator。更多信息请参阅 第 3.3.2 节 “从 OperatorHub 部署 Operator”。

4. 如果在主代理 CR 中配置了这些自定义标签，请按照以下步骤卸载现有 Operator，在安装新 Operator 前恢复正确的 pod 标签并从 CR 中删除标签。

   注意

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

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

      1. 在左侧导航菜单中，点 InstalledOperators 。
      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

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

      1. 使用 OpenShift 命令行界面：

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

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

         2. 编辑部署的 CR。

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

         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.12 安装最新版本的 Operator。更多信息请参阅 第 3.3.2 节 “从 OperatorHub 部署 Operator”。

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

   注意

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

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