如何在Azure DevOps项目描述页添加自动更新的构建/部署状态标识？

一、状态标识的本质来源 #

你看到的绿/红状态标，其实就是CI/CD流水线的运行结果快照，数据直接取自Azure DevOps（或GitHub）的构建、部署流水线执行记录：

• 绿色：流水线（构建/部署）执行成功
• 红色：流水线执行失败（比如代码编译报错、测试不通过、部署失败等）

二、Azure DevOps实现自动同步的具体操作 #

1. 使用官方自带的状态徽章（最简便） #

Azure DevOps内置了生成状态徽章的功能，步骤如下：

• 打开你的Azure DevOps项目，找到目标流水线（Build或Release流水线都可以）
• 点击流水线右上角的「...」（更多选项），选择「Status badge」
• 在弹出的窗口里复制现成的Markdown代码，直接粘贴到项目的ReadMe.md文件中即可，这个徽章会自动同步流水线的最新状态

2. 自定义徽章样式（可选） #

要是觉得官方徽章样式不符合需求，可以用第三方动态徽章工具，结合Azure DevOps的API实现：

• 先创建Azure DevOps的个人访问令牌(PAT)，权限需勾选「Build (Read)」或「Release (Read)」
• 按照第三方工具的配置规则，调用Azure DevOps的构建/部署状态API，根据返回的执行状态（成功/失败）自动切换绿/红样式，将生成的徽章Markdown代码粘贴到ReadMe里
• 注意：PAT属于敏感信息，要妥善保管，不要直接暴露在公开文件中

三、GitHub仓库状态标识的实现（补充） #

如果你同时需要在GitHub仓库的ReadMe中添加状态标识，步骤更简单：

• 进入GitHub仓库的Actions页面，找到目标工作流
• 点击工作流右上角的「...」，选择「Create status badge」
• 复制生成的Markdown代码粘贴到ReadMe中，徽章会自动同步工作流的最新运行状态

四、关键注意事项 #

• 权限设置：如果项目是私有仓库，要确保状态徽章能获取到流水线的访问权限——要么将流水线设置为公开可访问，要么使用带有PAT的请求链接（需保密处理）
• 实时性：这些状态徽章都是实时拉取数据的，每次打开ReadMe页面都会自动请求最新的流水线状态，无需手动更新

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