镜像概述

cogito是一个轻量且友好的Concourse资源，主要用于在CI/CD流水线中更新GitHub提交状态，并支持可选地向Google Chat发送通知。该镜像设计简洁，易于集成，能够帮助开发团队实时跟踪流水线执行结果。详细信息可参考项目GitHub仓库：[***]

核心功能和特性

• GitHub提交状态更新：自动同步Concourse任务执行状态（如成功、失败、 pending 等）到对应的GitHub提交记录
• Google Chat通知集成：可选配置Webhook，将状态变更信息推送至Google Chat频道，便于团队协作沟通
• 轻量级设计：镜像体积小，资源占用低，不影响流水线执行效率
• 易用性：配置简单，支持与Concourse现有流水线无缝集成

使用场景和适用范围

• CI/CD流水线状态反馈：在Concourse流水线中，用于将任务执行结果实时反馈至GitHub，方便开发者通过GitHub界面直接查看提交关联的构建状态
• 团队协作通知：当流水线执行成功或失败时，通过Google Chat及时通知相关团队成员，加快问题响应速度
• GitHub仓库项目：适用于所有基于GitHub进行代码管理，并使用Concourse作为CI/CD工具的开发项目

使用方法和配置说明

基本使用流程

1. 在Concourse流水线配置中定义该资源类型
2. 配置资源实例，提供GitHub认证信息及可选的Google Chat Webhook
3. 在任务中使用该资源更新状态

配置示例

资源类型定义

yaml
resource_types:
- name: cogito
  type: docker-image
  source:
    repository: pix4d/cogito  # 请根据实际镜像仓库地址调整

资源实例配置

yaml
resources:
- name: update-github-status
  type: cogito
  source:
    github_token: ((github-personal-access-token))  # GitHub访问令牌，需有repo:status权限
    google_chat_webhook: ((google-chat-webhook))  # 可选，Google Chat Webhook URL

任务中使用

yaml
jobs:
- name: test-and-update-status
  plan:
  - get: code
    trigger: true
  - task: run-tests
    config:
      # 测试任务配置...
  - put: update-github-status
    params:
      commit: code/git/sha  # 提交SHA值
      status: success  # 状态值，可选：pending、success、failure、error
      context: concourse/test  # GitHub状态上下文，用于区分不同流水线
      description: "Tests passed successfully"  # 状态描述信息

详细配置参数

注：完整配置说明及更多高级用法，请参考项目GitHub仓库：[]