如何在源代码管理中存储邮递员集合

Posted 2023-03-08

【中文标题】如何在源代码管理中存储邮递员集合

【英文标题】：How to store postman collections in source control

【发布时间】：2015-08-06 21:55:47

【问题描述】：

我正在使用POSTMAN 集合在打开 API 之前对其进行测试。我与一个开发团队合作，我们希望彼此共享/添加/编辑我们的集合。

事实证明，在源代码管理中执行此操作有点棘手，可以在 GitHUB 页面上的评论中看到：

此问题在 2.1.1 版（打包）中仍然存在

现在请求的顺序可能是确定的，但是从两台不同的机器和用户导出的集合的差异包括与导出的集合无关的数据。如果有几个人同时进行测试，则 diff 充满了所有者和其他 id 冲突。

将这些数据放入某种版本控制系统的最佳方法是什么？有其他建议吗？

【问题讨论】：

相关：Where are Postman collections saved?

【参考方案1】：

正如您所提到的，毫无疑问，将它放在 VCS 中会让您有些头疼。您最好的选择是使用 Postmans 功能来共享收藏。这是来自https://www.getpostman.com/docs/sharing的文档

从 Postman v0.9.3 开始，您可以更有效地共享和管理您的收藏。您要做的第一件事是创建一个 Postman 帐户。您可以使用您的电子邮件 ID 或 Google 帐户创建一个。创建帐户后登录后，您在 Postman 上上传的收藏集将链接到您的帐户。您可以稍后通过导航栏下拉菜单中的“共享集合”项删除它们。

【讨论】：

这确实增加了问题，因为我们做了一些自动化测试。如果用户修改 API 功能，更新他们的邮递员集合，持续集成和自动化测试将最终失败，直到正在处理的更改被签入。

如果您是 Mac，请查看 Paw for Teams 中的同步选项。我们支持分支和用户审查的合并。 paw.cloud/teams 自动测试支持将在我们的下一个主要版本中推出。

【参考方案2】：

Collection v2 格式消除了大部分（如果不是全部）可移植性问题。

http://blog.getpostman.com/2015/06/05/travelogue-of-postman-collection-format-v2/

格式必须具有高度的可移植性，以便可以在各种系统之间轻松传输而不会丢失功能。

【讨论】：

loosing :facepalm:

@Jonesopolis 呵呵，我没注意到。但这是直接引用，所以是的。

是的，伙计，您只需要紧凑的功能，它不应该是松散的。但更严重的是，我们使用 v2.1 并且协作仍然是一场噩梦，因为测试运行结果、随机 id 等都保存到集合文件中。我们已经多次不小心覆盖了彼此的更改。我认为邮递员共享收藏是要走的路。但我确实希望他们不是实现自己的版本控制，而是创建一种对版本控制更友好的格式，让我们选择自己的 VCS...

【参考方案3】：

要自动共享您现有的邮递员收藏，您可以使用 Postman Pro。 这是一项提供的付费服务，团队负责人可以使用该服务为其团队购买完整的方案并作为管理员工作。 Postman pro 支持以下功能以及更多功能：

API 中的任何更改都会自动反映在 Postman 中以供所有成员使用 成员订阅团队库中的集合并收到任何更改的通知。

更多信息可以参考： https://app.getpostman.com/dashboard/team-upgrades

这是我与我的自动化测试团队一起使用的。

【讨论】：

它似乎不适用于私人托管的 git，不过

不，不是本地托管的 Git，而是 Postman Pro 本身将作为源代码控制，如果你有一个帐户并且你已经在机器上下载了 Postman，那么你很高兴。

【参考方案4】：

Postman 中的源代码控制

关于共享收藏以便您与队友协作的问题已通过几种不同的方式得到解答，例如sharing the collection 或syncing to a team account。

Postman 中的版本控制

问题的另一部分是关于将 Postman 数据放入版本控制系统。 Postman 为付费团队帐户引入了一些版本控制功能，例如能够restore collections 到活动源中的某个点。

付费团队帐户还可以集成以将他们的收藏同步到他们自己的版本控制系统like GitHub for example。如果您使用的是免费帐户，则可以使用 Postman API 构建您自己的类似集成以更新集合。

这篇博文谈到了some of the version control features in Postman。

更新：Postman 在 Postman 应用程序 v6.7.1 中发布了 forking and merging，因此您可以在应用程序中管理版本控制。