6.4. 通过指定 AMQ Broker 版本来升级代理容器镜像

流程

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

   1. 使用 OpenShift 命令行界面：

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

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

         Copy to Clipboard Toggle word wrap
      2. 在文本编辑器中，打开用于代理部署的 CR 文件。例如，这可能是之前下载并提取的 Operator 安装存档 deploy/ crs 目录中中包含的 broker_activemqartemis_cr.yaml 文件。

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

      1. 以具有权限的用户身份登录到控制台，以便在用于代理部署的项目中编辑和部署 CR。
      2. 在左侧窗格中，单击 Administration Custom Resource Definitions。
      3. 单击 ActiveMQArtemis CRD。
      4. 点 实例 选项卡。
      5. 查找与项目命名空间对应的 CR 实例。

      6. 对于 CR 实例，点击右侧的 More Options 图标（三个垂直点）。选择 Edit ActiveMQArtemis。

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

2. 要指定要将代理容器镜像升级到的 AMQ Broker 版本，请为 CR 的 spec.version 属性设置值。例如：

   spec:
       version: 7.9.3
       ...

   Copy to Clipboard Toggle word wrap

3. 在 CR 的 spec 部分，找到 upgrade 部分。如果此部分尚未包含在 CR 中，请添加它。

   spec:
       version: 7.9.3
       ...
       upgrades:

   Copy to Clipboard Toggle word wrap

4. 确保 upgrade 部分 包含 enabled 和副 属性。

   spec:
       version: 7.9.3
       ...
       upgrades:
           enabled:
           minor:

   Copy to Clipboard Toggle word wrap

5. 要根据 AMQ Broker 的指定版本启用代理容器镜像升级，请将 enabled 属性的值设置为 true。

   spec:
       version: 7.9.3
       ...
       upgrades:
           enabled: true
           minor:

   Copy to Clipboard Toggle word wrap

6. 要定义代理的升级行为，请为 次 属性设置一个值。

   1. 要允许在 次 AMQ Broker 版本间升级，请将 minor 值设为 true。

      spec:
          version: 7.9.0
          ...
          upgrades:
              enabled: true
              minor: true

      Copy to Clipboard Toggle word wrap

      例如，假设当前代理容器镜像对应于 7.8.0，并且有与为 spec.version 指定的 7.9.0 版本对应的新镜像。在本例中，Operator 确定在 7.8 和 7.9 次版本间有可用的升级。根据上述设置（允许在次版本间升级），Operator 升级代理容器镜像。

      相反，假设当前代理容器镜像与 7.9.0 对应，并且为 spec.version 指定 了一个新 值 7.9.1。如果存在与 7.9.1 对应的镜像，Operator 会确定在 7.9.0 和 7. 9.1 微版本间有可用的升级。根据以上设置，仅允许在次版本间升级，Operator 不会 升级代理容器镜像。

   2. 要允许在 微 AMQ Broker 版本间升级，请将 minor 值设为 false。

      spec:
          version: 7.9.0
          ...
          upgrades:
              enabled: true
              minor: false

      Copy to Clipboard Toggle word wrap

      例如，假设当前代理容器镜像对应于 7.8.0，并且有与为 spec.version 指定的 7.9.0 版本对应的新镜像。在本例中，Operator 确定在 7.8 和 7.9 次版本间有可用的升级。根据前面的设置，这些设置不允许在次版本间升级（即仅在微版本间升级），Operator 不会升级 代理容器镜像。

      相反，假设当前代理容器镜像与 7.9.0 对应，并且为 spec.version 指定 了一个新 值 7.9.1。如果存在与 7.9.1 对应的镜像，Operator 会确定在 7.9.0 和 7. 9.1 微版本间有可用的升级。根据上述设置（允许在微版本间升级），Operator 升级代理容器镜像。

7. 将更改应用到 CR。

   1. 使用 OpenShift 命令行界面：

      1. 保存 CR 文件。

      2. 切换到代理部署的项目。

         $ oc project <project_name>

         Copy to Clipboard Toggle word wrap

      3. 应用 CR。

         $ oc apply -f <path/to/broker_custom_resource_instance>.yaml

         Copy to Clipboard Toggle word wrap

   2. 使用 OpenShift Web 控制台：

      1. 编辑完 CR 后，点击 Save。

   应用 CR 更改时，Operator 首先验证现有部署是否提供了对 spec.version 指定的 AMQ Broker 版本升级。如果您已指定要升级到的 AMQ Broker 的无效版本（例如，尚未可用的版本），Operator 会记录警告信息，并且不再执行进一步操作。

   但是，如果升级到指定版本 ， 且为 upgrade .enabled 和 upgrade .minor 指定的值允许升级，则 Operator 升级部署中的每个代理以使用与新的 AMQ Broker 版本对应的代理容器镜像。

   Operator 使用的代理容器镜像在 Operator 部署的 operator.yaml 配置文件中的 环境变量中定义。环境变量名称包含 AMQ Broker 版本的标识符。例如，环境变量 RELATED_IMAGE_ActiveMQ_Artemis_Broker_Kubernetes_791 对应于 AMQ Broker 7.9.1。

   当 Operator 应用了 CR 更改时，它会重启部署中的每个代理 Pod，以便每个 Pod 使用指定的镜像版本。如果您在部署中有多个代理，一次只能有一个代理 Pod 关闭并重启。