suhlig/concourse-rss-resource

concourse-rss-resource

Concourse的RSS订阅源资源，用于在Concourse流水线中集成RSS订阅源内容的提取和处理。通过该资源可监控RSS订阅源的更新，提取项目信息并写入文件，适用于触发基于RSS更新的后续操作（如发送通知）。例如，可构建当PostgreSQL发布新版本时自动发送Slack通知的流水线。

核心功能与特性

• 提取RSS项目：从指定URL的RSS订阅源中提取项目内容
• 版本化管理：按项目的pubDate属性对提取的项目进行版本化
• 属性文件输出：将项目属性（标题、链接、发布日期等）写入文件，便于后续任务读取
• Concourse集成：符合Concourse资源规范，无缝集成到Concourse流水线中

使用场景与适用范围

• 监控软件版本发布订阅源（如PostgreSQL版本更新），触发通知或自动部署
• 跟踪新闻、博客等RSS订阅源更新，触发内容同步或处理流程
• 集成到需要基于RSS内容触发的Concourse流水线中，实现自动化响应

资源类型配置

在Concourse流水线中配置资源类型：

yaml
resource_types:
  - name: rss-resource
    type: registry-image
    source:
      repository: suhlig/concourse-rss-resource
      tag: latest

源配置

参数说明

• url：必填。RSS订阅源的URL。支持所有可被Ruby的RSS gem解析的格式。

行为

check：从订阅源提取项目

资源会获取url中指定的RSS订阅源，并通过项目的pubDate属性对项目进行版本化。

示例
撰写本文档时，PostgreSQL版本订阅源包含多个pubDate为“Thu, 27 Oct 2016 00:00:00 +0000”的项目（如9.6.1、9.5.5等），其中9.6.1为第一个项目，会通过check操作返回。

in：获取订阅源中的项目

资源会选择订阅源中具有请求pubDate的第一个项目，并将该项目的各属性值写入目标目录的文件中。

示例
当in操作请求pubDate为“Thu, 27 Oct 2016 00:00:00 +0000”的版本时，目标目录会生成以下文件：

可在后续任务中读取这些文件，例如构建https://github.com/cloudfoundry-community/slack-notification-resource%E4%BB%A5%E5%91%8A%E7%9F%A5%E6%96%B0PostgreSQL%E7%89%88%E6%9C%AC%E5%8F%AF%E7%94%A8%E3%80%82

out：未实现

本资源无输出功能。

开发指南

一次性环境设置

bash
bundle install

运行测试

测试需确保Docker守护进程已运行：

bash
bundle exec rake

Docker镜像构建

向master分支推送代码后，若Travis构建成功，将自动推送更新的Docker镜像。