Gitlab 8.16 API提交构建状态未显示description等属性求助

针对你遇到的GitLab 8.16版本中commit状态展示的问题，结合这个版本的特性，给你梳理下原因和解决方案：

1. Description 完全不显示的原因 #

GitLab 8.16的commit页面默认不会在状态摘要区域展示description，这是该版本的原生限制。你需要点击commit页面上的构建状态图标（比如失败的红叉、成功的绿勾），在弹出的详情对话框里才能看到你传递的description内容。

如果你调用API后返回的JSON数据里已经包含了description字段，说明参数传递是成功的，只是前端展示的位置和你预期不同而已。

2. Target URL 仅在特定位置显示的原因 #

同样是8.16版本的限制：target_url不会直接显示在commit的状态卡片上，只有两个入口能访问到它：

• 点击状态图标弹出的详情对话框里，会有对应的链接；
• 进入Build标签页下的具体构建号详情页，页面内会展示该target_url。

3. 是否需要额外配置？ #

在GitLab 8.16中，不需要额外的项目或全局配置，上述就是该版本的正常行为。如果想要在commit页面直接看到description和可点击的target_url链接，唯一的解决办法是升级到更高版本的GitLab——从GitLab 9.x系列开始，commit页面的状态卡片会直接展示description，并且target_url会作为可点击链接显示在状态旁边。

额外验证建议 #

先确认你的API调用格式是否正确（GitLab 8.16使用的是API v3，不是v4），正确的curl命令示例如下：

curl --request POST \
  --header "PRIVATE-TOKEN: <你的访问令牌>" \
  "https://你的GitLab实例地址/api/v3/projects/<项目ID>/statuses/<提交SHA>" \
  --form state="failed" \
  --form description="自定义构建失败说明：依赖包下载超时" \
  --form target_url="https://你的CI系统地址/builds/20/logs"

调用完成后，检查返回的JSON响应，确认description和target_url字段是否正确返回，如果返回正确，就说明API调用没问题，只是前端展示的版本限制问题。

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