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。
7. 在确认对话框中点 Uninstall。

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

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

   注意

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

流程

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>

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

      $ oc project <project-name>

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

      $ 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. 以具有特权在项目中为代理部署 CR 的用户身份登录 OpenShift。

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

   新的 Operator 可以识别和管理您之前的代理部署。如果您在 CR 中的 image 或 version 字段中设置了值，Operator 的协调过程会在 Operator 启动时将代理 Pod 升级到对应的镜像。如需更多信息，请参阅 第 6.4 节 “限制代理容器镜像的自动升级”。否则，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.11 安装最新版本的 Operator。更多信息请参阅 第 3.3.2 节 “从 OperatorHub 部署 Operator”。

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

   注意

   通过卸载 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

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

      1. 使用 OpenShift 命令行界面：

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

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

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

   注意

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

6. 根据需要，为升级代理中可用的新功能在 CR 中添加属性。

流程

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。
7. 在确认对话框中点 Uninstall。

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

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

   注意

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