在 OpenShift 上部署 AMQ Broker

流程

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

3. 在最新的 AMQ Broker 7.12.3 Operator 安装和示例文件旁边，单击 Download。

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

4. 将存档移到您选择的目录中。以下示例将存档移到名为 ~/broker/operator 的目录中。

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   $ oc login -u system:admin

   Copy to Clipboard Toggle word wrap

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

   1. 创建一个新项目

      $ oc new-project <project_name>

      Copy to Clipboard Toggle word wrap

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

      $ oc project <project_name>

      Copy to Clipboard Toggle word wrap

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

   1. 在您提取的 Operator 归档的 deploy 目录中，打开 service_account.yaml 文件。
   2. 确保 kind 元素设置为 ServiceAccount。
   3. 如果要更改默认服务帐户名称，在 metadata 部分中，将 amq-broker-controller-manager 替换为自定义名称。

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

      $ oc create -f deploy/service_account.yaml

      Copy to Clipboard Toggle word wrap

10. 为 Operator 指定角色名称。

    1. 打开 role.yaml 文件。此文件指定 Operator 可以使用和修改的资源。
    2. 确保 kind 元素设为 Role。
    3. 如果要更改默认角色名称，在 metadata 部分中，将 amq-broker-operator-role 替换为自定义名称。

    4. 在项目中创建角色。

       $ oc create -f deploy/role.yaml

       Copy to Clipboard Toggle word wrap

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

    1. 打开 role_binding.yaml 文件。

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

       metadata:
           name: amq-broker-operator-rolebinding
       subjects:
           kind: ServiceAccount
           name: amq-broker-controller-manager
       roleRef:
           kind: Role
           name: amq-broker-operator-role

       Copy to Clipboard Toggle word wrap

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

       $ oc create -f deploy/role_binding.yaml

       Copy to Clipboard Toggle word wrap

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

    1. 为 Operator 创建领导选举角色。

       $ oc create -f deploy/election_role.yaml

       Copy to Clipboard Toggle word wrap

    2. 在项目中创建领导选举角色绑定。

       $ oc create -f deploy/election_role_binding.yaml

       Copy to Clipboard Toggle word wrap

13. （可选） 如果您希望 Operator 监视多个命名空间，请完成以下步骤：

    注意

    如果 OpenShift Container Platform 集群已经包含为 AMQ Broker 安装的 Operator，您必须确保新 Operator 不会监视与现有 Operator 相同的命名空间。有关如何识别现有 Operator 监控的命名空间的详情，请参考 识别现有 Operator 监控的命名空间。

    1. 在您下载和提取的 Operator 归档的 deploy 目录中，打开 operator_yaml 文件。

    2. 如果您希望 Operator 监控集群中的所有命名空间，在 WATCH_NAMESPACE 部分，添加一个 value 属性，并将值设为星号。注释掉 WATCH_NAMESPACE 部分中的现有属性。例如：

       - name: WATCH_NAMESPACE
         value: "*"
       # valueFrom:
       #   fieldRef:
       #     fieldPath: metadata.namespace

       Copy to Clipboard Toggle word wrap
       注意

       为避免冲突，请确保多个 Operator 不监视同一命名空间。例如，如果您部署 Operator 以监视 集群中的所有命名空间，则无法部署另一个 Operator 来监视单独的命名空间。如果在集群中部署了 Operator，您可以指定新 Operator 监视的命名空间列表，如下所述。

    3. 如果您希望 Operator 监控多个命名空间，但不是集群中的所有命名空间，在 WATCH_NAMESPACE 部分指定命名空间列表。确保您排除了现有 Operator 监控的任何命名空间。例如：

       - name: WATCH_NAMESPACE
         value: "namespace1, namespace2"`.

       Copy to Clipboard Toggle word wrap
    4. 在您下载和提取的 Operator 归档的 deploy 目录中，打开 cluster_role_binding.yaml 文件。

    5. 在 Subjects 部分中，指定一个与您要部署 Operator 的 OpenShift Container Platform 项目对应的命名空间。例如：

       Subjects:
       - kind: ServiceAccount
         name: amq-broker-controller-manager
         namespace: operator-project

       Copy to Clipboard Toggle word wrap
       注意

       如果您之前使用早期版本的 Operator 部署代理，并且希望部署 Operator 以观察多个命名空间，请参阅 升级前。

    6. 在项目中创建集群角色。

       $ oc create -f deploy/cluster_role.yaml

       Copy to Clipboard Toggle word wrap

    7. 在项目中创建集群角色绑定。

       $ oc create -f deploy/cluster_role_binding.yaml

       Copy to Clipboard Toggle word wrap

流程

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

   $ oc login -u system:admin

   Copy to Clipboard Toggle word wrap

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

   $ oc project <project_name>

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   1. 部署主要代理 CRD。

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

      Copy to Clipboard Toggle word wrap

   2. 部署地址 CRD。

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

      Copy to Clipboard Toggle word wrap

   3. 部署 scaledown 控制器 CRD。

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

      Copy to Clipboard Toggle word wrap

   4. 部署安全 CRD：

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

      Copy to Clipboard Toggle word wrap

5. 将与 Red Hat Ecosystem Catalog 进行身份验证时使用的账户相关联的 pull secret 与您的 OpenShift 项目的 default, 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>

   Copy to Clipboard Toggle word wrap

6. 在您下载并提取的 Operator 归档的 deploy 目录中，打开 operator.yaml 文件。确保 spec.containers.image 属性的值与 Operator 的版本 7.12.3-opr-1 对应，如下所示。

   spec:
       template:
           spec:
               containers:
                   #image: registry.redhat.io/amq7/amq-broker-rhel8-operator:7.10
                   image: registry.redhat.io/amq7/amq-broker-rhel8-operator@sha256:1fd01079ad519e1a47b886893a0635491759ace2f73eda7615a9c8c2f454ba89

   Copy to Clipboard Toggle word wrap
   注意

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

7. 部署 Operator。

   $ oc create -f deploy/operator.yaml

   Copy to Clipboard Toggle word wrap

   在 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}

   Copy to Clipboard Toggle word wrap

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

流程

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

4. 在 OperatorHub 页面中，使用 Filter by keyword…​ 复选框来查找 Red Hat Integration - AMQ Broker for RHEL 8 (Multiarch) Operator。

   注意

   在 OperatorHub 中，您可能会发现多个 Operator 与其名称中包含 AMQ Broker。确保点 Red Hat Integration - AMQ Broker for RHEL 8 (Multiarch) Operator。当您点此 Operator 时，查看打开的信息窗格。对于 AMQ Broker 7.12，此 Operator 的最新次要版本标签为 7.12.3-opr-1。

5. 点 Red Hat Integration - AMQ Broker for RHEL 8 (Multiarch) Operator。在出现的对话框中，点 Install。

6. 在 Install Operator 页面中：

   1. 在 Update Channel 下，选择 7.11.x 频道以仅接收版本 7.11 的更新。7.11.x 频道是 Long Term Support (LTS)频道。

      根据 OpenShift Container Platform 集群安装的时间，您可能还会看到较旧版本的 AMQ Broker 的频道。唯一支持的频道是 7.10.x，它也是 LTS 频道。

   2. 在 Installation Mode 下，选择 Operator 监视的命名空间：

      • A specific namespace on the cluster - Operator 已安装在该命名空间中，仅监控该命名空间是否有 CR 更改。
      • All namespaces - Operator 监控所有命名空间是否有 CR 更改。
      注意

      如果您之前使用早期版本的 Operator 部署代理，而您希望部署 Operator 以观察多个命名空间，请参阅升级前的操作。

7. 在 Installed Namespace 下拉菜单中选择您要安装 Operator 的项目。

8. 在 Approval Strategy 下，确保选择了授权 Automatic 的单选按钮。这个选项指定对 Operator 的更新不需要手动批准才能进行安装。

   注意

   批准策略仅适用于 Operator 的微版本之间的更新。不支持在次版本 Operator 之间的自动更新。例如，如果当前 Operator 是 7.11.7 版本，则无法自动更新到版本 7.12.x。要在 Operator 的次版本间更新，您必须手动卸载当前的 Operator，并从提供该次版本的 Operator 的频道安装新的 Operator。如需更多信息，请参阅 第 6.3 节 “使用 OperatorHub 手动升级 Operator”。

9. 点 Install。

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

   1. 使用 OpenShift 命令行界面：

      1. 以具有在您要创建部署的项目中部署 CR 的用户身份登录 OpenShift。

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

         Copy to Clipboard Toggle word wrap
      2. 打开一个名为 broker_activemqartemis_cr.yaml 的示例 CR 文件，该文件包含在您下载和提取的 Operator 安装的 deploy/crs 目录中。

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

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

      5. 单击 Create ActiveMQArtemis。

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

   对于基本代理部署，配置可能类似如下。

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

   Copy to Clipboard Toggle word wrap

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

   注意

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

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

3. 部署 CR 实例。

   1. 使用 OpenShift 命令行界面：

      1. 保存 CR 文件。

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

         $ oc project <project_name>

         Copy to Clipboard Toggle word wrap

      3. 创建 CR 实例。

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

         Copy to Clipboard Toggle word wrap

   2. 使用 OpenShift Web 控制台：

      1. 配置完 CR 后，点 Create。

4. 在 OpenShift Container Platform web 控制台中点 Workloads → StatefulSets。您会看到一个名为 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。
      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

         Copy to Clipboard Toggle word wrap

      2. 访问代理 Pod 的 shell。

         $ oc rsh ex-aao-ss-0

         Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   前面的命令会在代理上自动创建一个名为 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

   Copy to Clipboard Toggle word wrap

流程

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

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

   apiVersion: broker.amq.io/v1beta1
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
   spec:
     deploymentPlan:
       size: 4
       image: placeholder
       ...

   Copy to Clipboard Toggle word wrap
   注意

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

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

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

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

   Copy to Clipboard Toggle word wrap

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

   $ oc project <project_name>

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

7. 打开每个 Pod 的 Logs 选项卡。日志显示 OpenShift 已在每个代理上建立了集群连接网桥。特别是，日志输出包含类似如下的行：

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

   Copy to Clipboard Toggle word wrap

1. Operator 在代理应用程序容器前运行 Init 容器。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>

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

流程

1. 为您的代理部署编辑 ActiveMQArtemis CR 实例。

2. 在 CR 的 spec 部分中，如果 CR 中还没有添加 brokerProperties 属性。

   spec:
     ...
     brokerProperties:
     ...

   Copy to Clipboard Toggle word wrap

3. 使用格式配置地址：

   - addressConfigurations.<address name>.routingTypes=<routing type>

   例如：

   spec:
     ...
     brokerProperties:
     - addressConfigurations.usa-news-address.routingTypes=MULTICAST
     ...

   Copy to Clipboard Toggle word wrap

4. 为您以以下格式创建的地址配置队列：

   - addressConfigurations.<address name>.queueConfigs.<queue name>.address< address&gt;

   重要

   .address 设置的 &lt;address & gt; 的值必须与您创建的每个队列的 <address name> 匹配。如果这些值不同，则会为每个分别创建单独的地址。在以下示例中，地址名称和 .address 设置的值都与 usa-news-address 的值相同。

   spec:
     ...
     brokerProperties:
     - addressConfigurations.usa-news-address.queueConfigs.usa-news-queue.address=usa-news-address
     ...

   Copy to Clipboard Toggle word wrap

5. 为您要为队列配置的每个设置添加一个单独的行，格式为：

   • addressConfigurations.<address name>.queueConfigs.<queue name>.<queue setting>

   例如：

   spec:
     ...
     brokerProperties:
     - addressConfigurations.usa-news-address.queueConfigs.usa-news-queue.routingType=ANYCAST
     - addressConfigurations.usa-news-address.queueConfigs.usa-news-queue.purgeOnNoConsumers=true
     - addressConfigurations.usa-news-address.queueConfigs.usa-news-queue.maxConsumers=20
     ...

   Copy to Clipboard Toggle word wrap
6. 保存 CR。
7. 通过查看 ActiveMQArtemis CR 的 status 部分，检查是否没有在 brokerProperties 配置中检测到任何错误。如需更多信息，请参阅 第 2.4 节 “配置不在自定义资源定义(CRD)中公开的项”。

流程

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

   1. 使用 OpenShift 命令行界面：

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

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

         Copy to Clipboard Toggle word wrap
      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/v1beta1
   kind: ActiveMQArtemisAddress
   metadata:
       name: myAddressDeployment0
       namespace: myProject
   spec:
       ...
       addressName: myAddress0
       queueName: myQueue0
       routingType: anycast
       ...

   Copy to Clipboard Toggle word wrap

   上述配置定义了名为 myAddress0 的地址，队列名为 myQueue0 和 anycast 路由类型。

   注意

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

3. 部署 CR 实例。

   1. 使用 OpenShift 命令行界面：

      1. 保存 CR 文件。

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

         $ oc project <project_name>

         Copy to Clipboard Toggle word wrap

      3. 创建 CR 实例。

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

         Copy to Clipboard Toggle word wrap

   2. 使用 OpenShift Web 控制台：

      1. 配置完 CR 后，点 Create。

1. 为您的代理部署编辑 ActiveMQArtemis CR 实例。

2. 创建死信地址和队列以接收未发送的消息。例如：

   spec:
     ...
     brokerProperties:
     ...
     - addressConfigurations.usDeadLetter.routingTypes=MULTICAST
     - addressConfigurations.usDeadLetter.queueConfigs.usDeadLetter-queue.address=usDeadLetter

   Copy to Clipboard Toggle word wrap

   有关使用 brokerProperties 创建地址和队列的更多信息，请参阅 第 4.2.1 节 “配置地址和队列”。

3. 在 brokerProperties 属性下添加单独的行，格式为 addressSettings.<address name&gt; to:

   • 将未发送消息的死信地址设置为您创建的死信地址。

   • 指定无法传送到匹配地址的消息发送到死信地址的发送尝试次数。

     例如：

     spec:
       ...
       brokerProperties:
       ...
       - addressSettings.usa-news.deadLetterAddress=usDeadLetter
       - addressSettings.usa-news.maxDeliveryAttempts=5
       ...

     Copy to Clipboard Toggle word wrap

     您可以使用星号 Ping 或数字符号(""\)字符作为通配符来创建地址模式。模式匹配在每个分隔符边界上完成，该边界由一个句点(.)表示。数字符号字符匹配任何零个或多个单词序列，并可在地址字符串末尾使用。星号字符匹配单个单词，可以在地址字符串中的任何位置使用。例如：

     spec:
       ...
       brokerProperties:
       ...
       - addressSettings."usa-news.*".deadLetterAddress=usDeadLetter
       - addressSettings."europe-news.#".deadLetterAddress=euDeadLetter
       ...

     Copy to Clipboard Toggle word wrap

     在上例中，以下地址匹配：

   • usa-news credentials 地址模式匹配任何遵循 usa-news. string 的词语，如 usa-news.domestic 和 usa-news.intl，但不匹配 usa-news.domestic.politics。

   • europe-news.650 地址模式匹配任何以 europe-news 开头的地址，如 europe-news、europe-news.politics 和 europe-news.politics.fr。

     注意

     在 brokerProperties 条目中，句点(.)是一个保留字符。如果要创建包含句点的地址模式，则必须将地址包括在引号中。例如："usa-news configured"

4. 保存 CR。
5. 通过查看 ActiveMQArtemis CR 的 status 部分，检查是否没有在 brokerProperties 配置中检测到任何错误。如需更多信息，请参阅 第 2.4 节 “配置不在自定义资源定义(CRD)中公开的项”。

流程

1. 为您的代理部署编辑 ActiveMQArtemis CR 实例。

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

   Copy to Clipboard Toggle word wrap
   1. 使用 OpenShift Container Platform Web 控制台：
2. 以具有特权的用户身份登录控制台，以便在代理部署的项目中部署 CR。
3. 在左侧窗格中，点 Operators → Installed Operator。
4. 点 Red Hat Integration - AMQ Broker for RHEL 8 (Multiarch) operator。
5. 点 AMQ Broker 选项卡。
6. 单击 ActiveMQArtemis 实例名称的名称。

7. 点 YAML 标签。

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

   注意

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

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

      spec:
        ...
        addressSettings:
          addressSetting:

      Copy to Clipboard Toggle word wrap

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

      spec:
        ...
        addressSettings:
          addressSetting:
          - match: myAddress

      Copy to Clipboard Toggle word wrap

      match

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

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

      spec:
        ...
        addressSettings:
          addressSetting:
          - match: myAddress
            deadLetterAddress: myDeadLetterAddress
            maxDeliveryAttempts: 5

      Copy to Clipboard Toggle word wrap

      deadLetterAddress

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

      maxDeliveryAttempts

      代理在将消息移至配置的死信地址前进行的最大发送尝试次数。

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

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

      spec:
        ...
        addressSettings:
          addressSetting:
          - match: myAddress
            deadLetterAddress: myDeadLetterAddress
            maxDeliveryAttempts: 5
          - match: 'myOtherAddresses#'
            deadLetterAddress: myDeadLetterAddress
            maxDeliveryAttempts: 3

      Copy to Clipboard Toggle word wrap

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

      注意

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

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

      spec:
        ...
          applyRule: merge_all
          addressSetting:
          - match: myAddress
            deadLetterAddress: myDeadLetterAddress
            maxDeliveryAttempts: 5
          - match: 'myOtherAddresses#'
            deadLetterAddress: myDeadLetterAddress
            maxDeliveryAttempts: 3

      Copy to Clipboard Toggle word wrap

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

      merge_all

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

        • 将默认配置中指定的任何属性值替换为 CR 中指定的值。
        • 保留在 CR 或 默认配置中唯一指定的任何属性值。在最终合并的配置中包括每个。
      • 对于在 CR 中指定的地址设置，或者唯一匹配一个特定地址或一组地址的默认配置，将它们包括在最终合并的配置中。

      merge_replace

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

      replace_all

      使用在 CR 中指定的内容替换默认配置中指定的所有地址设置最后，合并的配置与 CR 中指定的配置完全相同。

      注意

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

   6. 保存 CR 实例。

流程

1. 为您的代理部署编辑 ActiveMQArtemis CR 实例。

2. 添加以下 brokerProperties 条目，以允许代理删除任何地址，由数字符号(#)表示，以及它不再在 CR 中找到的相关队列。

   spec:
     ...
     brokerProperties:
     - addressSettings.#.configDeleteAddresses=FORCE
     - addressSettings.#.configDeleteQueues=FORCE
     ...

   Copy to Clipboard Toggle word wrap

3. 在 brokerProperties 属性下，删除引用您要删除的地址和队列的所有行。例如，删除所有引用 usa-news 地址的行来删除此地址和队列：

   spec:
     ...
     brokerProperties:
     - addressConfigurations.usa-news.queueConfigs.usa-news-queue.routingType=MULTICAST
     - addressConfigurations.usa-news.queueConfigs.usa-news-queue.purgeOnNoConsumers=true
     - addressConfigurations.usa-news.queueConfigs.usa-news-queue.maxConsumers=20
     ...

   Copy to Clipboard Toggle word wrap

4. 保存 CR。

   当代理应用更新的配置时，它会删除您从 CR 中删除的地址和队列。

流程

1. 确保有一个带有详细信息的地址 CR 文件，例如：您要删除的地址和 队列的名称、addressName 和 queueName。例如：

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

   Copy to Clipboard Toggle word wrap

2. 在地址 CR 的 spec 部分中，添加 removeFromBrokerOnDelete 属性，并将它设为 true 的值。

   ..
   spec:
      addressName: myAddress1
      queueName: myQueue1
      routingType: anycast
      removeFromBrokerOnDelete: true

   Copy to Clipboard Toggle word wrap

   将 removeFromBrokerOnDelete 属性设置为 true 会导致 Operator 在删除地址 CR 时删除所有代理的地址和任何关联的消息。

3. 应用更新的地址 CR，为您要删除的地址设置 removeFromBrokerOnDelete 属性。

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

   Copy to Clipboard Toggle word wrap

4. 删除地址 CR，从部署中的代理中删除地址。

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

   Copy to Clipboard Toggle word wrap

流程

1. 使用新的 JAAS 登录模块配置创建一个文本文件，并将文件保存为 login.config。将文件保存为 login.config，正确的密钥会插入到您从文本文件创建的 secret 中。以下是登录模块配置示例：

   activemq {
      org.apache.activemq.artemis.spi.core.security.jaas.PropertiesLoginModule sufficient
         reload=true
         org.apache.activemq.jaas.properties.user="new-users.properties"
         org.apache.activemq.jaas.properties.role="new-roles.properties";
   
      org.apache.activemq.artemis.spi.core.security.jaas.PropertiesLoginModule sufficient
         reload=false
         org.apache.activemq.jaas.properties.user="artemis-users.properties"
         org.apache.activemq.jaas.properties.role="artemis-roles.properties"
         baseDir="/home/jboss/amq-broker/etc";
   };

   Copy to Clipboard Toggle word wrap

   在 secret 中配置 JAAS 登录模块并在 CR 中添加对 secret 的引用后，AMQ Broker 不再使用默认的登录模块。但是，Operator 需要在默认登录模块中引用的 artemis-users.properties 文件中的用户与代理进行身份验证。要确保 Operator 可以在配置新的 JAAS 登录模块后与代理进行身份验证，您必须：

   • 在新的登录模块配置中包含默认属性登录模块，如上例中所示。在示例中，默认属性登录模块使用 artemis-users.properties 和 artemis-roles.properties 文件。如果您在新的登录模块配置中包含默认登录模块，您必须将 baseDir 设置为 /home/jboss/amq-broker/etc 目录，其中包含每个代理 Pod 上的默认属性文件。

   • 将 Operator 所需的用户和角色信息添加到新登录模块配置中引用的属性文件中。您可以从代理 Pod 上的 /home/jboss/amq-broker/etc 目录中 复制此信息。

     注意

     只有在代理首次调用登录模块时，才会加载登录模块中引用的属性文件。代理会按照 login.config 文件中列出的顺序调用登录模块，直到它找到登录模块来验证用户。通过将包含 Operator 使用的凭证的登录模块放在 login.config 文件的末尾，当代理验证 Operator 时，所有前面的登录模块都会被调用。因此，任何状态消息都指出该属性文件在代理中不可见。

2. 如果您创建的 login.config 文件包含属性登录模块，请确保模块中指定的用户和角色文件包含用户和角色信息。例如：

   new-users.properties

   ruben=ruben01!
   anne=anne01!
   rick=rick01!
   bob=bob01!

   Copy to Clipboard Toggle word wrap

   new-roles.properties

   admin=ruben, rick
   group1=bob
   group2=anne

   Copy to Clipboard Toggle word wrap

3. 使用 oc create secret 命令从使用新登录模块配置创建的文本文件中创建 secret。如果登录模块配置包含属性登录模块，请在机密中包含相关的用户和角色文件。例如：

   oc create secret generic custom-jaas-config --from-file=login.config --from-file=new-users.properties --from-file=new-roles.properties

   Copy to Clipboard Toggle word wrap
   注意

   secret 名称必须具有 -jaas-config 后缀，以便 Operator 可以识别 secret 包含登录模块配置，并将任何更新传播到每个代理 Pod。

   有关如何创建 secret 的更多信息，请参阅 Kubernetes 文档中的 Secret。

4. 将您创建的 secret 添加到代理部署的自定义资源(CR)实例中。

   1. 使用 OpenShift 命令行界面：

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

      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 8 (Multiarch) operator。
      4. 点 AMQ Broker 选项卡。
      5. 单击 ActiveMQArtemis 实例名称的名称。

      6. 点 YAML 标签。

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

5. 创建一个 extraMounts 元素和一个 secrets 元素，并添加 secret 的名称。以下示例将名为 custom-jaas-config 的 secret 添加到 CR 中。

   deploymentPlan:
     ...
     extraMounts:
       secrets:
       - "custom-jaas-config"
     ...

   Copy to Clipboard Toggle word wrap

6. 在 CR 中，为代理配置的角色授予权限。

   1. 在 CR 的 spec 部分，添加一个 brokerProperties 元素并添加权限。您可以为单个地址授予角色权限。或者，您可以使用 # 符号指定通配符匹配，为所有地址授予角色权限。例如：

      spec:
        ...
        brokerProperties:
        - securityRoles.#.group2.send=true
        - securityRoles.#.group1.consume=true
        - securityRoles.#.group1.createAddress=true
        - securityRoles.#.group1.createNonDurableQueue=true
        - securityRoles.#.group1.browse=true
        ...

      Copy to Clipboard Toggle word wrap

      在示例中，group2 角色分配为所有地址 发送 权限，并且分配 group1 角色 消耗、createAddress、createNonDurableQueue 并将权限浏览到 所有地址。

      注意

      在 Java 属性文件中，冒号(:)是一个保留字符，用于分隔键/值对中的键和值。如果要向完全限定队列名称(FQQN)授予权限，它由地址名称和以冒号(::)分隔的队列名称组成，则必须使用反斜杠(\)字符来转义 FQQN 中的冒号字符。例如：

      spec:
        ...
        brokerProperties:
        - 'securityRoles."my-address\:\:my-queue".group2.send=true'

      Copy to Clipboard Toggle word wrap

7. 保存 CR。

   Operator 在每个 Pod 上的 /amq/extra/secrets/secret 名称 目录中挂载 login.config 文件，并将代理 JVM 配置为读取挂载的 login.config 文件，而不是默认的 login.config 文件。如果 login.config 文件包含属性登录模块，则引用的用户和角色属性文件也会挂载到每个 Pod 上。

8. 查看 CR 中的状态信息，以验证部署中的代理是否使用 secret 中的 JAAS 登录模块进行身份验证。

   1. 使用 OpenShift 命令行界面：

      1. 获取代理 CR 中的状态条件。

         $ oc get activemqartemis -o yaml

         Copy to Clipboard Toggle word wrap

   2. 使用 OpenShift Web 控制台：

      1. 在 CR 中，进入到 status 部分。

   3. 在状态信息中，验证存在 JaasPropertiesApplied 类型，这表示代理正在使用 secret 中配置的 JAAS 登录模块。例如：

      - lastTransitionTime: "2023-02-06T20:50:01Z"
        message: ""
        reason: Applied
        status: "True"
        type: JaasPropertiesApplied

      Copy to Clipboard Toggle word wrap

      当您更新 secret 中的任何文件时，reason 字段的值会显示 OutofSync，直到 OpenShift Container Platform 将 secret 中的最新文件传播到每个代理 Pod。例如，如果您在 new-users-properties 文件中添加新用户并更新 secret，您会看到以下状态信息，直到更新的文件被传播到每个 Pod：

      - lastTransitionTime: "2023-02-06T20:55:20Z"
        message: 'new-users.properties status out of sync, expected: 287641156, current: 2177044732'
        reason: OutOfSync
        status: "False"
        type: JaasPropertiesApplied

      Copy to Clipboard Toggle word wrap

9. 当您在 secret 中引用的属性文件中更新用户或组信息时，请使用 oc set data 命令更新 secret。您必须再次读取到 secret 的所有文件，包括 login.config 文件。例如，如果您向此流程前面创建的 new-users.properties 文件中添加新用户，请使用以下命令更新 custom-jaas-config secret：

   oc set data secret/custom-jaas-config --from-file=login.config=login.config --from-file=new-users.properties=new-users.properties --from-file=new-roles.properties=new-roles.properties

   Copy to Clipboard Toggle word wrap

流程

1. 使用 oc create secret 命令创建一个包含要添加的第三方 JAR 文件的 secret。例如：

   oc create secret generic log4j-template --from-file=log4j-layout-template-json-2.22.1.jar

   Copy to Clipboard Toggle word wrap

   有关如何创建 secret 的更多信息，请参阅 Kubernetes 文档中的 Secret。

2. 编辑代理部署的 CR，并将 Operator 配置为在每个代理 pod 上挂载包含第三方 JAR 文件的 secret。例如，以下配置挂载名为 log4j-template 的 secret。

   deploymentPlan:
     ...
     extraMounts:
       secrets:
       - "log4j-template"
     ...

   Copy to Clipboard Toggle word wrap

   JAR 文件挂载到每个代理 pod 上的 /amq/extra/secrets/secret 名称 目录中。例如，/amq/extra/secrets/postgresql-driver/log4j-template.jar。

3. 创建 ARTEMIS_EXTRA_LIBS 环境变量来扩展代理的 Java 类路径，以便代理从每个 pod 上挂载的目录加载 JAR 文件。例如：

   spec:
     ...
     env:
     - name: ARTEMIS_EXTRA_LIBS
       value: /amq/extra/secrets/log4j-template

   Copy to Clipboard Toggle word wrap
4. 保存 CR。

流程

1. 编辑用于代理部署的 ActiveMQArtemis CR。

2. 在 broker CR 中，使用 extraVolumes 和 extraVolumeMounts 属性来添加持久性卷，并在每个代理 pod 上挂载卷。例如：

   deploymentPlan:
     ...
     extraVolumes:
     - name: extra-volume
       persistentVolumeClaim:
         claimName: extra-jars
     extraVolumeMounts:
     - name: extra-volume
       mountPath: /opt/extra-lib
     ...

   Copy to Clipboard Toggle word wrap

3. 使用 resourceTemplates 属性为部署自定义 StatefulSet 资源。在自定义中，使用 init 容器挂载您在每个 pod 上创建的 extra-volume 卷，并将 JAR 文件下载到卷。例如：

   spec:
     ...
     resourceTemplates:
     - selector:
         kind: StatefulSet
       patch:
         kind: StatefulSet
         spec:
           template:
             spec:
               initContainers:
               - name: mysql-jdbc-driver-init
                 volumeMounts:
                 - mountPath: /opt/extra-lib
                   name: extra-volume
                 image: curlimages/curl:8.6.0
                 command:
                 - /bin/sh
                 args:
                 - -c
                 - "if ! [ -f /opt/extra-lib/mysql-connector.jar ]; then curl https://repo1.maven.org/maven2/mysql/mysql-connector-java/8.0.23/mysql-connector-java-8.0.23.jar --output /opt/extra-lib/mysql-connector.jar ; fi"

   Copy to Clipboard Toggle word wrap

   在示例中，如果该文件还没有位于卷中，则使用 curl 镜像将 mysql-connector.jar 文件下载到卷的挂载路径 /opt/extra-lib。

4. 创建 ARTEMIS_EXTRA_LIBS 环境变量来扩展代理的 Java 类路径，以便代理从共享卷加载 JAR 文件。例如：

   spec:
     ...
     env:
     - name: ARTEMIS_EXTRA_LIBS
       value: /opt/extra-lib

   Copy to Clipboard Toggle word wrap
5. 保存 CR。

流程

1. 编辑代理部署的 ActiveMQArtemis 自定义资源(CR)。

2. 将 persistenceEnabled 属性设置为 true。例如：

   spec:
     ...
     deploymentPlan:
       persistenceEnabled: true
     ...

   Copy to Clipboard Toggle word wrap
3. 保存 CR。

流程

1. 编辑代理部署的 ActiveMQArtemis 自定义资源(CR)。

2. 使用 brokerProperties 属性启用 JDBC 数据库持久性。例如：

   spec:
     ...
     brokerProperties:
     - storeConfiguration=DATABASE
     - storeConfiguration.jdbcDriverClassName=<class name>
     - storeConfiguration.jdbcConnectionUrl=jdbc:<URL>
     - HAPolicyConfiguration=SHARED_STORE_PRIMARY
     ...

   Copy to Clipboard Toggle word wrap

   storeConfiguration

   指定 DATABASE 值，以将消息持久保留到 JDBC 数据库。

   storeConfiguration.jdbcDriverClassName

   JDBC 数据库驱动程序的完全限定类名称。例如，org.postgresql.Driver。

   有关支持的数据库的详情，请参考红帽客户门户网站中的 Red Hat AMQ 7 支持的配置。

   storeConfiguration.jdbcConnectionUrl

   您的数据库服务器的完整 JDBC 连接 URL，包括数据库名称和所有配置参数。例如：

   jdbc:postgresql://postgresql-service.default.svc.cluster.local:5432/postgres?user=postgres&password=postgres

   在示例中，数据库名称是 postgres。

   HAPolicyConfiguration

   设置为 SHARED_STORE_PRIMARY，以确保代理使用 JDBC 租期锁定来保护数据库表不受多个代理的并发访问。如果第二个代理实例被意外部署，则租期锁定会阻止第二个代理写入数据库。

3. （可选）根据需要更改以下属性的默认值：

   storeConfiguration.jdbcNetworkTimeout

   JDBC 网络连接超时，以毫秒为单位。默认值为 20000 毫秒。

   storeConfiguration.jdbcLockRenewPeriod

   当前 JDBC 锁的续订周期的长度，以毫秒为单位。当这个时间过后，代理可以续订锁定。设置一个比 storeConfiguration.jdbcLockExpiration 值小于 storeConfiguration.jdbcLockExpiration 的值的值，以便代理有足够的时间扩展租期，同时还为代理提供在发生连接问题时尝试续订锁定的时间。默认值为 2000 毫秒。

   storeConfiguration.jdbcLockExpiration

   以毫秒为单位，当前 JDBC 锁定被视为拥有的时间（即获取或续订），即使 storeConfiguration.jdbcLockRenewPeriod 的值已过。代理定期尝试根据 storeConfiguration.jdbcLockRenewPeriod 的值续订其拥有的锁定。如果代理无法续订锁定，例如，因为连接问题，代理会不断尝试续订锁定，直到 storeConfiguration.jdbcLockExpiration 的值自上次成功获取或续订后才会传递。上述续订行为的例外是另一个代理获取锁定时。如果数据库管理系统(DBMS)和代理之间有时间不对齐，或者对于垃圾回收有长时间暂停，则会出现这种情况。在这种情况下，最初拥有的锁定的代理会考虑丢失锁定，且不会尝试续订它。如果当前拥有过期时间后的代理没有续订 JDBC 锁定，则另一个代理可以建立 JDBC 锁定。默认值为 20000 毫秒。

   storeConfiguration.jdbcJournalSyncPeriod

   持续时间，以毫秒为单位，代理日志与 JDBC 同步。默认值为 5 毫秒。

   storeConfiguration.jdbcMaxPageSizeBytes

   当 AMQ Broker 将消息保留到 JDBC 数据库时，每个页文件的最大大小（以字节为单位）。默认值为 102400，其值为 100KB。您指定的值也支持字节表示法，如 "K" "MB" 和 "GB"。

4. 保存 CR。

流程

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

   1. 使用 OpenShift 命令行界面：

      1. 以具有在您要创建部署的项目中部署 CR 的用户身份登录 OpenShift。

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

         Copy to Clipboard Toggle word wrap
      2. 打开一个名为 broker_activemqartemis_cr.yaml 的示例 CR 文件，该文件包含在您下载和提取的 Operator 安装的 deploy/crs 目录中。

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

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

      5. 单击 Create ActiveMQArtemis。

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

   对于基本代理部署，配置可能类似如下。

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

   storage.size

   每个代理 Pod 需要的持久性卷声明(PVC)的大小，以字节为单位。此属性仅在 persistenceEnabled 设为 true 时才适用。您指定的值 必须使用 字节表示法（如 K、M、G）或二进制等效的二进制(Ki、Mi、Gi)包含单元。

3. 要指定每个代理 Pod 需要的存储类，在 storage 部分添加 storageClassName 属性并指定一个值。例如：

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

   Copy to Clipboard Toggle word wrap

   storage.storageClassName

   在持久性卷声明(PVC)中请求的存储类的名称。存储类为管理员提供了一种描述和分类可用存储的方法。例如，不同的存储类可能会映射到特定的服务质量级别、备份策略等。

   如果没有指定存储类，PVC 会声明一个带有为集群配置默认存储类的持久性卷。

   注意

   如果您指定了存储类，只有在卷的存储类与指定存储类匹配时，才会由 PVC 声明持久性卷。

4. 部署 CR 实例。

   1. 使用 OpenShift 命令行界面：

      1. 保存 CR 文件。

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

         $ oc project <project_name>

         Copy to Clipboard Toggle word wrap

      3. 创建 CR 实例。

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

         Copy to Clipboard Toggle word wrap

   2. 使用 OpenShift Web 控制台：

      1. 配置完 CR 后，点 Create。

流程

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

   1. 使用 OpenShift 命令行界面：

      1. 以具有在您要创建部署的项目中部署 CR 的用户身份登录 OpenShift。

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

         Copy to Clipboard Toggle word wrap
      2. 打开一个名为 broker_activemqartemis_cr.yaml 的示例 CR 文件，该文件包含在您下载和提取的 Operator 安装的 deploy/crs 目录中。

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

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

      5. 单击 Create ActiveMQArtemis。

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

   对于基本代理部署，配置可能类似如下。

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

   Copy to Clipboard Toggle word wrap

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

2. 在 CR 的 deploymentPlan 部分中，添加一个 resources 部分。添加 limits 和 requests 子项。在每个子部分中，添加一个 cpu 和 memory 属性并指定值。例如：

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

   Copy to Clipboard Toggle word wrap

   limits.cpu

   在部署中运行的 Pod 的每个代理容器不能超过此主机节点 CPU 用量。

   limits.memory

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

   requests.cpu

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

   requests.memory

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

   注意

   如果您为资源指定 限制，但没有指定 请求，则代理容器会请求该资源配置 的限值 值。例如，在以下配置中，代理容器请求配置 的限值 值 500m cpu 和 1024M 内存。

   spec:
     deploymentPlan:
       size: 3
       ...
       resources:
         limits:
           cpu: "500m"
           memory: "1024M"

   Copy to Clipboard Toggle word wrap

   重要

   在不设置 请求 的情况下 设置限制，以控制请求的内存和 CPU 准确量，并确保如果部署有多个代理，为每个代理容器请求相同的值。

3. 部署 CR 实例。

   1. 使用 OpenShift 命令行界面：

      1. 保存 CR 文件。

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

         $ oc project <project_name>

         Copy to Clipboard Toggle word wrap

      3. 创建 CR 实例。

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

         Copy to Clipboard Toggle word wrap

   2. 使用 OpenShift Web 控制台：

      1. 配置完 CR 后，点 Create。