cloudinn/concourse-hangouts-resource

Concourse Google Hangouts资源镜像

镜像概述

这是Concourse CI的官方社区资源镜像，用于通过webhook向Google Hangouts房间发送构建通知。通知内容包含当前流水线名称、任务名称、构建编号等信息，还可附加自定义消息或从文件读取内容，帮助团队实时掌握CI/CD流程状态。

核心功能

• 向指定Google Hangouts频道推送构建状态通知
• 支持自定义消息及从文件读取附加文本
• 可全局或步骤级配置是否包含任务链接
• 兼容Concourse的try步骤，避免通知失败影响构建流程

使用场景

• 流水线任务启动、成功或失败时发送状态提醒
• 版本发布时推送版本号到团队沟通频道
• 构建过程中关键节点的状态同步

配置说明

资源类型配置

yaml
resource_types:
  - name: hangouts-resource
    type: docker-image
    source:
      repository: cloudinn/concourse-hangouts-resource
      tag: latest

源配置

• webhook_url：必填，Google Hangouts频道生成的webhook地址（如https://chat.googleapis.com/v1/spaces/ABC/messages?key=DEF）
• post_url：可选，是否包含当前任务链接，可在步骤参数中覆盖（默认：true）

示例：

yaml
resources:
- name: hangouts
  type: hangouts-resource
  source:
    webhook_url: {{pipeline_alerts_webhook}}
    post_url: true

参数说明（out步骤）

• message：可选，附加到通知的自定义消息
• message_file：可选，包含附加文本的文件路径
• post_url：可选，覆盖源配置中的post_url（默认：继承源配置）

使用示例

任务状态通知

yaml
jobs:
  - name: some-job
    plan:
      - try:
          put: hangouts
          params:
            message: "任务启动！"
            post_url: true
      # 其他构建步骤...
    on_failure:
      try:
        put: hangouts
        params:
          message: "任务失败！"
    on_success:
      try:
        put: hangouts
        params:
          message: "任务成功！"
          post_url: false

完整流水线示例

yaml
resource_types:
  - name: hangouts-resource
    type: docker-image
    source:
      repository: cloudinn/concourse-hangouts-resource
      tag: latest

resources:
- name: hangouts
  type: hangouts-resource
  source:
    webhook_url: ((hangouts_webhook))
    post_url: true

jobs:
  - name: test-notification
    serial: true
    plan:
      - try:
          put: hangouts
          params:
            message: "构建开始！"
    on_failure:
      try:
        put: hangouts
        params:
          message: "构建失败！"
    on_success:
      try:
        put: hangouts
        params:
          message: "构建成功！"

许可证

BSD 2-Clause