6.6. 限制代理容器镜像的自动升级

流程

1. 编辑代理部署的主代理 CR 实例。

   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 <CR instance name> -n <namespace>

         Copy to Clipboard Toggle word wrap

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

      1. 以有权在代理部署的项目中部署 CR 的用户身份登录控制台。
      2. 在左侧窗格中，点 Operators Installed Operator。
      3. 点 Red Hat Integration - AMQ Broker for RHEL 9 (Multiarch) operator。
      4. 点 AMQ Broker 选项卡。
      5. 单击 ActiveMQArtemis 实例名称。

      6. 点 YAML 标签。

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

         注意

         在 CR 的 status 部分中，.status.version.brokerVersion 字段显示当前部署的 AMQ Broker 版本。

2. 在 spec.version 属性中，指定 Operator 可以将代理和 init 容器镜像升级到的版本。以下是您可以指定的值示例。

   例子

   在以下示例中，Operator 将部署中的当前容器镜像升级到 7.13.0。

   spec:
      version: '7.13.0'
       ...

   Copy to Clipboard Toggle word wrap

   在以下示例中，Operator 将部署中当前的容器镜像升级到最新可用的 7.12.x 镜像。例如，如果您的部署使用 7.12.1 容器镜像，Operator 会自动将镜像升级到 7.12.4，但不升级到 7.13.1。

   spec:
       version: '7.12'
       ...

   Copy to Clipboard Toggle word wrap

   在以下示例中，Operator 会将部署中的当前容器镜像升级到最新的 7.x.x 镜像。例如，如果您的部署使用 7.12.4 镜像，Operator 会自动将镜像升级到 7.13.1。

   spec:
       version: '7'
       ...

   Copy to Clipboard Toggle word wrap

   注意

   要在容器镜像的次版本间升级，例如从 7.12.x 升级到 7.13.x，您需要一个与新容器镜像相同的次版本的 Operator。例如，要从 7.12.4 升级到 7.13.1，必须安装 7.13.x Operator。

3. 保存 CR。

流程

1. 获取 Operator 可以升级当前镜像的代理和 init 容器镜像的 URL。

   1. 在 Red Hat Catalog 中，打开代理容器组件页面： AMQ Broker for RHEL 9 (Multiarch)。
   2. 在 Architecture 下拉菜单中，选择您的架构。
   3. 在 Tag 下拉菜单中，选择与您要安装的镜像对应的标签。根据发行日期，标签按照时间顺序显示。标签由发行版本和分配的标签组成。
   4. 打开 Get this image 选项卡。
   5. 在 Manifest 字段中，单击 Copy 图标。
   6. 将 URL 粘贴到文本文件中。
   7. 在 Red Hat Catalog 中，打开 init 容器组件页面： AMQ Broker Init for RHEL 9 (Multiarch)
   8. 要获取 init 容器镜像的 URL，请重复后续步骤以获取代理容器镜像的 URL。

2. 编辑代理部署的主代理 CR 实例。

   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 <CR instance name> -n <namespace>

         Copy to Clipboard Toggle word wrap

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

      1. 以有权在代理部署的项目中部署 CR 的用户身份登录控制台。
      2. 在左侧窗格中，点 Operators Installed Operator。
      3. 点 Red Hat Integration - AMQ Broker for RHEL 9 (Multiarch) operator。
      4. 点 AMQ Broker 选项卡。
      5. 单击 ActiveMQArtemis 实例名称。

      6. 点 YAML 标签。

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

   3. 复制您在文本文件中记录的代理和 init 容器镜像的 URL，并将它们插入到 CR 中的 spec.deploymentPlan.image 和 spec.deploymentPlan.initImage 字段中。例如：

      spec:
        ...
        deploymentPlan:
          image: registry.redhat.io/amq7/amq-broker-rhel8@e58d2f652106ccd55d1816acc64efe8905e8737f4d4b5fabca5232aeb3de73a7
          initImage: registry.redhat.io/amq7/amq-broker-init-rhel8@e46a544134cbcf99b4946c93cd6d2816d993933a53bfdf5d76c132a237f35329
        ...

      Copy to Clipboard Toggle word wrap

3. 保存 CR。

   保存 CR 时，Operator 会升级代理以使用新镜像并使用这些镜像，直到您再次更新 spec.deploymentPlan.image 和 spec.deploymentPlan.initImage 属性的值。

4. 如果要防止将来的 Operator 升级重启部署中的代理，请编辑 CR 并指定 spec.version 属性中部署的代理版本号。

   如果 CR 中没有配置 spec.version 属性，则后续的 Operator 升级会导致代理 Pod 重启。pod 重启是必需的，因为新 Operator 将最新的支持的代理版本添加到 StatefulSet 中的标签，除非在 spec.version 属性中明确设置了版本号。

   您可以在代理启动后，在 CR 的 status 部分找到为 spec.version 属性指定的版本号值。如需更多信息，请参阅查看代理部署的状态信息。