镜像概述

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工具的开发项目

使用方法和配置说明

基本使用流程

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

配置示例

资源类型定义

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_token	string	GitHub个人访问令牌，需包含`repo:status`权限	是
google_chat_webhook	string	Google Chat Webhook URL，用于发送通知	否
commit	string	目标GitHub提交的SHA值	是
status	string	提交状态，可选值：`pending`、`success`、`failure`、`error`	是
context	string	状态上下文标识符，用于在GitHub界面区分不同来源的状态更新	否
description	string	状态描述文本，将显示在GitHub提交状态中	否