3.4. 创建基于 Operator 的代理部署

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

   1. 使用 OpenShift 命令行界面：

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

         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-sss 的新 StatefulSet。

   1. 点 ex-aao-s 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