Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

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

3.4.1. 部署基本代理实例
复制链接

以下流程演示了如何使用自定义资源(CR)实例来创建基本代理部署。

注意

先决条件

步骤

当您成功安装 Operator 时，Operator 会运行并侦听与 CR 相关的更改。本例演示了如何使用 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 的项目中部署 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
    Copy to Clipboard Toggle word wrap

    观察 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>
        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 （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
        Copy to Clipboard Toggle word wrap

      2. 访问 broker 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

其他资源

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2026 Red Hat返回顶部