在 OpenShift 中部署 AMQ Broker

步骤

1. 在网页浏览器中，导航到 AMQ Broker 7.8.5 补丁的 Software Downloads 页面。
2. 确保将 Version 下拉列表的值设置为 7.8.5，并且选择了 Patches 选项卡。

3. 在 AMQ Broker 7.8.5 .3 Operator 安装和示例文件旁边，点 Download。

   下载 amq-broker-operator-7.8.5-ocp-install-examples.zip 压缩存档会自动开始。

4. 下载完成后，将归档移至您选择的安装目录。以下示例将存档移到名为 ~/broker/operator 的目录。

   $ mkdir ~/broker/operator
   $ mv amq-broker-operator-7.8.5-ocp-install-examples.zip ~/broker/operator

5. 在您选择的安装目录中，提取存档的内容。例如：

   $ cd ~/broker/operator
   $ unzip amq-broker-operator-7.8.5-ocp-install-examples.zip

6. 切换至提取存档时创建的目录。例如：

   $ cd amq-broker-operator-7.8.5-ocp-install-examples

7. 以集群管理员身份登录 OpenShift Container Platform。例如：

   $ oc login -u system:admin

8. 指定要安装 Operator 的项目。您可以创建新项目或切换到现有项目。

   1. 创建一个新项目

      $ oc new-project <project-name>

   2. 或者，切换到现有项目：

      $ oc project <project-name>

9. 指定要与 Operator 搭配使用的服务帐户。

   1. 在您提取的 Operator 归档的部署目录中，打开 service_account.yaml 文件。
   2. 确保 kind 元素设置为 ServiceAccount。
   3. 在 metadata 部分中，为服务帐户分配一个自定义名称，或者使用默认名称。默认名称为 amq-broker-operator。

   4. 在项目中创建服务帐户。

      $ oc create -f deploy/service_account.yaml

10. 为 Operator 指定角色名称。

    1. 打开 role.yaml 文件。此文件指定 Operator 可以使用和修改的资源。
    2. 确保 kind 元素已设置为 Role。
    3. 在 metadata 部分中，为角色分配一个自定义名称，或者使用默认名称。默认名称为 amq-broker-operator。

    4. 在您的项目中创建角色。

       $ oc create -f deploy/role.yaml

11. 为 Operator 指定角色绑定。角色绑定会根据您指定的名称将之前创建的服务帐户绑定到 Operator 角色。

    1. 打开 role_binding.yaml 文件。确保 ServiceAccount 和 Role 的名称 与 service_account.yaml 和 role.yaml 文件中指定的值匹配。例如：

       metadata:
           name: amq-broker-operator
       subjects:
           kind: ServiceAccount
           name: amq-broker-operator
       roleRef:
           kind: Role
           name: amq-broker-operator

    2. 在项目中创建角色绑定。

       $ oc create -f deploy/role_binding.yaml

步骤

1. 在 OpenShift 命令行界面(CLI)中，以集群管理员身份登录 OpenShift。例如：

   $ oc login -u system:admin

2. 切换到您之前为 Operator 部署准备的项目。例如：

   $ oc project <project_name>

3. 切换到之前在之前提取 Operator 安装存档时创建的目录。例如：

   $ cd ~/broker/operator/amq-broker-operator-7.8.5-ocp-install-examples

4. 部署 Operator 中包含的 CRD。在部署和启动 Operator 之前，您必须在 OpenShift 集群中安装 CRD。

   1. 部署主代理 CRD。

      $ oc create -f deploy/crds/broker_activemqartemis_crd.yaml

   2. 部署地址 CRD。

      $ oc create -f deploy/crds/broker_activemqartemisaddress_crd.yaml

   3. 部署 scaledown controller CRD。

      $ oc create -f deploy/crds/broker_activemqartemisscaledown_crd.yaml

5. 将与红帽生态系统目录中用于身份验证的帐户关联的 pull secret 与 OpenShift 项目 的默认、deployer 和 builder 服务帐户链接。

   $ oc secrets link --for=pull default <secret_name>
   $ oc secrets link --for=pull deployer <secret_name>
   $ oc secrets link --for=pull builder <secret_name>

6. 在您下载并提取的 Operator 归档的部署目录中，打开 operator.yaml 文件。

   注意

   在 operator.yaml 文件中，Operator 使用一个由 安全 Hash Algorithm (SHA)值表示的镜像。注释行以数字符号(#)符号开头，表示 SHA 值对应于特定的容器镜像标签。

7. 部署 Operator。

   $ oc create -f deploy/operator.yaml

   在 OpenShift 项目中，Operator 会启动新的 Pod。

   在 OpenShift Container Platform Web 控制台中，Operator Pod 的 Events 选项卡中的信息确认 OpenShift 已部署了 Operator 镜像，已将新容器分配给 OpenShift 集群中的某个节点，并且已启动了新的容器。

   另外，如果您点击 Pod 中的 Logs 选项卡，输出应包括以下行：

   ...
   {"level":"info","ts":1553619035.8302743,"logger":"kubebuilder.controller","msg":"Starting Controller","controller":"activemqartemisaddress-controller"}
   {"level":"info","ts":1553619035.830541,"logger":"kubebuilder.controller","msg":"Starting Controller","controller":"activemqartemis-controller"}
   {"level":"info","ts":1553619035.9306898,"logger":"kubebuilder.controller","msg":"Starting workers","controller":"activemqartemisaddress-controller","worker count":1}
   {"level":"info","ts":1553619035.9311671,"logger":"kubebuilder.controller","msg":"Starting workers","controller":"activemqartemis-controller","worker count":1}

   前面的输出确认新部署的 Operator 与 Kubernetes 通信，代理和寻址的控制器正在运行，并且这些控制器已启动了一些 worker。

步骤

1. 在网页浏览器中，导航到 AMQ Broker 7.8.5 的 Software Downloads 页面。
2. 确保将 Version 下拉列表的值设置为 7.8.5，并且选择了 Releases 选项卡。

3. 在 AMQ Broker 7.8.5 .3 Operator 安装和示例文件旁边，点 Download。

   下载 amq-broker-operator-7.8.5-ocp-install-examples.zip 压缩存档会自动开始。

4. 下载完成后，将归档移至您选择的安装目录。以下示例将存档移到名为 ~/broker/operator 的目录。

   mkdir ~/broker/operator
   mv amq-broker-operator-7.8.5-ocp-install-examples.zip ~/broker/operator

5. 在您选择的安装目录中，提取存档的内容。例如：

   cd ~/broker/operator
   unzip amq-broker-operator-7.8.5-ocp-install-examples.zip

6. 切换到您提取的 Operator 存档的目录。例如：

   cd amq-broker-operator-7.8.5-ocp-install-examples

7. 以集群管理员身份登录 OpenShift Container Platform。例如：

   $ oc login -u system:admin

8. 在 OperatorHub 中安装 Operator。

   $ oc create -f deploy/catalog_resources/activemq-artemis-operatorsource.yaml

   几分钟后，OpenShift Container Platform Web 控制台的 OperatorHub 部分提供了 AMQ Broker 7.8 的 Operator。Operator 的名称是 Red Hat Integration - AMQ Broker。

步骤

1. 以集群管理员身份登录 OpenShift Container Platform Web 控制台。
2. 在左侧导航菜单中点 Operators → OperatorHub。
3. 在 OperatorHub 页面顶部的 Project 下拉菜单中，选择您要在其中部署 Operator 的项目。

4. 在 OperatorHub 页面中，使用 Filter by keyword…​ 找到 Red Hat Integration - AMQ Broker Operator。

   注意

   在 OperatorHub 中，您可能会在其名称中找到多个 Operator 超过 AMQ Broker。确保您点击 Red Hat Integration - AMQ Broker Operator。点此 Operator 时，查看打开的信息窗格。对于 AMQ Broker 7.8，这个 Operator 的最新次要版本标签为 7.8.5-opr-2。

   提供 RHEL 8 镜像的 RHEL 8 镜像的 Operator 被命名为 Red Hat Integration - AMQ Broker，并带有版本 7.8.5-opr-2。

   要确定要选择哪个 Operator，请查看 Red Hat Enterprise Linux Container Compatibility Matrix。

5. 点 Red Hat Integration - AMQ Broker Operator。在出现的对话框中，单击 Install。

6. 在 Install Operator 页面中：

   1. 在 Update Channel 下，通过选择以下单选按钮之一来指定用于跟踪和接收 Operator 的频道：

      • 7.x - 当有可用时，此频道将更新至 7.9。
      • 7.8.x - 这是 Long Term Support(LTS)频道。
   2. 在 Installation Mode 下，确保选择 具有特定命名空间 的单选按钮。
   3. 在 Installed Namespace 下拉菜单中选择您要安装 Operator 的项目。
   4. 在 Approval Strategy 下，确保选中了有权限 Automatic 的单选按钮。这个选项指定 Operator 的更新不需要手动批准安装。
   5. 点 Install。

1. 开始为代理部署配置自定义资源(CR)实例。

   1. 使用 OpenShift 命令行界面：

      1. 以具有部署部署权限的项目中部署 CR 的用户身份登录 OpenShift。

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

      2. 打开名为 broker_activemqartemis_cr.yaml 的示例 CR 文件，该文件包括在您下载并提取的 Operator 安装的 deploy/crs 目录中。

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

      1. 以具有部署部署 CR 的项目中部署 CR 权限的用户身份登录控制台。
      2. 根据主代理 CRD 启动一个新的 CR 实例。在左侧窗格中，单击 Administration → Custom Resource Definitions。
      3. 单击 ActiveMQArtemis CRD。
      4. 点 实例 选项卡。

      5. 单击 Create ActiveMQArtemis。

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

   对于基本代理部署，配置可能类似以下配置。此配置是 broker_activemqartemis_cr.yaml 示例 CR 文件的默认内容。

   apiVersion: broker.amq.io/v2alpha4
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
     application: ex-aao-app
   spec:
       version: 7.8.5
       deploymentPlan:
           size: 1
           image: placeholder
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true

   观察 broker_activemqartemis_cr.yaml 示例 CR 文件中，image 属性被设置为 占位符 的默认值。这个值表示，默认情况下，image 属性没有指定用于部署的代理容器镜像。要了解 Operator 如何确定要使用的适当代理容器镜像，请参阅 第 2.4 节 “Operator 如何选择容器镜像”。

   注意

   在 metadata 部分，您只需要包含 namespace 属性，只有在您 使用 OpenShift Container Platform Web 控制台创建 CR 时才指定一个值。您指定的值是代理部署的 OpenShift 项目的名称。

   注意

   broker_activemqartemis_cr.yaml 示例 CR 使用了 ex-ao 的命名约定。这个命名规则表示 CR 是 AMQ Broker Operator 的示例 资源。AMQ Broker 基于 ActiveMQ Artemis 项目。部署此示例 CR 时，生成的 StatefulSet 使用名称 ex-aao-ss。另外，部署中的代理 Pod 可直接基于 StatefulSet 名称，如 ex-ao-ss-0、ex-aao-ss-1 等等。CR 中的应用程序名称出现在部署中，作为 StatefulSet 上的标签。您可以在 Pod 选择器中使用该标签，例如：

2. size 属性指定要部署的代理数量。值 2 或更高指定集群代理部署。但是，要部署单个代理实例，请确保将值设置为 1。

3. 部署 CR 实例。

   1. 使用 OpenShift 命令行界面：

      1. 保存 CR 文件。

      2. 切换到您要在其中创建代理部署的项目。

         $ oc project <project_name>

      3. 创建 CR 实例。

         $ oc create -f <path/to/custom_resource_instance>.yaml

   2. 使用 OpenShift Web 控制台：

      1. 配置完 CR 后，点 Create。

4. 在 OpenShift Container Platform web 控制台中，点击 Workloads → StatefulSets （OpenShift Container Platform 4.5 或更高版本）或 Applications → StatefulSets (OpenShift Container Platform 3.11)。您会看到一个名为 ex-aao-ss 的新 StatefulSet。

   1. 点 ex-aao-ss StatefulSet。您会看到一个 Pod，对应于您在 CR 中定义的单个代理。
   2. 在 StatefulSet 中，点 Pods 选项卡。点 ex-aao-ss Pod。在正在运行的 Pod 的 Events 选项卡中，您会看到代理容器已启动。Logs 选项卡显示代理本身正在运行。

5. 要测试代理是否正常运行，请访问代理 Pod 上的 shell 来发送一些测试信息。

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

      1. 点 Workloads → Pods （OpenShift Container Platform 4.5 或更高版本）或 Applications → Pod (OpenShift Container Platform 3.11)。
      2. 点 ex-aao-ss Pod。
      3. 点击 Terminal 选项卡。

   2. 使用 OpenShift 命令行界面：

      1. 获取项目的 Pod 名称和内部 IP 地址。

         $ oc get pods -o wide
         
         NAME                          STATUS   IP
         amq-broker-operator-54d996c   Running  10.129.2.14
         ex-aao-ss-0                   Running  10.129.2.15

      2. 访问 broker Pod 的 shell。

         $ oc rsh ex-aao-ss-0

6. 从 shell，使用 artemis 命令来发送一些测试消息。在 URL 中指定代理 Pod 的内部 IP 地址。例如：

   sh-4.2$ ./amq-broker/bin/artemis producer --url tcp://10.129.2.15:61616 --destination queue://demoQueue

   以上命令会在代理上自动创建一个名为 demoQueue 的队列，并将默认数量的 1000 消息发送到队列。

   您应该看到类似如下的输出：

   Connection brokerURL = tcp://10.129.2.15:61616
   Producer ActiveMQQueue[demoQueue], thread=0 Started to calculate elapsed time ...
   
   Producer ActiveMQQueue[demoQueue], thread=0 Produced: 1000 messages
   Producer ActiveMQQueue[demoQueue], thread=0 Elapsed time in second : 3 s
   Producer ActiveMQQueue[demoQueue], thread=0 Elapsed time in milli second : 3492 milli seconds

步骤

1. 打开用于基本代理部署的 CR 文件。

2. 对于集群部署，请确保 deploymentPlan.size 的值为 2 或更高。例如：

   apiVersion: broker.amq.io/v2alpha4
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
     application: ex-aao-app
   spec:
       version: 7.8.5
       deploymentPlan:
           size: 4
           image: placeholder
           ...

   注意

   在 metadata 部分，您只需要包含 namespace 属性，只有在您 使用 OpenShift Container Platform Web 控制台创建 CR 时才指定一个值。您指定的值是代理部署的 OpenShift 项目的名称。

3. 保存修改后的 CR 文件。

4. 以具有部署之前创建基本代理部署的项目中部署 CR 权限的用户身份登录 OpenShift。

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

5. 切换到您之前在其中创建基本代理部署的项目。

   $ oc project <project_name>

6. 在命令行中应用更改：

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

   在 OpenShift Container Platform Web 控制台中，其他代理 Pod 会根据 CR 中指定的数量在项目中启动。默认情况下，在项目中运行的代理是集群。

7. 打开每个 Pod 的 Logs 选项卡。日志显示 OpenShift 在每个代理上建立了集群连接桥接。具体来说，日志输出包括如下行：

   targetConnector=ServerLocatorImpl (identity=(Cluster-connection-bridge::ClusterConnectionBridge@6f13fb88

1. Operator 在代理应用程序容器前运行初始容器。Init 容器 生成默认 的地址设置配置。默认地址设置配置如下所示。

   <address-settings>
       <!--
       if you define auto-create on certain queues, management has to be auto-create
       -->
       <address-setting match="activemq.management#">
           <dead-letter-address>DLQ</dead-letter-address>
           <expiry-address>ExpiryQueue</expiry-address>
           <redelivery-delay>0</redelivery-delay>
           <!--
           with -1 only the global-max-size is in use for limiting
           -->
           <max-size-bytes>-1</max-size-bytes>
           <message-counter-history-day-limit>10</message-counter-history-day-limit>
           <address-full-policy>PAGE</address-full-policy>
           <auto-create-queues>true</auto-create-queues>
           <auto-create-addresses>true</auto-create-addresses>
           <auto-create-jms-queues>true</auto-create-jms-queues>
           <auto-create-jms-topics>true</auto-create-jms-topics>
       </address-setting>
   
       <!-- default for catch all -->
       <address-setting match="#">
           <dead-letter-address>DLQ</dead-letter-address>
           <expiry-address>ExpiryQueue</expiry-address>
           <redelivery-delay>0</redelivery-delay>
           <!--
           with -1 only the global-max-size is in use for limiting
           -->
           <max-size-bytes>-1</max-size-bytes>
           <message-counter-history-day-limit>10</message-counter-history-day-limit>
           <address-full-policy>PAGE</address-full-policy>
           <auto-create-queues>true</auto-create-queues>
           <auto-create-addresses>true</auto-create-addresses>
           <auto-create-jms-queues>true</auto-create-jms-queues>
           <auto-create-jms-topics>true</auto-create-jms-topics>
       </address-setting>
   <address-settings>

2. 如果您在自定义资源(CR)实例中也指定了地址设置配置，则配置的初始容器进程并将其转换为 XML。
3. 根据 CR 中 applyRule 属性的值，Init 容器 合并，或将上面显示的默认地址设置配置替换为您在 CR 中指定的配置。这个合并或替换的结果是代理将使用的最终地址设置配置。
4. 当初始容器生成代理配置（包括地址设置）后，代理应用程序容器将启动。启动时，代理容器从之前由 Init 容器使用的安装目录中复制其配置。您可以检查 broker.xml 配置文件中的地址设置配置。对于正在运行的代理，这个文件位于 /home/jboss/amq-broker/etc 目录中。

步骤

1. 开始配置自定义资源(CR)实例，为代理部署定义地址和队列。

   1. 使用 OpenShift 命令行界面：

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

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

      2. 打开名为 broker_activemqartemisaddress_cr.yaml 的示例 CR 文件，该文件包括在您下载并提取的 Operator 安装的 deploy/crs 目录中。

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

      1. 以具有部署代理部署 CR 权限的用户身份登录控制台。
      2. 根据地址 CRD 启动新的 CR 实例。在左侧窗格中，单击 Administration → Custom Resource Definitions。
      3. 单击 ActiveMQArtemisAddresss CRD。
      4. 点 实例 选项卡。

      5. 单击 Create ActiveMQArtemisAddress。

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

2. 在 CR 的 spec 部分中，添加行来定义地址、队列和路由类型。例如：

   apiVersion: broker.amq.io/v2alpha2
   kind: ActiveMQArtemisAddress
   metadata:
       name: myAddressDeployment0
       namespace: myProject
   spec:
       ...
       addressName: myAddress0
       queueName: myQueue0
       routingType: anycast
       ...

   上述配置定义了名为 myAddress0 的地址，其队列名为 myQueue0，以及任何 广播 路由类型。

   注意

   在 metadata 部分，您只需要包含 namespace 属性，只有在您 使用 OpenShift Container Platform Web 控制台创建 CR 时才指定一个值。您指定的值是代理部署的 OpenShift 项目的名称。

3. 部署 CR 实例。

   1. 使用 OpenShift 命令行界面：

      1. 保存 CR 文件。

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

         $ oc project <project_name>

      3. 创建 CR 实例。

         $ oc create -f <path/to/address_custom_resource_instance>.yaml

   2. 使用 OpenShift Web 控制台：

      1. 配置完 CR 后，点 Create。

4. （可选）要删除之前使用 CR 实例添加到部署中的地址和队列，请使用以下命令：

   $ oc delete -f <path/to/address_custom_resource_instance>.yaml

步骤

1. 开始配置 CR 实例，添加一个死信地址和队列，以接收部署中的每个代理的未发送消息。

   1. 使用 OpenShift 命令行界面：

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

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

      2. 打开名为 broker_activemqartemisaddress_cr.yaml 的示例 CR 文件，该文件包括在您下载并提取的 Operator 安装的 deploy/crs 目录中。

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

      1. 以具有部署代理部署 CR 权限的用户身份登录控制台。
      2. 根据地址 CRD 启动新的 CR 实例。在左侧窗格中，单击 Administration → Custom Resource Definitions。
      3. 单击 ActiveMQArtemisAddresss CRD。
      4. 点 实例 选项卡。

      5. 单击 Create ActiveMQArtemisAddress。

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

2. 在 CR 的 spec 部分，添加行来指定死信地址和队列以接收未发送的消息。例如：

   apiVersion: broker.amq.io/v2alpha2
   kind: ActiveMQArtemisAddress
   metadata:
       name: ex-aaoaddress
   spec:
       ...
       addressName: myDeadLetterAddress
       queueName: myDeadLetterQueue
       routingType: anycast
       ...

   上述配置定义了名为 myDeadLetterAddress 的死信地址，它具有名为 myDeadLetterQueue 和任何广播路由类型的死信队列。

   注意

   在 metadata 部分，您只需要包含 namespace 属性，只有在您 使用 OpenShift Container Platform Web 控制台创建 CR 时才指定一个值。您指定的值是代理部署的 OpenShift 项目的名称。

3. 部署地址 CR 实例。

   1. 使用 OpenShift 命令行界面：

      1. 保存 CR 文件。

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

         $ oc project <project_name>

      3. 创建地址 CR。

         $ oc create -f <path/to/address_custom_resource_instance>.yaml

   2. 使用 OpenShift Web 控制台：

      1. 配置完 CR 后，点 Create。

4. 开始为代理部署配置自定义资源(CR)实例。

   1. 通过示例 CR 文件：

      1. 打开名为 broker_activemqartemis_cr.yaml 的示例 CR 文件，该文件包括在您下载并提取的 Operator 安装的 deploy/crs 目录中。

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

      1. 根据主代理 CRD 启动一个新的 CR 实例。在左侧窗格中，单击 Administration → Custom Resource Definitions。
      2. 单击 ActiveMQArtemis CRD。
      3. 点 实例 选项卡。

      4. 单击 Create ActiveMQArtemis。

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

   对于基本代理部署，配置可能类似以下配置。此配置是 broker_activemqartemis_cr.yaml 示例 CR 文件的默认内容。

   apiVersion: broker.amq.io/v2alpha4
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
     application: ex-aao-app
   spec:
       version: 7.8.5
       deploymentPlan:
           size: 1
           image: placeholder
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true

   观察 broker_activemqartemis_cr.yaml 示例 CR 文件中，image 属性被设置为 占位符 的默认值。这个值表示，默认情况下，image 属性没有指定用于部署的代理容器镜像。要了解 Operator 如何确定要使用的适当代理容器镜像，请参阅 第 2.4 节 “Operator 如何选择容器镜像”。

   注意

   在 metadata 部分，您只需要包含 namespace 属性，只有在您 使用 OpenShift Container Platform Web 控制台创建 CR 时才指定一个值。您指定的值是代理部署的 OpenShift 项目的名称。

5. 在 CR 的 deploymentPlan 部分中，添加一个包含单个 addressSetting 部分的新 addressSettings 部分，如下所示。

   spec:
       version: 7.8.5
       deploymentPlan:
           size: 1
           image: placeholder
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true
           addressSettings:
               addressSetting:

6. 将 match 属性的单个实例添加到 addressSetting 块。指定地址匹配表达式。例如：

   spec:
       version: 7.8.5
       deploymentPlan:
           size: 1
           image: placeholder
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true
           addressSettings:
               addressSetting:
                -  match: myAddress

   匹配

   指定代理应用以下配置的地址 或一组 地址。在本例中，match 属性的值与名为 myAddress 的单个地址对应。

7. 添加与未发送消息相关的属性并指定值。例如：

   spec:
       version: 7.8.5
       deploymentPlan:
           size: 1
           image: placeholder
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true
           addressSettings:
               addressSetting:
                -  match: myAddress
                   deadLetterAddress: myDeadLetterAddress
                   maxDeliveryAttempts: 5

   deadLetterAddress

   代理发送未发送的消息的地址。

   maxDeliveryAttempts

   代理在将消息移动到配置的死信地址前进行的最大交付尝试次数。

   在前面的示例中，如果代理使 5 次失败尝试向以 myAddress 开头的地址发送消息，代理会将消息移到指定的死信地址 myDeadLetterAddress。

8. （可选）应用类似的配置到另一个地址或一组地址。例如：

   spec:
       version: 7.8.5
       deploymentPlan:
           size: 1
           image: placeholder
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true
           addressSettings:
               addressSetting:
                -  match: myAddress
                   deadLetterAddress: myDeadLetterAddress
                   maxDeliveryAttempts: 5
                -  match: 'myOtherAddresses*'
                   deadLetterAddress: myDeadLetterAddress
                   maxDeliveryAttempts: 3

   在本例中，第二个 match 属性的值包含星号通配符。通配符表示上述配置应用到以字符串 myOtherAddresses 开头的任何地址。

   注意

   如果您使用通配符表达式作为 match 属性的值，您必须将该值包括在单引号中，如 'myOtherAddresses*'。

9. 在 addressSettings 部分的开头，添加 applyRule 属性并指定值。例如：

   spec:
       version: 7.8.5
       deploymentPlan:
           size: 1
           image: placeholder
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true
           addressSettings:
               applyRule: merge_all
               addressSetting:
                -  match: myAddress
                   deadLetterAddress: myDeadLetterAddress
                   maxDeliveryAttempts: 5
                -  match: 'myOtherAddresses*'
                   deadLetterAddress: myDeadLetterAddress
                   maxDeliveryAttempts: 3

   applyRule 属性指定 Operator 如何应用您为每个匹配地址或一组地址添加到 CR 中的配置。您可以指定的值有：

   merge_all

   • 对于 CR 中指定的地址设置，以及 与同一地址集合匹配的默认配置：

     • 将默认配置中指定的任何属性值替换为 CR 中指定的任何属性值。
     • 保留在 CR 或 默认配置中唯一标识的任何属性值。在最后的合并配置中包含以上每个内容。
   • 对于在 CR 中指定的地址设置，或者 唯一与特定地址集合匹配的默认配置，请在最终合并的配置中包含它们。

   merge_replace

   • 对于 CR 中指定的地址设置 和 与同一地址集合匹配的默认配置，请在最终合并的配置中包含 CR 中指定的设置。不要 包含默认配置中指定的任何属性，即使这些属性没有在 CR 中指定。
   • 对于在 CR 中指定的地址设置，或者 唯一与特定地址集合匹配的默认配置，请在最终合并的配置中包含它们。

   replace_all

   将默认配置 中指定的所有 地址设置替换为 CR 中指定的所有地址设置。最终，合并的配置与 CR 中指定的相一致。

   注意

   如果没有在 CR 中明确包含 applyRule 属性，Operator 将使用默认值 merge_all。

10. 部署 broker CR 实例。

    1. 使用 OpenShift 命令行界面：

       1. 保存 CR 文件。

       2. 创建 CR 实例。

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

    2. 使用 OpenShift Web 控制台：

       1. 配置完 CR 后，点 Create。

步骤

1. 开始为代理部署配置自定义资源(CR)实例。

   1. 使用 OpenShift 命令行界面：

      1. 以具有部署部署权限的项目中部署 CR 的用户身份登录 OpenShift。

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

      2. 打开名为 broker_activemqartemis_cr.yaml 的示例 CR 文件，该文件包括在您下载并提取的 Operator 安装的 deploy/crs 目录中。

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

      1. 以具有部署部署 CR 的项目中部署 CR 权限的用户身份登录控制台。
      2. 根据主代理 CRD 启动一个新的 CR 实例。在左侧窗格中，单击 Administration → Custom Resource Definitions。
      3. 单击 ActiveMQArtemis CRD。
      4. 点 实例 选项卡。

      5. 单击 Create ActiveMQArtemis。

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

   对于基本代理部署，配置可能类似以下配置。此配置是 broker_activemqartemis_cr.yaml 示例 CR 文件的默认内容。

   apiVersion: broker.amq.io/v2alpha4
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
     application: ex-aao-app
   spec:
       version: 7.8.5
       deploymentPlan:
           size: 1
           image: placeholder
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true

   观察 broker_activemqartemis_cr.yaml 示例 CR 文件中，image 属性被设置为 占位符 的默认值。这个值表示，默认情况下，image 属性没有指定用于部署的代理容器镜像。要了解 Operator 如何确定要使用的适当代理容器镜像，请参阅 第 2.4 节 “Operator 如何选择容器镜像”。

   注意

   在 metadata 部分，您只需要包含 namespace 属性，只有在您 使用 OpenShift Container Platform Web 控制台创建 CR 时才指定一个值。您指定的值是代理部署的 OpenShift 项目的名称。

2. 要指定代理存储要求，在 CR 的 deploymentPlan 部分添加 storage 部分。添加 size 属性并指定值。例如：

   spec:
       version: 7.8.5
       deploymentPlan:
           size: 1
           image: placeholder
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true
           storage:
               size: 4Gi

   storage.size

   每个代理 Pod 所需的持久性卷声明(PVC)大小（以字节为单位）大小（以字节为单位）。只有在将 persistenceEnabled 设置为 true 时，才会应用此属性。您指定的值 必须包含一个 单元。支持字节表示法（例如：K、M、G）或二进制等同数(Ki, Mi, Gi)。

3. 部署 CR 实例。

   1. 使用 OpenShift 命令行界面：

      1. 保存 CR 文件。

      2. 切换到您要在其中创建代理部署的项目。

         $ oc project <project_name>

      3. 创建 CR 实例。

         $ oc create -f <path/to/custom_resource_instance>.yaml

   2. 使用 OpenShift Web 控制台：

      1. 配置完 CR 后，点 Create。

步骤

1. 开始为代理部署配置自定义资源(CR)实例。

   1. 使用 OpenShift 命令行界面：

      1. 以具有部署部署权限的项目中部署 CR 的用户身份登录 OpenShift。

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

      2. 打开名为 broker_activemqartemis_cr.yaml 的示例 CR 文件，该文件包括在您下载并提取的 Operator 安装的 deploy/crs 目录中。

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

      1. 以具有部署部署 CR 的项目中部署 CR 权限的用户身份登录控制台。
      2. 根据主代理 CRD 启动一个新的 CR 实例。在左侧窗格中，单击 Administration → Custom Resource Definitions。
      3. 单击 ActiveMQArtemis CRD。
      4. 点 实例 选项卡。

      5. 单击 Create ActiveMQArtemis。

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

   对于基本代理部署，配置可能类似以下配置。此配置是 broker_activemqartemis_cr.yaml 示例 CR 文件的默认内容。

   apiVersion: broker.amq.io/v2alpha4
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
     application: ex-aao-app
   spec:
       version: 7.8.5
       deploymentPlan:
           size: 1
           image: placeholder
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true

   观察 broker_activemqartemis_cr.yaml 示例 CR 文件中，image 属性被设置为 占位符 的默认值。这个值表示，默认情况下，image 属性没有指定用于部署的代理容器镜像。要了解 Operator 如何确定要使用的适当代理容器镜像，请参阅 第 2.4 节 “Operator 如何选择容器镜像”。

   注意

   在 metadata 部分，您只需要包含 namespace 属性，只有在您 使用 OpenShift Container Platform Web 控制台创建 CR 时才指定一个值。您指定的值是代理部署的 OpenShift 项目的名称。

2. 在 CR 的 deploymentPlan 部分中，添加 resources 部分。添加 限制和请求 子部分。在每个子部分中，添加 cpu 和 memory 属性并指定值。例如：

   spec:
       version: 7.8.5
       deploymentPlan:
           size: 1
           image: placeholder
           requireLogin: false
           persistenceEnabled: true
           journalType: nio
           messageMigration: true
           resources:
               limits:
                   cpu: "500m"
                   memory: "1024M"
               requests:
                   cpu: "250m"
                   memory: "512M"

   limits.cpu

   在部署中的 Pod 中运行的每个代理容器都不能超过这个主机节点 CPU 的使用情况。

   limits.memory

   在部署中的 Pod 中运行的每个代理容器都不能超过这个数量的主机内存用量。

   requests.cpu

   在部署中的 Pod 中运行的每个代理容器都请求这个数量的主机 CPU。这个值是代理容器运行 所需的最小 CPU 量。

   requests.memory

   部署中运行的 Pod 中的每个代理容器都请求这个数量的主机内存。这个值是代理容器运行所需的 最小内存量。

3. 部署 CR 实例。

   1. 使用 OpenShift 命令行界面：

      1. 保存 CR 文件。

      2. 切换到您要在其中创建代理部署的项目。

         $ oc project <project_name>

      3. 创建 CR 实例。

         $ oc create -f <path/to/custom_resource_instance>.yaml

   2. 使用 OpenShift Web 控制台：

      1. 配置完 CR 后，点 Create。

步骤

1. 在您在初始安装过程中下载并提取的 Operator 归档的 deploy/crs 目录中，打开 broker_activemqartis_cr.yaml 自定义资源(CR)文件。

2. 在接收器元素 中，添加命名的接受者。添加 协议和端口 参数。设置值来指定接受者以及每个代理 Pod 上要公开的端口的消息传递协议。例如：

   spec:
   ...
     acceptors:
     - name: my-acceptor
       protocols: amqp
       port: 5672
   ...

   配置的接受者将端口 5672 公开给 AMQP 客户端。下表中显示了您可以为 protocol 参数指定的完整值。

   协议	订阅价值
   核心协议	core
   AMQP	amqp
   OpenWire	OpenWire
   MQTT	mqtt
   STOMP	stomp
   所有支持的协议	all

   注意
   • 对于部署中的每个代理 Pod，Operator 还会创建一个使用端口 61616 的默认接受器。代理集群需要这个默认接受器，并启用了 Core Protocol。
   • 默认情况下，AMQ Broker 管理控制台使用代理 Pod 上的端口 8161。部署中的每个代理 Pod 都有一个专用的服务，可访问控制台。如需更多信息，请参阅 第 5 章 连接到基于 Operator 的代理部署的 AMQ 管理控制台。

3. 要在同一接受者上使用其他协议，请修改 protocol 参数。指定以逗号分隔的协议列表。例如：

   spec:
   ...
     acceptors:
     - name: my-acceptor
       protocols: amqp,openwire
       port: 5672
   ...

   现在，配置的接收器向 AMQP 和 OpenWire 客户端公开端口 5672。

4. 要指定接受器允许的并发客户端连接数量，请添加 connectionAllowed 参数并设置值。例如：

   spec:
   ...
     acceptors:
     - name: my-acceptor
       protocols: amqp,openwire
       port: 5672
       connectionsAllowed: 5
   ...

5. 默认情况下，接受者仅公开给与代理部署相同的 OpenShift 集群中的客户端。若要也向 OpenShift 外部的客户端公开接受者，请添加 expose 参数，并将值设为 true。

   另外，要启用到 OpenShift 外部客户端的安全连接，请添加 sslEnabled 参数，并将值设为 true。

   spec:
   ...
     acceptors:
     - name: my-acceptor
       protocols: amqp,openwire
       port: 5672
       connectionsAllowed: 5
       expose: true
       sslEnabled: true
       ...
   ...

   当您在接收器（或连接器）上启用 SSL（即安全套接字层）安全性时，您可以添加相关配置，例如：

   • 用于在 OpenShift 集群中存储身份验证凭据的机密名称。当您在接受器上启用 SSL 时，需要一个 secret。有关生成此 secret 的更多信息，请参阅 第 4.6.2 节 “保护 broker-client 连接”。
   • 用于安全网络通信的传输层安全(TLS)协议。TLS 是 SSL 的更新、更安全的版本。您可以在 enabledProtocols 参数中指定 TLS 协议。
   • 接受者是否在代理和客户端之间使用双向 TLS（也称为 mutual 身份验证 ）。您可以通过将 require ClientAuth 参数的值设置为 true 来指定此功能。

步骤

1. 打开之前定义 AMQP 接受者的自定义资源(CR)实例。

   1. 使用 OpenShift 命令行界面：

      $ oc edit -f <path/to/custom-resource-instance>.yaml

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

      1. 在左侧导航菜单中点击 Administration → Custom Resource Definitions
      2. 单击 ActiveMQArtemis CRD。
      3. 点 实例 选项卡。
      4. 查找与项目命名空间对应的 CR 实例。

   之前配置的 AMQP 接受器可能类似如下：

   spec:
   ...
     acceptors:
     - name: my-acceptor
       protocols: amqp
       port: 5672
       connectionsAllowed: 5
       expose: true
       sslEnabled: true
   ...

2. 指定代理作为大型消息的 AMQP 消息最小大小（以字节为单位）。例如：

   spec:
   ...
     acceptors:
     - name: my-acceptor
       protocols: amqp
       port: 5672
       connectionsAllowed: 5
       expose: true
       sslEnabled: true
       amqpMinLargeMessageSize: 204800
       ...
   ...

   在前面的示例中，代理配置为接受端口 5672 上的 AMQP 消息。根据 amqpMinLargeMessageSize 的值，如果接受者收到大于或等于 204800 字节的 AMQP 消息（即 200 KB），代理将消息保存为大消息。

   代理将消息保存在用于消息存储的持久性卷(PV)上的大消息目录(/opt/<custom-resource-name>/data/large-messages )中。

   如果没有为 amqpMinLargeMessageSize 属性指定值，则代理使用默认值 102400（即 100 KB）。

   如果将mq pMinLargeMessageSize 设置为 -1，则禁用用于 AMQP 消息的大型消息处理。

1. 当因为部署中的代理 Pod 失败或意图缩减而关闭时，Operator 会自动启动一个缩减控制器来为消息迁移做准备。扩展控制器在与代理集群相同的 OpenShift 项目名称中运行。
2. 缩减控制器自行注册并侦听与项目中的持久性卷声明(PVC)相关的 Kubernetes 事件。

3. 要检查已孤立的持久性卷(PV)，扩展控制器会查看卷声明中的孤立卷。控制器将卷声明中的 或dinal 与您项目中仍运行的代理 Pod（即代理集群）中的代理 Pod 进行比较。

   如果卷声明中的 ordinal 高于代理集群中运行的任何代理 Pod 的 ordinal，则扩展控制器决定在那个或非插件关闭时代理 Pod，且消息传递数据必须迁移到另一个代理 Pod。

4. 缩减控制器启动排空器 Pod。drainer Pod 运行代理并执行消息迁移。然后，drainer Pod 会标识一个替代的代理 Pod，可将孤立消息迁移到该 Pod。

   注意

   部署中必须至少有一个代理 Pod 仍然在部署中运行，以便进行消息迁移。

步骤

1. 在最初下载并提取的 Operator 存储库的 deploy/crs 目录中，打开主代理 CR，broker_activemqartemis_cr.yaml。

2. 在主代理 CR 中，将 messageMigration 和 persistenceEnabled 设置为 true。

   这些设置意味着，当稍后缩减集群代理部署的大小时，Operator 会自动启动扩展控制器，并将信息迁移到仍在运行的代理 Pod 中。

3. 在现有的代理部署中，验证哪些 Pod 正在运行。

   $ oc get pods

   您会看到类似如下的输出。

   activemq-artemis-operator-8566d9bf58-9g25l   1/1   Running   0   3m38s
   ex-aao-ss-0                                  1/1   Running   0   112s
   ex-aao-ss-1                                  1/1   Running   0   8s

   前面的输出显示，有三个 Pod 正在运行：一个用于代理 Operator 本身，以及部署中每个代理的独立 Pod。

4. 登录到每个 Pod，并将一些信息发送到每个代理。

   1. Pod ex-ao-ss-0 有集群 IP 地址 172.17.0.6，运行以下命令：

      $ /opt/amq-broker/bin/artemis producer --url tcp://172.17.0.6:61616 --user admin --password admin

   2. Pod ex-aao-ss-1 具有 172.17.0.7 的集群 IP 地址，运行以下命令：

      $ /opt/amq-broker/bin/artemis producer --url tcp://172.17.0.7:61616 --user admin --password admin

      前面的命令在每个代理上创建一个名为 TEST 的队列，并将 1000 个消息添加到每个队列。

5. 将集群从两个代理缩减到一。

   1. 打开主代理 CR，broker_activemqartemis_cr.yaml。
   2. 在 CR 中，将 deploymentPlan.size 设置为 1。

   3. 在命令行中应用更改：

      $ oc apply -f deploy/crs/broker_activemqartemis_cr.yaml

      您会看到 Pod ex-ao-ss-1 开始关闭。扩展控制器启动相同名称的新排空器 Pod。这个 drainer Pod 还会在将代理 Pod ex-ao-ss-1 的所有消息迁移到集群中的其他代理 Pod 后关闭，即 ex-aao-ss-0。

6. 关闭 drainer Pod 时，检查代理 Pod ex-aao-ss-0 上测试队列的消息数。您会看到队列中的消息数量为 2000，这表示排空 Pod 成功从关闭的代理 Pod 中迁移了 1000 信息。

步骤

1. 在网页浏览器中，导航到 AMQ Broker 7.8.5 补丁的 Software Downloads 页面。
2. 确保将 Version 下拉列表的值设置为 7.8.5，并且选择了 Patches 选项卡。

3. 在 AMQ Broker 7.8.5 .3 Operator 安装和示例文件旁边，点 Download。

   下载 amq-broker-operator-7.8.5-ocp-install-examples.zip 压缩存档会自动开始。

4. 下载完成后，将归档移至您选择的安装目录。以下示例将存档移到名为 ~/broker/operator 的目录。

   mkdir ~/broker/operator
   mv amq-broker-operator-7.8.5-ocp-install-examples.zip ~/broker/operator

5. 在您选择的安装目录中，提取存档的内容。例如：

   cd ~/broker/operator
   unzip amq-broker-operator-7.8.5-ocp-install-examples.zip

6. 以包含现有 Operator 部署的项目的管理员身份登录 OpenShift Container Platform。

   $ oc login -u <user>

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

   $ oc project <project-name>

8. 在您下载并提取的最新 Operator 归档的部署目录中，打开 operator.yaml 文件。

   注意

   在 operator.yaml 文件中，Operator 使用一个由 安全 Hash Algorithm (SHA)值表示的镜像。注释行以数字符号(#)符号开头，表示 SHA 值对应于特定的容器镜像标签。

9. 为之前的 Operator 部署打开 operator.yaml 文件。检查您在之前配置中指定的任何非默认值是否已 在新的 operator.yaml 配置文件中复制。
10. 如果您对 新的 operator.yaml 文件进行了任何更新，请保存文件。

11. 应用更新的 Operator 配置。

    $ oc apply -f deploy/operator.yaml

    OpenShift 会更新项目以使用最新的 Operator 版本。

12. 要重新创建之前的代理部署，请创建一个新的 CR yaml 文件以匹配原始 CR 的目的并应用它。第 3.4.1 节 “部署基本代理实例” 描述了如何在 Operator 安装存档中应用 deploy/crs/broker_activemqartemis_cr.yaml 文件，您可以使用该文件作为新 CR yaml 文件的基础。

步骤

1. 在网页浏览器中，导航到 AMQ Broker 7.8.5 补丁的 Software Downloads 页面。
2. 确保将 Version 下拉列表的值设置为 7.8.5，并且选择了 Patches 选项卡。

3. 在 AMQ Broker 7.8.5 .3 Operator 安装和示例文件旁边，点 Download。

   下载 amq-broker-operator-7.8.5-ocp-install-examples.zip 压缩存档会自动开始。

4. 下载完成后，将归档移至您选择的安装目录。以下示例将存档移到名为 ~/broker/operator 的目录。

   mkdir ~/broker/operator
   mv amq-broker-operator-7.8.5-ocp-install-examples.zip ~/broker/operator

5. 在您选择的安装目录中，提取存档的内容。例如：

   cd ~/broker/operator
   unzip amq-broker-operator-7.8.5-ocp-install-examples.zip

6. 以包含现有 Operator 部署的项目的管理员身份登录 OpenShift Container Platform。

   $ oc login -u <user>

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

   $ oc project <project-name>

8. 在您下载并提取的最新 Operator 归档的部署目录中，打开 operator.yaml 文件。

   注意

   在 operator.yaml 文件中，Operator 使用一个由 安全 Hash Algorithm (SHA)值表示的镜像。注释行以数字符号(#)符号开头，表示 SHA 值对应于特定的容器镜像标签。

9. 为之前的 Operator 部署打开 operator.yaml 文件。检查您在之前配置中指定的任何非默认值是否已 在新的 operator.yaml 配置文件中复制。

   注意

   Operator 的 0.18 版本的 operator.yaml 文件包括环境变量，其名称以 BROKER_IMAGE 开头。不要在 新配置中复制这些环境变量。AMQ Broker 7.8 的 Operator 的最新版本不再使用这些环境变量。

10. 如果您对 新的 operator.yaml 文件进行了任何更新，请保存文件。

11. 应用更新的 Operator 配置。

    $ oc apply -f deploy/operator.yaml

    OpenShift 会更新项目以使用最新的 Operator 版本。

12. 要重新创建之前的代理部署，请创建一个新的 CR yaml 文件以匹配原始 CR 的目的并应用它。第 3.4.1 节 “部署基本代理实例” 描述了如何在 Operator 安装存档中应用 deploy/crs/broker_activemqartemis_cr.yaml 文件，您可以使用该文件作为新 CR yaml 文件的基础。

步骤

1. 在网页浏览器中，导航到 AMQ Broker 7.8.5 补丁的 Software Downloads 页面。
2. 确保将 Version 下拉列表的值设置为 7.8.5，并且选择了 Patches 选项卡。

3. 在 AMQ Broker 7.8.5 .3 Operator 安装和示例文件旁边，点 Download。

   下载 amq-broker-operator-7.8.5-ocp-install-examples.zip 压缩存档会自动开始。

4. 下载完成后，将归档移至您选择的安装目录。以下示例将存档移到名为 ~/broker/operator 的目录。

   mkdir ~/broker/operator
   mv amq-broker-operator-7.8.5-ocp-install-examples.zip ~/broker/operator

5. 在您选择的安装目录中，提取存档的内容。例如：

   cd ~/broker/operator
   unzip amq-broker-operator-7.8.5-ocp-install-examples.zip

6. 以集群管理员身份登录 OpenShift Container Platform。例如：

   $ oc login -u system:admin

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

   $ oc project <project-name>

8. 删除项目中的主代理自定义资源(CR)实例。这也会删除代理部署。例如：

   $ oc delete -f deploy/crs/broker_activemqartemis_cr.yaml

9. 将 OpenShift 集群中的主要代理自定义资源定义(CRD)更新至最新版本。

   $ oc apply -f deploy/crds/broker_activemqartemis_crd.yaml

   注意

   您不需要使用 最新版本的 CRD 来更新集群寻址或扩展控制器。这些 CRD 与之前 Operator 版本中包含的完全兼容。

10. 在您下载并提取的最新 Operator 归档的部署目录中，打开 operator.yaml 文件。

    注意

    在 operator.yaml 文件中，Operator 使用一个由 安全 Hash Algorithm (SHA)值表示的镜像。注释行以数字符号(#)符号开头，表示 SHA 值对应于特定的容器镜像标签。

11. 为之前的 Operator 部署打开 operator.yaml 文件。检查您在之前配置中指定的任何非默认值是否已 在新的 operator.yaml 配置文件中复制。

    注意

    Operator 的 0.17 版本的 operator.yaml 文件包括环境变量，其名称以 BROKER_IMAGE 开头。不要在 新配置中复制这些环境变量。AMQ Broker 7.8 的 Operator 的最新版本不再使用这些环境变量。

12. 如果您对 新的 operator.yaml 文件进行了任何更新，请保存文件。

13. 应用更新的 Operator 配置。

    $ oc apply -f deploy/operator.yaml

    OpenShift 会更新项目以使用最新的 Operator 版本。

14. 要重新创建之前的代理部署，请创建一个新的 CR yaml 文件以匹配原始 CR 的目的并应用它。第 3.4.1 节 “部署基本代理实例” 描述了如何在 Operator 安装存档中应用 deploy/crs/broker_activemqartemis_cr.yaml 文件，您可以使用该文件作为新 CR yaml 文件的基础。

步骤

1. 在网页浏览器中，导航到 AMQ Broker 7.8.5 补丁的 Software Downloads 页面。
2. 确保将 Version 下拉列表的值设置为 7.8.5，并且选择了 Patches 选项卡。

3. 在 AMQ Broker 7.8.5 .3 Operator 安装和示例文件旁边，点 Download。

   下载 amq-broker-operator-7.8.5-ocp-install-examples.zip 压缩存档会自动开始。

4. 下载完成后，将归档移至您选择的安装目录。以下示例将存档移到名为 ~/broker/operator 的目录。

   mkdir ~/broker/operator
   mv amq-broker-operator-7.8.5-ocp-install-examples.zip ~/broker/operator

5. 在您选择的安装目录中，提取存档的内容。例如：

   cd ~/broker/operator
   unzip amq-broker-operator-7.8.5-ocp-install-examples.zip

6. 以集群管理员身份登录 OpenShift Container Platform。例如：

   $ oc login -u system:admin

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

   $ oc project <project-name>

8. 删除项目中的主代理自定义资源(CR)实例。这也会删除代理部署。例如：

   $ oc delete -f deploy/crs/broker_activemqartemis_cr.yaml

9. 将 OpenShift 集群中的主要代理自定义资源定义(CRD)更新至最新版本。

   $ oc apply -f deploy/crds/broker_activemqartemis_crd.yaml

   注意

   您不需要使用 最新版本的 CRD 来更新集群寻址或扩展控制器。这些 CRD 与之前 Operator 版本中包含的完全兼容。

10. 在您下载并提取的最新 Operator 归档的部署目录中，打开 operator.yaml 文件。

    注意

    在 operator.yaml 文件中，Operator 使用一个由 安全 Hash Algorithm (SHA)值表示的镜像。注释行以数字符号(#)符号开头，表示 SHA 值对应于特定的容器镜像标签。

11. 为之前的 Operator 部署打开 operator.yaml 文件。检查您在之前配置中指定的任何非默认值是否已 在新的 operator.yaml 配置文件中复制。

    注意

    Operator 的 0.15 版本的 operator.yaml 文件包括环境变量，其名称以 BROKER_IMAGE 开头。不要在 新配置中复制这些环境变量。AMQ Broker 7.8 的 Operator 的最新版本不再使用这些环境变量。

12. 如果您对 新的 operator.yaml 文件进行了任何更新，请保存文件。

13. 应用更新的 Operator 配置。

    $ oc apply -f deploy/operator.yaml

    OpenShift 会更新项目以使用最新的 Operator 版本。

14. 要重新创建之前的代理部署，请创建一个新的 CR yaml 文件以匹配原始 CR 的目的并应用它。第 3.4.1 节 “部署基本代理实例” 描述了如何在 Operator 安装存档中应用 deploy/crs/broker_activemqartemis_cr.yaml 文件，您可以使用该文件作为新 CR yaml 文件的基础。

步骤

1. 在网页浏览器中，导航到 AMQ Broker 7.8.5 补丁的 Software Downloads 页面。
2. 确保将 Version 下拉列表的值设置为 7.8.5，并且选择了 Patches 选项卡。

3. 在 AMQ Broker 7.8.5 .3 Operator 安装和示例文件旁边，点 Download。

   下载 amq-broker-operator-7.8.5-ocp-install-examples.zip 压缩存档会自动开始。

4. 下载完成后，将归档移至您选择的安装目录。以下示例将存档移到名为 ~/broker/operator 的目录。

   mkdir ~/broker/operator
   mv amq-broker-operator-7.8.5-ocp-install-examples.zip ~/broker/operator

5. 在您选择的安装目录中，提取存档的内容。例如：

   cd ~/broker/operator
   unzip amq-broker-operator-7.8.5-ocp-install-examples.zip

6. 以集群管理员身份登录 OpenShift Container Platform。例如：

   $ oc login -u system:admin

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

   $ oc project <project-name>

8. 删除项目中的主代理自定义资源(CR)实例。这也会删除代理部署。例如：

   $ oc delete -f deploy/crs/broker_activemqartemis_cr.yaml

9. 将 OpenShift 集群中的主要代理自定义资源定义(CRD)更新至最新版本。

   $ oc apply -f deploy/crds/broker_activemqartemis_crd.yaml

10. 将 OpenShift 集群中的 地址 CRD 更新至 AMQ Broker 7.8 中包含的最新版本。

    $ oc apply -f deploy/crds/broker_activemqartemisaddress_crd.yaml

    注意

    您不需要 使用扩展控制器的 CRD 的最新版本更新集群。在 AMQ Broker 7.8 中，此 CRD 与 Operator for AMQ Broker 7.6 一起完全兼容。

11. 在您下载并提取的最新 Operator 归档的部署目录中，打开 operator.yaml 文件。

    注意

    在 operator.yaml 文件中，Operator 使用一个由 安全 Hash Algorithm (SHA)值表示的镜像。注释行以数字符号(#)符号开头，表示 SHA 值对应于特定的容器镜像标签。

12. 为之前的 Operator 部署打开 operator.yaml 文件。检查您在之前配置中指定的任何非默认值是否已 在新的 operator.yaml 配置文件中复制。
13. 如果您对 新的 operator.yaml 文件进行了任何更新，请保存文件。

14. 应用更新的 Operator 配置。

    $ oc apply -f deploy/operator.yaml

    OpenShift 会更新项目以使用最新的 Operator 版本。

步骤

1. 在网页浏览器中，导航到 AMQ Broker 7.8.5 补丁的 Software Downloads 页面。
2. 确保将 Version 下拉列表的值设置为 7.8.5，并且选择了 Patches 选项卡。

3. 在 AMQ Broker 7.8.5 .3 Operator 安装和示例文件旁边，点 Download。

   下载 amq-broker-operator-7.8.5-ocp-install-examples.zip 压缩存档会自动开始。

4. 下载完成后，将归档移至您选择的安装目录。以下示例将存档移到名为 ~/broker/operator 的目录。

   mkdir ~/broker/operator
   mv amq-broker-operator-7.8.5-ocp-install-examples.zip ~/broker/operator

5. 在您选择的安装目录中，提取存档的内容。例如：

   cd ~/broker/operator
   unzip amq-broker-operator-7.8.5-ocp-install-examples.zip

6. 以集群管理员身份登录 OpenShift Container Platform。例如：

   $ oc login -u system:admin

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

   $ oc project <project-name>

8. 删除项目中的主代理自定义资源(CR)实例。这也会删除代理部署。例如：

   $ oc delete -f deploy/crs/broker_v2alpha1_activemqartemis_cr.yaml

9. 将 OpenShift 集群中的主代理自定义资源定义(CRD)更新至 AMQ Broker 7.8 中包含的最新版本。

   $ oc apply -f deploy/crds/broker_activemqartemis_crd.yaml

10. 将 OpenShift 集群中的地址 CRD 更新至 AMQ Broker 7.8 中包含的最新版本。

    $ oc apply -f deploy/crds/broker_activemqartemisaddress_crd.yaml

    注意

    您不需要 使用扩展控制器的 CRD 的最新版本更新集群。在 AMQ Broker 7.8 中，此 CRD 与之前 Operator 版本中包含的完全兼容。

11. 在您下载并提取的最新 Operator 归档的部署目录中，打开 operator.yaml 文件。

    注意

    在 operator.yaml 文件中，Operator 使用一个由 安全 Hash Algorithm (SHA)值表示的镜像。注释行以数字符号(#)符号开头，表示 SHA 值对应于特定的容器镜像标签。

12. 为之前的 Operator 部署打开 operator.yaml 文件。检查您在之前配置中指定的任何非默认值是否已 在新的 operator.yaml 配置文件中复制。
13. 如果您对 新的 operator.yaml 文件进行了任何更新，请保存文件。

14. 应用更新的 Operator 配置。

    $ oc apply -f deploy/operator.yaml

    OpenShift 会更新项目以使用最新的 Operator 版本。

15. 要重新创建之前的代理部署，请创建一个新的 CR yaml 文件以匹配原始 CR 的目的并应用它。第 3.4.1 节 “部署基本代理实例” 描述了如何在 Operator 安装存档中应用 deploy/crs/broker_activemqartemis_cr.yaml 文件，您可以使用该文件作为新 CR yaml 文件的基础。

步骤

1. 以集群管理员身份登录 OpenShift Container Platform Web 控制台。

2. 删除项目中代理部署的主要自定义资源(CR)实例。此操作会删除代理部署。

   1. 在左侧导航菜单中，点 Administration → Custom Resource Definitions。
   2. 在 Custom Resource Definitions 页面上，单击 ActiveMQArtemis CRD。
   3. 点 实例 选项卡。
   4. 查找与项目命名空间对应的 CR 实例。
   5. 对于 CR 实例，在右侧点击 More Options 图标(three vertical dots)。选择 Delete ActiveMQArtemis。

3. 从项目中卸载现有的 AMQ Broker Operator。

   1. 在左侧导航菜单中，点 Operators → Installed Operators。
   2. 在页面顶部的 Project 下拉菜单中选择您要卸载 Operator 的项目。
   3. 找到您要卸载的 Red Hat Integration - AMQ Broker 实例。
   4. 对于 Operator 实例，点击右侧的 More Options 图标(three vertical dots)。点击 Uninstall Operator。
   5. 在确认对话框中点 Uninstall。
4. 使用 OperatorHub 为 AMQ Broker 7.8 安装最新版本的 Operator。如需更多信息，请参阅 第 3.3.3 节 “从 OperatorHub 部署 Operator”。
5. 要重新创建之前的代理部署，请创建一个新的 CR yaml 文件以匹配原始 CR 的目的并应用它。第 3.4.1 节 “部署基本代理实例” 描述了如何在 Operator 安装存档中应用 deploy/crs/broker_activemqartemis_cr.yaml 文件，您可以使用该文件作为新 CR yaml 文件的基础。

步骤

1. 登录到 amq-demo 项目空间或要在其中部署代理的现有项目。

   $ oc login -u <USER_NAME>
   $ oc project <PROJECT_NAME>

2. 根据基本代理的模板创建新代理应用程序。此模板创建的代理是临时的，不支持 SSL。

   $ oc new-app --template=amq-broker-78-basic \
      -p AMQ_PROTOCOL=openwire,amqp,stomp,mqtt,hornetq \
      -p AMQ_QUEUES=demoQueue \
      -p AMQ_ADDRESSES=demoTopic \
      -p AMQ_USER=amq-demo-user \
      -p AMQ_PASSWORD=password \

   基本代理应用程序模板设置下表中显示的环境变量。

   表 7.1. 基本代理应用程序模板

   环境变量	显示名称	订阅价值	描述
   AMQ_PROTOCOL	AMQ 协议	openwire,amqp,stomp,mqtt,hornetq	代理接受的协议
   AMQ_QUEUES	队列	demoQueue	创建名为 demoQueue 的任何广播队列
   AMQ_ADDRESSES	地址	demoTopic	创建名为 demoTopic 的地址（或主题）。默认情况下，此地址没有分配路由类型。
   AMQ_USER	AMQ Username	amq-demo-user	客户端用于连接代理的用户名
   AMQ_PASSWORD	AMQ 密码	password	客户端使用 及用户名连接到代理的密码

步骤

1. 在 OpenShift Container Platform Web 控制台中，单击 Deployments。
2. 点 broker-amq 应用程序。

3. 单击 Deploy。

   注意

   如果应用程序没有部署，您可以点击 Events 选项卡来检查配置。如果错误不正确，请单击 Actions 按钮来编辑部署配置。

4. 部署代理应用程序后，检查代理 Pod 的当前状态。

   1. 点 DeploymentConfig。

   2. 点 broker-amq Pod，然后点 Logs 选项卡验证代理的状态。您应该会看到之前通过应用程序模板创建的队列。

      如果日志显示：

      • 代理正在运行，跳至此步骤的第 9 步。
      • 代理日志没有加载，Pod 状态会显示 ErrImagePull 或 ImagePullBackOff，您的部署配置无法直接从红帽容器注册表中提取指定的代理镜像。在这种情况下，请继续这个过程的第 5 步。

5. 要准备 Pod 用于安装代理容器镜像，请将正在运行的代理数量扩展为 0。

   1. 点 DeploymentConfigs → broker-amq。
   2. 点 Actions → Edit DeploymentConfig。
   3. 在部署配置 .yaml 文件中，将 replicas 属性的值设置为 0。
   4. 点击 Save。
   5. pod 重启，零代理实例正在运行。

6. 安装最新的代理容器镜像。

   1. 在 Web 浏览器中，导航到 Red Hat Container Catalog。
   2. 在搜索框中输入 AMQ Broker。点 Search。

   3. 根据下表中的信息，选择镜像存储库。

      平台（存档）	容器镜像名称	仓库名称
      OpenShift Container Platform(amd64)	用于 RHEL 8 的 AMQ Broker 或 AMQ Broker	amq7/amq-broker 或 amq7/amq-broker-rhel8
      IBM Z 上的 OpenShift Container Platform(s390x)	OpenJDK 11 上的 RHEL 8 AMQ Broker	amq7/amq-broker-openjdk-11-rhel8
      IBM Power Systems(ppc64le)上的 OpenShift Container Platform	OpenJDK 11 上的 RHEL 8 AMQ Broker	amq7/amq-broker-openjdk-11-rhel8

      例如，对于 OpenShift Container Platform 代理容器镜像，点 AMQ Broker。这时将打开 amq7/amq-broker 存储库，最新的镜像版本会自动选择。如果要更改为较早的镜像版本，请单击 Tags 选项卡，然后选择另一个版本标签。

   4. 点 Get this Image 选项卡。

   5. 在通过 注册表令牌进行身份验证 后，请查看 Using OpenShift secrets 部分中的页面说明。以下说明描述了如何将引用添加到代理镜像，以及与 Red Hat Container Registry 中用于身份验证的帐户关联的镜像 pull secret 名称到 Pod 部署配置文件中。

      例如，要在 amq-demo 项目命名空间中引用 broker-amq 部署配置中的代理镜像和 pull secret，请包括类似如下的行：

      apiVersion: apps.openshift.io/v1
      kind: DeploymentConfig
      ..
      metadata:
        name: broker-amq
        namespace: amq-demo
      ..
        spec:
          containers:
              name: broker-amq
              image: 'registry.redhat.io/amq7/amq-broker:7.8'
          ..
          imagePullSecrets:
            - name: {PULL-SECRET-NAME}

   6. 点击 Save。

7. 将最新的代理镜像版本导入到项目命名空间中。例如：

   $ oc import-image amq7/amq-broker:7.8 --from=registry.redhat.io/amq7/amq-broker --confirm

8. 按照前面所述，再次编辑 broker-amq 部署配置。将 replicas 属性的值重新设置为其原始值。

   代理 Pod 重启，所有正在运行的代理都引用新的代理镜像。

9. 点击 Terminal 选项卡访问可以启动代理的 shell，并使用 CLI 来测试发送和接收消息。

   sh-4.2$ ./broker/bin/artemis run
   sh-4.2$ ./broker/bin/artemis producer --destination queue://demoQueue
   Producer ActiveMQQueue[demoQueue], thread=0 Started to calculate elapsed time ...
   
   Producer ActiveMQQueue[demoQueue], thread=0 Produced: 1000 messages
   Producer ActiveMQQueue[demoQueue], thread=0 Elapsed time in second : 4 s
   Producer ActiveMQQueue[demoQueue], thread=0 Elapsed time in milli second : 4584 milli seconds
   sh-4.2$ ./broker/bin/artemis consumer --destination queue://demoQueue
   Consumer:: filter = null
   Consumer ActiveMQQueue[demoQueue], thread=0 wait until 1000 messages are consumed
   Received 1000
   Consumer ActiveMQQueue[demoQueue], thread=0 Consumed: 1000 messages
   Consumer ActiveMQQueue[demoQueue], thread=0 Consumer thread finished

   另外，也可使用 OpenShift 客户端使用 Pod 名称访问 shell，如下例中所示。

   // Get the Pod names and internal IP Addresses
   $ oc get pods -o wide
   
   // Access a broker Pod by name
   $ oc rsh <broker-pod-name>

步骤

1. 为代理密钥存储生成自签名证书：

   $ keytool -genkey -alias broker -keyalg RSA -keystore broker.ks

2. 导出证书以便可以与客户端共享：

   $ keytool -export -alias broker -keystore broker.ks -file broker_cert

3. 为客户端密钥存储生成自签名证书：

   $ keytool -genkey -alias client -keyalg RSA -keystore client.ks

4. 创建导入代理证书的客户端信任存储：

   $ keytool -import -alias broker -keystore client.ts -file broker_cert

5. 从密钥存储导出客户端的证书：

   $ keytool -export -alias client -keystore client.ks -file client_cert

6. 将客户端的导出证书导入到代理 SERVER truststore 中：

   $ keytool -import -alias client -keystore broker.ts -file client_cert

步骤

1. 导航到 OpenShift Web 控制台并登录。
2. 选择 amq-demo 项目空间。
3. 点 Add to Project > Browse Catalog 来列出所有默认镜像流和模板。
4. 使用 Filter 搜索栏，将列表限制为与 amq 匹配的列表。您可能需要点击 See all 来显示所需的应用程序模板。
5. 选择标记为 Red Hat AMQ Broker 7.8（使用 SSL） 的 amq-broker-78-ssl 模板。

6. 在配置中设置以下值，并点 Create。

   表 8.1. 模板示例

   环境变量	显示名称	订阅价值	描述
   AMQ_PROTOCOL	AMQ 协议	openwire,amqp,stomp,mqtt,hornetq	代理接受的协议
   AMQ_QUEUES	队列	demoQueue	创建名为 demoQueue 的任何广播队列
   AMQ_ADDRESSES	地址	demoTopic	创建名为 demoTopic 的地址（或主题）。默认情况下，此地址没有分配路由类型。
   AMQ_USER	AMQ Username	amq-demo-user	客户端使用的用户名
   AMQ_PASSWORD	AMQ 密码	password	客户端使用的密码及用户名
   AMQ_TRUSTSTORE	trust Store Filename	broker.ts	SSL 信任存储文件名
   AMQ_TRUSTSTORE_PASSWORD	信任存储密码	password	创建 Truststore 时使用的密码
   AMQ_KEYSTORE	AMQ Keystore Filename	broker.ks	SSL 密钥存储文件名
   AMQ_KEYSTORE_PASSWORD	AMQ Keystore 密码	password	创建密钥存储时使用的密码

步骤

1. 在 OpenShift Container Platform Web 控制台中，单击 Deployments。
2. 点 broker-amq 部署。
3. 单击 Deploy 以部署应用。

4. 点代理 Pod，然后点 Logs 选项卡验证代理的状态。

   如果代理日志没有加载，Pod 状态显示 ErrImagePull 或 ImagePullBackOff，您的部署配置无法直接从红帽容器注册表中提取指定的代理镜像。在这种情况下，编辑部署配置以引用与 Red Hat Container Registry 中用于身份验证的帐户关联的正确代理镜像名称和镜像 pull secret 名称。然后，您可以导入代理镜像并启动代理。为此，请完成与部署和启动 代理应用程序 类似的步骤。

步骤

1. 单击 Services → broker-amq-tcp-ssl。
2. 点击 Actions → Create a route。
3. 要显示 TLS 参数，请选择 Secure route 复选框。
4. 在 TLS 终止 下拉菜单中选择 Passthrough。此选择将所有通信转发到 AMQ Broker，无需 OpenShift 路由器解密并重新发送它。

5. 要查看路由，请点击 Routes。例如：

   https://broker-amq-tcp-amq-demo.router.default.svc.cluster.local

步骤

1. 导航到 OpenShift Web 控制台并登录。
2. 选择 amq-demo 项目空间。
3. 点击 Add to Project → Browse catalog，以列出所有默认镜像流和模板。
4. 使用 Filter 搜索栏，将列表限制为与 amq 匹配的列表。您可能需要点击 See all 来显示所需的应用程序模板。
5. 选择 amq-broker-78-persistence-ssl 模板，该模板已被标记 Red Hat AMQ Broker 7.8(Persistence)，使用 SSL。

6. 在配置中设置以下值，然后单击 创建。

   表 8.2. 模板示例

   环境变量	显示名称	订阅价值	描述
   AMQ_PROTOCOL	AMQ 协议	openwire,amqp,stomp,mqtt,hornetq	代理接受的协议
   AMQ_QUEUES	队列	demoQueue	创建名为 demoQueue 的任何广播队列
   AMQ_ADDRESSES	地址	demoTopic	创建名为 demoTopic 的地址（或主题）。默认情况下，此地址没有分配路由类型。
   VOLUME_CAPACITY	AMQ 卷大小	1Gi	为日志创建的持久性卷大小
   AMQ_USER	AMQ Username	amq-demo-user	客户端使用的用户名
   AMQ_PASSWORD	AMQ 密码	password	客户端使用的密码及用户名
   AMQ_TRUSTSTORE	trust Store Filename	broker.ts	SSL 信任存储文件名
   AMQ_TRUSTSTORE_PASSWORD	信任存储密码	password	创建 Truststore 时使用的密码
   AMQ_KEYSTORE	AMQ Keystore Filename	broker.ks	SSL 密钥存储文件名
   AMQ_KEYSTORE_PASSWORD	AMQ Keystore 密码	password	创建密钥存储时使用的密码

步骤

1. 在 OpenShift Container Platform web 控制台中点 StatefulSets。
2. 点 broker-amq 部署。
3. 单击 Deploy 以部署应用。

4. 点代理 Pod，然后点 Logs 选项卡验证代理的状态。您应该会看到通过模板创建的队列。

   如果代理日志没有加载，Pod 状态会显示 ErrImagePull 或 ImagePullBackOff，您的配置无法直接从红帽容器注册表中提取指定的代理镜像。在这种情况下，编辑部署配置以引用与 Red Hat Container Registry 中用于身份验证的帐户关联的正确代理镜像名称和镜像 pull secret 名称。然后，您可以导入代理镜像并启动代理。为此，请完成与部署和启动 代理应用程序 类似的步骤。

5. 点 Terminal 选项卡访问可以使用 CLI 发送一些消息的 shell。

   sh-4.2$ ./broker/bin/artemis producer --destination queue://demoQueue
   Producer ActiveMQQueue[demoQueue], thread=0 Started to calculate elapsed time ...
   
   Producer ActiveMQQueue[demoQueue], thread=0 Produced: 1000 messages
   Producer ActiveMQQueue[demoQueue], thread=0 Elapsed time in second : 4 s
   Producer ActiveMQQueue[demoQueue], thread=0 Elapsed time in milli second : 4584 milli seconds
   
   sh-4.2$ ./broker/bin/artemis consumer  --destination queue://demoQueue
   Consumer:: filter = null
   Consumer ActiveMQQueue[demoQueue], thread=0 wait until 1000 messages are consumed
   Received 1000
   Consumer ActiveMQQueue[demoQueue], thread=0 Consumed: 1000 messages
   Consumer ActiveMQQueue[demoQueue], thread=0 Consumer thread finished

   另外，也可使用 OpenShift 客户端使用 Pod 名称访问 shell，如下例中所示。

   // Get the Pod names and internal IP Addresses
   oc get pods -o wide
   
   // Access a broker Pod by name
   oc rsh <broker-pod-name>

6. 现在使用 oc 命令缩减代理。

   $ oc scale statefulset broker-amq --replicas=0
   statefulset "broker-amq" scaled

   您可以使用控制台检查 Pod 计数是否为 0

7. 现在，将代理备份为 1。

   $ oc scale statefulset broker-amq --replicas=1
   statefulset "broker-amq" scaled

8. 使用终端再次消耗消息。例如：

   sh-4.2$ broker/bin/artemis consumer --destination queue://demoQueue
   Consumer:: filter = null
   Consumer ActiveMQQueue[demoQueue], thread=0 wait until 1000 messages are consumed
   Received 1000
   Consumer ActiveMQQueue[demoQueue], thread=0 Consumed: 1000 messages
   Consumer ActiveMQQueue[demoQueue], thread=0 Consumer thread finished

步骤

1. 单击 Services → broker-amq-tcp-ssl。
2. 点击 Actions → Create a route。
3. 要显示 TLS 参数，请选择 Secure route 复选框。
4. 在 TLS 终止 下拉菜单中选择 Passthrough。此选择将所有通信转发到 AMQ Broker，无需 OpenShift 路由器解密并重新发送它。

5. 要查看路由，请点击 Routes。例如：

   https://broker-amq-tcp-amq-demo.router.default.svc.cluster.local

步骤

1. 导航到 OpenShift Web 控制台并登录。
2. 选择 amq-demo 项目空间。
3. 点击 Add to Project > Browse catalog，以列出所有默认镜像流和模板
4. 使用 Filter 搜索栏，将列表限制为与 amq 匹配的列表。点 See all 显示所需的应用程序模板。
5. 选择 amq-broker-78-persistence-clustered 模板，该模板标记为 Red Hat AMQ Broker 7.8（无 SSL，集群）。

6. 在配置中设置以下值，然后单击 创建。

   表 8.3. 模板示例

   环境变量	显示名称	订阅价值	描述
   AMQ_PROTOCOL	AMQ 协议	openwire,amqp,stomp,mqtt,hornetq	代理接受的协议
   AMQ_QUEUES	队列	demoQueue	创建名为 demoQueue 的任何广播队列
   AMQ_ADDRESSES	地址	demoTopic	创建名为 demoTopic 的地址（或主题）。默认情况下，此地址没有分配路由类型。
   VOLUME_CAPACITY	AMQ 卷大小	1Gi	为日志创建的持久性卷大小
   AMQ_CLUSTERED	clustered	true	这需要 true 以确保代理集群
   AMQ_CLUSTER_USER	集群用户	generated	代理用来相互连接的用户名
   AMQ_CLUSTER_PASSWORD	集群密码	generated	代理用来相互连接的密码
   AMQ_USER	AMQ Username	amq-demo-user	客户端使用的用户名
   AMQ_PASSWORD	AMQ 密码	password	客户端使用的密码及用户名

步骤

1. 在 OpenShift Container Platform web 控制台中点 StatefulSets。
2. 点 broker-amq 部署。

3. 单击 Deploy 以部署应用。

   注意

   集群模板的默认副本数为 0。您应该不会看到任何 Pod。

4. 将 Pod 扩展至三个，以创建代理集群。

   $ oc scale statefulset broker-amq --replicas=3
   statefulset "broker-amq" scaled

5. 检查是否有三个 Pod 正在运行。

   $ oc get pods
   NAME           READY     STATUS    RESTARTS   AGE
   broker-amq-0   1/1       Running   0          33m
   broker-amq-1   1/1       Running   0          33m
   broker-amq-2   1/1       Running   0          29m

6. 如果 Pod 状态显示 ErrImagePull 或 ImagePullBackOff，您的部署无法直接从 Red Hat Container Registry 中拉取指定的代理镜像。在这种情况下，编辑 StatefulSet 来引用与 Red Hat Container Registry 中用于身份验证的帐户关联的正确代理镜像名称和镜像 pull secret 名称。然后，您可以导入代理镜像并启动代理。为此，请完成与部署和启动 代理应用程序 类似的步骤。

7. 通过检查日志，验证代理是否已通过新 Pod 集群。

   $ oc logs broker-amq-2

   这会显示新代理的日志，以及代理之间创建的集群桥接条目：

   2018-08-29 07:43:55,779 INFO  [org.apache.activemq.artemis.core.server] AMQ221027: Bridge ClusterConnectionBridge@1b0e9e9d [name=$.artemis.internal.sf.my-cluster.4333c830-ab5f-11e8-afb8-0a580a82006e, queue=QueueImpl[name=$.artemis.internal.sf.my-cluster.4333c830-ab5f-11e8-afb8-0a580a82006e, postOffice=PostOfficeImpl [server=ActiveMQServerImpl::serverUUID=9cedb69d-ab5e-11e8-87a4-0a580a82006c], temp=false]@5e0c0398 targetConnector=ServerLocatorImpl (identity=(Cluster-connection-bridge::ClusterConnectionBridge@1b0e9e9d [name=$.artemis.internal.sf.my-cluster.4333c830-ab5f-11e8-afb8-0a580a82006e, queue=QueueImpl[name=$.artemis.internal.sf.my-cluster.4333c830-ab5f-11e8-afb8-0a580a82006e, postOffice=PostOfficeImpl [server=ActiveMQServerImpl::serverUUID=9cedb69d-ab5e-11e8-87a4-0a580a82006c], temp=false]@5e0c0398 targetConnector=ServerLocatorImpl [initialConnectors=[TransportConfiguration(name=artemis, factory=org-apache-activemq-artemis-core-remoting-impl-netty-NettyConnectorFactory) ?port=61616&host=10-130-0-110], discoveryGroupConfiguration=null]]::ClusterConnectionImpl@806813022[nodeUUID=9cedb69d-ab5e-11e8-87a4-0a580a82006c, connector=TransportConfiguration(name=artemis, factory=org-apache-activemq-artemis-core-remoting-impl-netty-NettyConnectorFactory) ?port=61616&host=10-130-0-108, address=, server=ActiveMQServerImpl::serverUUID=9cedb69d-ab5e-11e8-87a4-0a580a82006c])) [initialConnectors=[TransportConfiguration(name=artemis, factory=org-apache-activemq-artemis-core-remoting-impl-netty-NettyConnectorFactory) ?port=61616&host=10-130-0-110], discoveryGroupConfiguration=null]] is connected

步骤

1. 使用 StatefulSet 选择器在 Pod 间选择，为集群中的每个 Pod 创建常规 Service。要做到这一点，以 .yaml 格式部署一个 Service 模板，如下所示：

   apiVersion: v1
   kind: Service
   metadata:
     annotations:
       description: 'Service for the management console of broker pod XXXX'
     labels:
       app: application2
       application: application2
       template: amq-broker-78-persistence-clustered
     name: amq2-amq-console-XXXX
     namespace: amq75-p-c-ssl-2
   spec:
     ports:
       - name: console-jolokia
         port: 8161
         protocol: TCP
         targetPort: 8161
     selector:
       deploymentConfig: application2-amq
       statefulset.kubernetes.io/pod-name: application2-amq-XXXX
     type: ClusterIP

   在前面的模板中，将 XXXX 替换为您要与该服务关联的代理 Pod 的 ordinal 值。例如，要将 Service 与集群中的第一个 Pod 关联，请将 XXXX 设为 0。要将服务与第二个 Pod 关联，请将 XXXX 设置为 1，以此类推。

   为集群中的每个代理 Pod 保存和部署模板实例。

   注意

   在上面显示的示例模板中，选择器使用 Kubernetes 定义的 Pod 名称。

2. 为每个代理 Pod 创建一个路由，以便 AMQ Broker 管理控制台可以连接到 Pod。

   单击 Routes → Create Route。

   这会打开 Edit Route 页面。

   1. 在 Services 下拉菜单中，选择之前创建的代理服务，将其与 Route 关联，例如 amq2-amq-console-0。
   2. 将 Target Port 设为 8161，为 AMQ Broker 管理控制台启用访问权限。

   3. 要显示 TLS 参数，请选择 Secure route 复选框。

      1. 在 TLS 终止 下拉菜单中选择 Passthrough。

         此选择将所有通信转发到 AMQ Broker，无需 OpenShift 路由器解密并重新发送它。

   4. 点 Create。

      当您创建与其中一个代理 Pod 关联的路由时，生成的 .yaml 文件包括类似如下的行：

      spec:
        host: amq2-amq-console-0-amq75-p-c-2.apps-ocp311.example.com
        port:
          targetPort: console-jolokia
        tls:
          termination: passthrough
        to:
          kind: Service
          name: amq2-amq-console-0
          weight: 100
        wildcardPolicy: None

3. 要访问特定代理实例的管理控制台，请将上方显示 的主机 URL 复制到 Web 浏览器。

步骤

1. 导航到 OpenShift Web 控制台并登录。
2. 选择 amq-demo 项目空间。
3. 点 Add to Project > Browse catalog，以列出所有默认镜像流和模板。
4. 使用 Filter 搜索栏，将列表限制为与 amq 匹配的列表。点 See all 显示所需的应用程序模板。
5. 选择 amq-broker-78-persistence-clustered-ssl 模板，该模板标记为 Red Hat AMQ Broker 7.8（SSL，集群）。

6. 在配置中设置以下值，然后单击 创建。

   表 8.4. 模板示例

   环境变量	显示名称	订阅价值	描述
   AMQ_PROTOCOL	AMQ 协议	openwire,amqp,stomp,mqtt,hornetq	代理接受的协议
   AMQ_QUEUES	队列	demoQueue	创建名为 demoQueue 的任何广播队列
   AMQ_ADDRESSES	地址	demoTopic	创建名为 demoTopic 的地址（或主题）。默认情况下，此地址没有分配路由类型。
   VOLUME_CAPACITY	AMQ 卷大小	1Gi	为日志创建的持久性卷大小
   AMQ_CLUSTERED	clustered	true	这需要 true 以确保代理集群
   AMQ_CLUSTER_USER	集群用户	generated	代理用来相互连接的用户名
   AMQ_CLUSTER_PASSWORD	集群密码	generated	代理用来相互连接的密码
   AMQ_USER	AMQ Username	amq-demo-user	客户端使用的用户名
   AMQ_PASSWORD	AMQ 密码	password	客户端使用的密码及用户名
   AMQ_TRUSTSTORE	trust Store Filename	broker.ts	SSL 信任存储文件名
   AMQ_TRUSTSTORE_PASSWORD	信任存储密码	password	创建 Truststore 时使用的密码
   AMQ_KEYSTORE	AMQ Keystore Filename	broker.ks	SSL 密钥存储文件名
   AMQ_KEYSTORE_PASSWORD	AMQ Keystore 密码	password	创建密钥存储时使用的密码

步骤

1. 在 OpenShift Container Platform web 控制台中点 StatefulSets。
2. 点 broker-amq 部署。

3. 单击 Deploy 以部署应用。

   注意

   集群模板的默认副本数为 0， 因此您不会看到任何 Pod。

4. 将 Pod 扩展至三个，以创建代理集群。

   $ oc scale statefulset broker-amq --replicas=3
   statefulset "broker-amq" scaled

5. 检查是否有三个 Pod 正在运行。

   $ oc get pods
   NAME           READY     STATUS    RESTARTS   AGE
   broker-amq-0   1/1       Running   0          33m
   broker-amq-1   1/1       Running   0          33m
   broker-amq-2   1/1       Running   0          29m

6. 如果 Pod 状态显示 ErrImagePull 或 ImagePullBackOff，您的部署无法直接从 Red Hat Container Registry 中拉取指定的代理镜像。在这种情况下，编辑 StatefulSet 来引用与 Red Hat Container Registry 中用于身份验证的帐户关联的正确代理镜像名称和镜像 pull secret 名称。然后，您可以导入代理镜像并启动代理。为此，请完成与 Deploy 中相似的步骤，并启动代理应用程序。

7. 通过检查日志，验证新 Pod 已集群代理。

   $ oc logs broker-amq-2

   这显示新代理的所有日志以及在代理器中创建的集群桥接条目，例如：

   2018-08-29 07:43:55,779 INFO  [org.apache.activemq.artemis.core.server] AMQ221027: Bridge ClusterConnectionBridge@1b0e9e9d [name=$.artemis.internal.sf.my-cluster.4333c830-ab5f-11e8-afb8-0a580a82006e, queue=QueueImpl[name=$.artemis.internal.sf.my-cluster.4333c830-ab5f-11e8-afb8-0a580a82006e, postOffice=PostOfficeImpl [server=ActiveMQServerImpl::serverUUID=9cedb69d-ab5e-11e8-87a4-0a580a82006c], temp=false]@5e0c0398 targetConnector=ServerLocatorImpl (identity=(Cluster-connection-bridge::ClusterConnectionBridge@1b0e9e9d [name=$.artemis.internal.sf.my-cluster.4333c830-ab5f-11e8-afb8-0a580a82006e, queue=QueueImpl[name=$.artemis.internal.sf.my-cluster.4333c830-ab5f-11e8-afb8-0a580a82006e, postOffice=PostOfficeImpl [server=ActiveMQServerImpl::serverUUID=9cedb69d-ab5e-11e8-87a4-0a580a82006c], temp=false]@5e0c0398 targetConnector=ServerLocatorImpl [initialConnectors=[TransportConfiguration(name=artemis, factory=org-apache-activemq-artemis-core-remoting-impl-netty-NettyConnectorFactory) ?port=61616&host=10-130-0-110], discoveryGroupConfiguration=null]]::ClusterConnectionImpl@806813022[nodeUUID=9cedb69d-ab5e-11e8-87a4-0a580a82006c, connector=TransportConfiguration(name=artemis, factory=org-apache-activemq-artemis-core-remoting-impl-netty-NettyConnectorFactory) ?port=61616&host=10-130-0-108, address=, server=ActiveMQServerImpl::serverUUID=9cedb69d-ab5e-11e8-87a4-0a580a82006c])) [initialConnectors=[TransportConfiguration(name=artemis, factory=org-apache-activemq-artemis-core-remoting-impl-netty-NettyConnectorFactory) ?port=61616&host=10-130-0-110], discoveryGroupConfiguration=null]] is connected

步骤

1. 导航到 OpenShift Web 控制台并登录。
2. 选择 amq-demo 项目空间。
3. 点 Add to Project > Browse catalog，以列出所有默认镜像流和模板。
4. 使用 Filter 搜索栏，将结果限制为与 amq 匹配的结果。点 See all 显示所需的应用程序模板。
5. 选择标记为 Red Hat AMQ Broker 7.8(Ephemeral, no SSL) 的 amq-broker-78-custom 模板。

6. 在配置中，使用您要使用的自定义配置更新 broker.xml。点 Create。

   注意

   使用文本编辑器创建代理的 XML 配置。然后，在 broker.xml 字段中剪切和粘贴详情。

   注意

   OpenShift Container Platform 不使用 ConfigMap 对象来存储您在 broker.xml 字段中指定的自定义配置，因为此平台上部署的许多应用程序都很常见。相反，OpenShift 会在代理容器启动时将配置传送到独立文件前，将指定的配置临时存储在环境变量中。

步骤

1. 在 OpenShift Container Platform Web 控制台中，单击 Deployments。
2. 点 broker-amq 部署
3. 单击 Deploy 以部署应用。

步骤

1. 在您的 /etc/hosts 文件中添加一个条目，将路由名称映射到 OpenShift 集群的 IP 地址：

   10.0.0.1 broker-amq-tcp-amq-demo.router.default.svc.cluster.local

2. 更新 jndi.properties 配置文件，以使用之前创建的路由、信任存储和密钥存储，例如：

   connectionfactory.myFactoryLookup = amqps://broker-amq-tcp-amq-demo.router.default.svc.cluster.local:8443?transport.keyStoreLocation=<keystore-path>client.ks&transport.keyStorePassword=password&transport.trustStoreLocation=<truststore-path>/client.ts&transport.trustStorePassword=password&transport.verifyHost=false

3. 更新 jndi.properties 配置文件，以使用之前创建的队列。

   queue.myDestinationLookup = demoQueue

4. 执行发送者客户端以发送文本信息。

5. 执行接收器客户端接收文本信息。您应该看到：

   Received message: Message Text!

步骤

1. 从 Add to Project 下拉菜单中选择 导入 YAML/JSON

2. 输入以下内容并点击 create。

   apiVersion: v1
   kind: Route
   metadata:
     labels:
       app: broker-amq
       application: broker-amq
     name: tcp-ssl
   spec:
     port:
       targetPort: ow-multi-ssl
     tls:
       termination: passthrough
     to:
       kind: Service
       name: broker-amq-headless
       weight: 100
     wildcardPolicy: Subdomain
     host: star.broker-ssl-amq-headless.amq-demo.svc

   注意

   此处的重要配置是 Subdomain 的通配符策略。这允许通过自己的主机名访问每个代理。

步骤

1. 在 /etc/hosts 文件中添加条目，将路由名称映射到代理的实际 IP 地址：

   10.0.0.1 broker-amq-0.broker-ssl-amq-headless.amq-demo.svc broker-amq-1.broker-ssl-amq-headless.amq-demo.svc broker-amq-2.broker-ssl-amq-headless.amq-demo.svc

2. 更新 jndi.properties 配置文件，以使用之前创建的路由、信任存储和密钥存储，例如：

   connectionfactory.myFactoryLookup = amqps://broker-amq-0.broker-ssl-amq-headless.amq-demo.svc:443?transport.keyStoreLocation=/home/ataylor/projects/jboss-amq-7-broker-openshift-image/client.ks&transport.keyStorePassword=password&transport.trustStoreLocation=/home/ataylor/projects/jboss-amq-7-broker-openshift-image/client.ts&transport.trustStorePassword=password&transport.verifyHost=false

3. 更新 jndi.properties 配置文件，以使用之前创建的队列。

   queue.myDestinationLookup = demoQueue

4. 执行发送者客户端代码，以发送文本信息。

5. 执行接收器客户端代码来接收文本信息。您应该看到：

   Received message: Message Text!

步骤

1. 从 Add to Project 下拉菜单中选择 导入 YAML/JSON。

2. 输入以下内容并点击 create。

   apiVersion: v1
   kind: Service
   metadata:
     annotations:
       description: The broker's OpenWire port.
       service.alpha.openshift.io/dependencies: >-
         [{"name": "broker-amq-amqp", "kind": "Service"},{"name":
         "broker-amq-mqtt", "kind": "Service"},{"name": "broker-amq-stomp", "kind":
         "Service"}]
     creationTimestamp: '2018-08-29T14:46:33Z'
     labels:
       application: broker
       template: amq-broker-78-statefulset-clustered
     name: broker-external-tcp
     namespace: amq-demo
     resourceVersion: '2450312'
     selfLink: /api/v1/namespaces/amq-demo/services/broker-amq-tcp
     uid: 52631fa0-ab9a-11e8-9380-c280f77be0d0
   spec:
     externalTrafficPolicy: Cluster
     ports:
      -  nodePort: 30001
         port: 61616
         protocol: TCP
         targetPort: 61616
     selector:
       deploymentConfig: broker-amq
     sessionAffinity: None
     type: NodePort
   status:
     loadBalancer: {}

   注意

   NodePort 配置很重要。NodePort 是客户端访问代理的端口，类型是 NodePort。

步骤

1. 在终端中，创建一个使用者，并将它附加到运行 OpenShift 的 IP 地址。

   artemis consumer --url tcp://<IP_ADDRESS>:30001 --message-count 100 --destination queue://demoQueue

2. 重复步骤 1 两次，以启动两个消费者。

   注意

   现在，您应该有三个使用者在三个代理之间进行平衡。

3. 创建制作者来发送消息。

   artemis producer --url tcp://<IP_ADDRESS>:30001 --message-count 300 --destination queue://demoQueue

4. 验证各个消费者接收消息。

   Consumer:: filter = null
   Consumer ActiveMQQueue[demoQueue], thread=0 wait until 100 messages are consumed
   Consumer ActiveMQQueue[demoQueue], thread=0 Consumed: 100 messages
   Consumer ActiveMQQueue[demoQueue], thread=0 Consumer thread finished

步骤

1. 使用包含代理部署的项目的管理员特权登录到 OpenShift Container Platform Web 控制台。
2. 在 web 控制台中，点击 Home → Projects （OpenShift Container Platform 4.5 或更高版本）或左上角的下拉列表(OpenShift Container Platform 3.11)。选择包含代理部署的项目。

3. 要查看项目中的 StatefulSets 或 DeploymentConfig，请点击：

   1. 工作负载 → StatefulSets 或 Workloads → DeploymentConfig （OpenShift Container Platform 4.5 或更高版本）。
   2. 应用程序 → StatefulSet 或 Applications → Deployments (OpenShift Container Platform 3.11)。
4. 点与代理部署对应的 StatefulSet 或 DeploymentConfig。
5. 要访问代理部署的环境变量，请点击 Environment 选项卡。

6. 添加新环境变量 AMQ_ENABLE_METRICS_PLUGIN。将 变量的值设为 true。

   设置 AMQ_ENABLE_METRICS_PLUGIN 环境变量时，OpenShift 会在 StatefulSet 或 DeploymentConfig 中重启每个代理 Pod。当部署中有多个 Pod 时，OpenShift 会依次重启每个 Pod。当每个代理 Pod 重启时，该代理的 Prometheus 插件会启动来收集代理运行时指标。

步骤

1. 对于您要访问指标的代理 Pod，您需要识别之前创建的路由以将 Pod 连接到 AMQ Broker 管理控制台。Route 名称表单访问指标所需的 URL 部分。

   1. 点击 Networking → Routes （OpenShift Container Platform 4.5 或更高版本）或 Applications → Routes (OpenShift Container Platform 3.11)。

   2. 对于您选择的代理 Pod，识别为将 Pod 连接到 AMQ Broker 管理控制台而创建的 Route。在 主机名 下，记下显示的完整 URL。例如：

      http://rte-console-access-pod1.openshiftdomain

2. 要访问 Prometheus 指标，请在 Web 浏览器中输入之前记录的 Route 名称并附加 "/metrics"。例如：

   http://rte-console-access-pod1.openshiftdomain/metrics