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

步骤

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

   1. 使用 OpenShift 命令行界面：

      1. 以具有编辑和部署 CR 的用户身份登录到 OpenShift，以供代理部署。

         $ 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 图标(three vertical dots)。选择 Edit ActiveMQArtemis。

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

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

   spec:
       version: 7.8.5
       ...

   Copy to Clipboard Toggle word wrap

3. 在 CR 的 spec 部分，找到 upgrade 部分。如果这个部分还没有包含在 CR 中，请添加它。

   spec:
       version: 7.8.5
       ...
       upgrades:

   Copy to Clipboard Toggle word wrap

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

   spec:
       version: 7.8.5
       ...
       upgrades:
           enabled:
           minor:

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

      例如，假设当前代理容器镜像对应于 7.7.0，以及一个与为 spec.version 指定的 7.8.5 版本对应的新镜像。在这种情况下，Operator 决定在 7.7 和 7.8 次版本间有可用的升级。根据前面的设置，允许次版本间的升级，Operator 会升级代理容器镜像。

      相反，假设当前代理容器镜像对应于 7.8.0 和新镜像，对应于为 spec.version 指定的 7.8.5 版本。在这种情况下，Operator 决定在 7.8.0 和 7.8.5 微版本之间有可用的升级。根据前面的设置，这只允许在次版本间升级，Operator 不会 升级代理容器镜像。

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

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

      Copy to Clipboard Toggle word wrap

      例如，假设当前代理容器镜像对应于 7.7.0，以及一个与为 spec.version 指定的 7.8.5 版本对应的新镜像。在这种情况下，Operator 决定在 7.7 和 7.8 次版本间有可用的升级。根据前面的设置，这不允许在次版本之间升级（这只在微版本之间升级），Operator 不会 升级代理容器镜像。

      相反，假设当前代理容器镜像对应于 7.8.0 和新镜像，对应于为 spec.version 指定的 7.8.5 版本。在这种情况下，Operator 决定在 7.8.0 和 7.8.5 微版本之间有可用的升级。根据允许在微版本之间升级的设置，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 使用的 broker 容器镜像在 Operator 部署的 operator.yaml 配置文件的一个环境变量中定义。环境变量名称包括 AMQ Broker 版本的标识符。例如，环境变量 RELATED_IMAGE_ActiveMQ_Artemis_Broker_Kubernetes_781 对应于 AMQ Broker 7.8.1。

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