coco/post-publication-combiner

upp-post-publication-combiner

镜像概述和主要用途

upp-post-publication-combiner是一个用于同步内容和元数据发布流程的服务。它基于从PostConceptAnnotations或PostPublicationEvents接收的事件构建组合消息（内容+注释），并将组合消息发送至CombinedPostPublicationEvents Kafka队列。该服务是内容与元数据发布流程的同步组合点，支持通过强制端点生成包含内容和元数据存储实际数据的组合消息。

核心功能和特性

• 组合消息生成：接收PostConceptAnnotations或PostPublicationEvents事件，构建包含内容和注释的组合消息
• Kafka消息发送：将生成的组合消息发送至CombinedPostPublicationEvents Kafka队列
• 同步发布流程：作为内容和元数据发布流程的同步点，单个发布事件可能在CombinedPostPublicationEvents主题中生成两条消息（一条用于内容发布，一条用于元数据发布）
• 强制端点：提供强制端点，可将包含内容和元数据存储实际数据的组合消息放入队列

依赖服务

该服务依赖以下服务：

• kafka/kafka-proxy
• document-store-api（/content端点）
• public-annotations-api（/content/{uuid}/annotations端点）

安装方法

执行以下步骤进行安装：

bash
go get -u github.com/Financial-Times/post-publication-combiner
cd $GOPATH/src/github.com/Financial-Times/post-publication-combiner
dep ensure -vendor-only
go test ./...
go install

本地运行

1. 测试并安装二进制文件

bash
go test ./...
go install

2. 运行二进制文件

使用help标志查看可用的可选参数：

bash
$GOPATH/bin/post-publication-combiner --help

测试方法

• 可通过检查消费和生成的Kafka消息验证服务行为
• 也可使用强制端点进行测试

构建与部署

• 镜像构建：由Docker Hub构建（从master分支或GitHub标签），镜像地址：https://hub.docker.com/r/coco/post-publication-combiner/
• 持续集成：由CircleCI提供，项目地址：post-publication-combiner

服务/工具端点

API相关文档请参考api.yml

健康检查

提供以下标准管理端点：

/__gtg

• 返回状态码：503（如果/__health端点的任何检查返回false），否则返回200

/__health

执行以下检查：

• kafka-proxy是否可达
• document-store-api是否可达
• public-annotations-api是否可达

/__build-info

返回服务构建信息

日志

• 应用使用FT的https://github.com/Financial-Times/go-logger%E5%BA%93%EF%BC%88%E5%9F%BA%E4%BA%8Ehttps://github.com/sirupsen/logrus%EF%BC%89
• 注意：/__build-info和/__gtg端点因调用频繁，不记录日志