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

流程

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

   1. 使用 OpenShift 命令行界面：

      1. 以具有为代理部署的项目中编辑和部署 CR 的用户身份登录 OpenShift。

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

      2. 编辑 CR。

          oc edit ActiveMQArtemis <CR instance name> -n <namespace>

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

      1. 以具有特权的用户身份登录控制台，以便在代理部署的项目中部署 CR。
      2. 在左侧窗格中，点 Operators Installed Operator。
      3. 点 Red Hat Integration - AMQ Broker for RHEL 8 (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.12.0。

   spec:
      version: '7.12.0'
       ...

   在以下示例中，Operator 将部署中的当前容器镜像升级到最新可用的 7.11.x 镜像。例如，如果您的部署使用 7.11.1 容器镜像，Operator 会自动将镜像升级到 7.11.6，而不是 7.12.0。

   spec:
       version: '7.11'
       ...

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

   spec:
       version: '7'
       ...

   注意

   要在容器镜像的次版本间（例如从 7.11.x 升级到 7.12.x），您需要一个与新容器镜像相同的次版本的 Operator。例如，若要从 7.11.6 升级到 7.12.0，必须安装 7.12.x Operator。

3. 保存 CR。

流程

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

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

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

   1. 使用 OpenShift 命令行界面：

      1. 以具有为代理部署的项目中编辑和部署 CR 的用户身份登录 OpenShift。

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

      2. 编辑 CR。

          oc edit ActiveMQArtemis <CR instance name> -n <namespace>

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

      1. 以具有特权的用户身份登录控制台，以便在代理部署的项目中部署 CR。
      2. 在左侧窗格中，点 Operators Installed Operator。
      3. 点 Red Hat Integration - AMQ Broker for RHEL 8 (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@3cc58e98c905d427d6be214a8df3c2687170f74abeacc33366f91bfc18e69a3a
          initImage: registry.redhat.io/amq7/amq-broker-init-rhel8@227fbe6e428848a0edb8086a00f8d9d993b184392e1f4161febff949ce943cbf
        ...

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 属性指定的版本号值。如需更多信息，请参阅查看代理部署的状态信息。