还原Azure DevOps Server (TFS)中误删除的生成流水线
流水线历史记录
DevOps Server流水线的历史记录有完善的版本日志,用户可以随时回退到修改过程中的任何一个版本,还能比较差异。这个历史记录功能可以和代码库中的版本控制媲美。
图一:生成历史记录
但是,如果实施工程师辛辛苦苦配置的复杂流水线,不小心被一个小白删除了,而你翻遍了Azure DevOps Server 的所有菜单也找不到流水线的回收站菜单,此时估计你跳楼的心都有了。
图二:生成定义中的删除按钮
还好,微软为你提供了一瓶后悔药,你还有最后的一种方法还原被删除的流水线,那就是Rest API。但是需要注意,系统只保留4周内被删除的流水线数据,如果超出了4周,流水线将被永久删除。
下面我们来分别看看如何还原生成和发布流水线:
还原生成流水线
还原一条生成流水线的rest api格式如下:
使用上面api的核心,是需要了解流水线的id,就是definitionId。在当前版本的api中,没有获取所有生成定义的api,如果你不记得被删除的流水线ID,那么你需要根据最近新增加的流水线ID猜测,或者到数据库中使用SQL查询相关的表。
例如下面我在postman中使用到的api:
图三:postman中调用恢复流水线api
如果调用成功,系统会返回被恢复流水线的相关json数据;同时,你也可以在浏览器中看到恢复出来的数据了,只是生成的名称加上了前缀“(RESTORED 2019-03-21 13:45:49)”字样,如下图:
还原发布流水线
还原发布流水线的方式和上面还原生成流水线的方式差不多。
但是,在还原发布流水线之前,我们可以使用列表的api获取所有被删除的流水线,api格式如下:
Get http://tfs.southeastasia.cloudapp.azure.com/DefaultCollection/DemoProject/_apis/release/definitions?isdeleted=true
使用上面api,获取到需要还原的流水线ID后,就可以使用PATCH方法调用还原流水线的api了:
注意在postman中调用上面的api时,需要做到:
1. 调用api方式为PATCH
2. 必须在body中添加备注信息,备注内容如下:
{ "Comment" : "Deleted by mistake" }
3. body的数据格式为:application/json,或者application/json-patch+json
下面是调用在postman中的截图:
如果api调用成功,系统会返回被还原的流水线的相关json数据,你可以在web界面中看到被还原的流水线了。
在流水线的历史记录中,你可以看到还原过程中的日志信息:
看到这里,你不再需要担心误删除流水线数据了。
微软DevOps MVP 张洪君 http://www.cnblogs.com/danzhang
--End-