chbiel/concourse-pagerduty-notification-resource

concourse-pagerduty-notification-resource镜像

镜像概述

该镜像为Concourse CI提供PagerDuty通知资源类型，实现流水线状态与PagerDuty告警系统的集成，可向PagerDuty Events API v2发送事件（触发、确认、解决告警）。

核心功能

1. 支持三种事件动作：触发（trigger）、确认（acknowledge）、解决（resolve）PagerDuty告警
2. 自动生成基于流水线名称+任务名称的dedup_key，用于关联同一事件的不同动作
3. 提供调试日志功能（需谨慎使用，避免敏感数据泄露）
4. 兼容PagerDuty Events API v2大部分参数，可自定义告警摘要、来源、严重程度等细节

使用场景

• 流水线任务失败时触发PagerDuty告警，通知运维人员处理
• 任务成功完成后自动解决告警，更新状态
• 手动/自动确认告警，标记问题正在处理

配置说明

源配置（Source Configuration）

• debug（可选）：设置任意值启用调试日志，注意会记录敏感数据，需谨慎使用

动作（Behavior）

out：发送告警到PagerDuty

发送告警到PagerDuty，支持以下关键参数：

• generate_dedub_key（可选）：生成dedup_key，值为BUILD_PIPELINE_NAME + "_" + BUILD_JOB_NAME
• routing_key（必填）：PagerDuty集成密钥（敏感信息，需保密）
• event_action（必填）：事件类型，可选trigger/acknowledge/resolve

部署示例

Concourse流水线配置示例：

yaml
resource_types:
- name: pagerduty-notification
  type: docker-image
  source:
    repository: chbiel/concourse-pagerduty-notification-resource
    tag: latest

resources:
- name: pd-alarm
  type: pagerduty-notification
  source:
    debug: true

jobs:
- name: failing-task
  serial: true
  on_failure:
    put: pd-alarm
    params:
      generate_dedub_key: true
      routing_key: your_secret_integration_key
      event_action: trigger
      summary: '流水线任务失败'
      source: '测试流水线'
      severity: error
      custom_details:
        task_name: 'fail-task'
  on_success:
    put: pd-alarm
    params:
      generate_dedub_key: true
      routing_key: your_secret_integration_key
      event_action: resolve

  plan:
  - task: fail
    config:
      platform: linux
      image_resource:
        type: docker-image
        source:
          repository: alpine
      run:
        path: sh
        args:
        - -exc
        - |
          exit 1