concourse-slack-alert-resource

一个结构化且具有明确设计理念的Slack通知资源，适用于Concourse。

!默认通知示例（图片宽度60%）

消息利用Concourse的资源元数据构建，显示流水线、任务、构建号和URL。

安装

通过在流水线配置的resource_types部分添加以下内容来使用此资源：

resource_types:

- name: slack-alert
  type: docker-image
  source:
    repository: arbourd/concourse-slack-alert-resource

有关向流水线配置添加resource_types的更多详情，请参见Concourse文档。

源配置

• url: 必填。Slack webhook URL。
• channel: 可选。消息发布的目标频道。若未设置，则使用webhook的默认频道。
• concourse_url: 可选。指向Concourse的外部URL。默认为环境变量ATC_EXTERNAL_URL。
• username: 可选。Concourse本地用户（或基本认证）用户名。若使用告警类型fixed或broke，且流水线非公开，则为必填项。
• password: 可选。Concourse本地用户（或基本认证）密码。若使用告警类型fixed或broke，且流水线非公开，则为必填项。
• disable: 可选。禁用资源（不发送通知）。默认为false。

行为

check: 无操作。

in: 无操作。

out: 向Slack发送消息。

根据告警类型向Slack发送结构化消息。

参数

• alert_type: 可选。发送到Slack的告警类型。参见告警类型。默认为default。
• channel: 可选。消息发布的频道。默认为源配置中的channel设置。
• channel_file: 可选。包含文本的文件，用于覆盖channel。若无法读取文件，则使用channel。
• message: 可选。告警顶部的状态消息。默认为告警类型名称。
• message_file: 可选。包含文本的文件，用于覆盖message。若无法读取文件，则使用message。
• text: 可选。告警消息下方的附加文本。默认为空字符串。
• text_file: 可选。包含文本的文件，用于覆盖text。若无法读取文件，则使用text。
• color: 可选。通知栏的颜色（十六进制值）。默认为告警类型的图标颜色。
• disable: 可选。禁用此告警。默认为false。

告警类型

• default

  !default类型示例（图片宽度50%）

• success

  !success类型示例（图片宽度50%）

• failed

  !failed类型示例（图片宽度50%）

• started

  !started类型示例（图片宽度50%）

• aborted

  !aborted类型示例（图片宽度50%）

• fixed

  一种特殊告警类型，仅在上一次构建未成功时发送通知。若使用非公开流水线，则需要为资源设置username和password。

  !fixed类型示例（图片宽度50%）

• broke

  一种特殊告警类型，仅在上一次构建成功时发送通知。若使用非公开流水线，则需要为资源设置username和password。

  !broke类型示例（图片宽度50%）

示例

Out

使用默认告警类型，自定义消息和颜色：

resources:
- name: notify
  type: slack-alert
  source:
    url: [***]

jobs:
  # ...
  plan:
  - put: notify
    params:
      message: 已完成
      color: "#eeeeee"

使用内置告警类型和相应的构建钩子：

resources:
- name: notify
  type: slack-alert
  source:
    url: [***]

jobs:
  # ...
  plan:
  - put: notify
    params:
      alert_type: started
  - put: some-other-task
    on_success:
      put: notify
      params:
        alert_type: success
    on_failure:
      put: notify
      params:
        alert_type: failed
    on_abort:
      put: notify
      params:
        alert_type: aborted

使用fixed告警类型：

resources:
- name: notify
  type: slack-alert
  source:
    url: [***]
    # 若流水线为私有，`alert_type: fixed`需要Concourse凭据
    username: concourse
    password: concourse

jobs:
  # ...
  plan:
  - put: some-other-task
    on_success:
      put: notify
      params:
        # 仅在构建成功且为修复状态时发送通知
        alert_type: fixed