跳到主要内容

金蝶天燕 ADMQ 集成说明

金蝶Apusic分布式消息中间件（简称"ADMQ"） 是金蝶天燕公司是一款分布式消息中间件，具有多租户、跨集群数据复制、强一致性、高可靠、高并发等特性。

在 HAP 私有部署版本中，我们默认使用 Kafka 作为消息中间件，以提供高效的数据处理能力。然而，我们也充分考虑到信创要求，并已适配金蝶天燕公司的 ADMQ 产品。用户可以选择使用 ADMQ 来替代 Kafka。

具体集成步骤如下：

  1. 从金蝶天燕公司采购缓存中间件 ADMQ 并部署，支持单机、集群架构。

  2. 部署时，需要注意以下要求：

    • 开启 KAFKA 插件

    • 新增或调整下方参数为示例值

    transactionCoordinatorEnabled=true
    kafkaTransactionCoordinatorEnabled=true
    brokerDeleteInactiveTopicsEnabled=false
    defaultNumPartitions=10

  3. 部署完成后，需要手动创建一批 Topic，创建时分区数建议选择10，需要手动创建的 Topic 列表如下：

    ws-word
    ws-excel
    ws-rowindex
    ws-formulaensure
    ws-exattachment
    ws-largerelation
    ws-slowexcel
    ws-publicform
    ws-editcontrols
    ws-passiverelation

  4. 部署完成后会得到 ADMQ KAFKA 服务的节点连接地址、端口、密码

  5. 在 HAP 微服务配置文件中，添加如下变量，配置连接使用外部消息中间件

    ENV_KAFKA_ENDPOINTS: "192.168.0.251:9092"     # ADMQ KAFKA 服务地址

    # 如果 HAP 私有部署版是单机模式，下面变量也可以加一下，将容器内的 Kafka 服务禁止启动
    ENV_STANDALONE_DISABLE_SERVICES: "kafka"

  6. 重启 HAP 微服务生效