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

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

   1. 使用 OpenShift 命令行界面：

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

         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 的用户身份登录控制台。
      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

   观察 broker_activemqartemis_cr.yaml 示例 CR 文件中的，image 属性被设置为 占位符 的默认值。这个值表示，默认情况下 image 属性没有指定用于部署的代理容器镜像。要了解 Operator 如何确定要使用的适当代理容器镜像，请参阅 第 2.6 节 “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-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。您会看到一个名为 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

      2. 访问代理 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/v1beta1
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
   spec:
     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