如何通过GitHub Status API标记OpenShift构建结果？

当然有成熟的方案可以实现！我之前帮团队落地过类似的需求，刚好能解决你提到的两个痛点——获取提交SHA、以及构建失败时也能触发状态更新，下面给你一步步拆解操作：

1. 准备GitHub权限凭证 #

首先需要一个有仓库状态修改权限的GitHub Personal Access Token（PAT）：

• 登录GitHub，进入「Settings > Developer settings > Personal access tokens」
• 生成新token，勾选repo权限（这是修改仓库提交状态必需的）
• 在OpenShift中创建Secret存储这个token，避免明文泄露：

  oc create secret generic github-status-token --from-literal=token=你的GitHub_PAT
  

2. 编写状态更新脚本并存储为ConfigMap #

我们需要一个脚本调用GitHub Status API，脚本会自动从OpenShift的环境变量中获取提交SHA：
创建update-github-status.sh脚本：

#!/bin/bash
set -euo pipefail

# 从环境变量读取配置（后续会注入到Build中）
GITHUB_REPO="${GITHUB_REPO}"
BUILD_STATUS="$1"
COMMIT_SHA="${BUILD_SOURCE_REVISION}"
GITHUB_TOKEN=$(cat /var/run/secrets/github/token)

# 构造GitHub API请求
API_URL="https://api.github.com/repos/${GITHUB_REPO}/statuses/${COMMIT_SHA}"
PAYLOAD=$(cat <<EOF
{
  "state": "${BUILD_STATUS}",
  "description": "OpenShift Build ${BUILD_NAME} ${BUILD_STATUS}",
  "context": "openshift/build"
}
EOF
)

# 发送请求更新状态
curl -X POST \
  -H "Authorization: token ${GITHUB_TOKEN}" \
  -H "Content-Type: application/json" \
  -d "${PAYLOAD}" \
  "${API_URL}"

然后将脚本存入OpenShift ConfigMap：

oc create configmap github-status-scripts --from-file=update-github-status.sh

3. 修改BuildConfig配置钩子与环境变量 #

接下来要让你的OpenShift Build在成功/失败时触发脚本，同时注入必要的资源和变量：
编辑你的BuildConfig：

oc edit bc/你的BuildConfig名称

在spec节点下添加以下配置：

spec:
  strategy:
    # 这里是你原有的构建策略（比如sourceStrategy/dockerStrategy）
    sourceStrategy:
      # ... 你的原有配置
      env:
        # 注入你的GitHub仓库信息（格式：组织名/仓库名）
        - name: GITHUB_REPO
          value: "your-org/your-repo"
      # 挂载Secret和ConfigMap到构建容器
      volumes:
        - name: github-token
          secret:
            secretName: github-status-token
        - name: github-scripts
          configMap:
            name: github-status-scripts
      volumeMounts:
        - name: github-token
          mountPath: /var/run/secrets/github
          readOnly: true
        - name: github-scripts
          mountPath: /opt/scripts
          readOnly: true
  # 配置构建钩子：成功和失败时分别触发脚本
  hooks:
    # 构建成功时执行
    postBuild:
      failurePolicy: Ignore
      script: |
        #!/bin/bash
        chmod +x /opt/scripts/update-github-status.sh
        /opt/scripts/update-github-status.sh success
    # 构建失败时执行
    failure:
      failurePolicy: Ignore
      script: |
        #!/bin/bash
        chmod +x /opt/scripts/update-github-status.sh
        /opt/scripts/update-github-status.sh failure

关键细节说明 #

• 提交SHA获取：OpenShift会自动给Build注入BUILD_SOURCE_REVISION环境变量，值就是触发构建的GitHub提交SHA，完全不需要额外处理
• 失败时触发：通过failure钩子，即使构建本身失败，也会执行状态更新脚本，解决了你担心的失败无法发起请求的问题
• 安全规范：用Secret存储GitHub Token，避免明文暴露；failurePolicy: Ignore确保钩子执行失败不会影响原构建的状态（比如即使更新GitHub状态失败，OpenShift构建的结果也不受影响）

配置完成后，每次触发OpenShift构建，无论成功或失败，GitHub对应提交的页面都会显示「openshift/build」的状态标记啦！

内容的提问来源于stack exchange，提问作者nyxthulhu