共享契约

在你的Pact之旅上，一定有些时候会生成许多Pact文件供提供者进行验证，而且要确保提供者访问的总是最新版本的契约文件。这当然很棒，但是很快就会繁琐到难于管理。

Pact Broker

这时就该Pact Broker登场了。它能够让你在项目之间共享契约，还可以让这些契约为人所用。它是正式使用Pact开发时的推荐方式，具有如下特性：

  • 自动生成接口文档
  • 动态生成调用关系网络图
  • 对Pact打标签的能力 (譬如 “prod”)，这样提供者就可以针对契约的某个固定版本进行验证，以保持向后兼容性。
  • Pact发布时可用于触发提供者端构建的Webhooks。
  • 提供对你的消费者和提供者发布周期之间的解耦能力
  • 提供交叉测试head/prod版本的能力

感谢我们的赞助者DiUS提供了一个免费托管的broker供你快速上手。

支持的语言

Ruby 通过pact_broker-client gem支持：

Pact JVM - Gradle

Pact JVM - JUnit

Pact JVM - SBT

Pact JVM - Maven

Golang

Pact JS

Pact .NET

通过HTTP手动操作

更多信息，请前往Pact Broker站点。

另外的备选方法

1. 消费者的CI构建时将契约提交到提供者的代码库中

无须赘述。

2. 将契约发布为CI构建产物

找出最近一次成功构建所创建契约的URL地址，在pact:verify任务中将配置指向该URL。

3. 使用Github/Bitbucket URL

这只适用于不需要授权认证的仓库。在对pact测试做了任何修改并提交之前，确保你总会重新生成一份契约文件，并且提交之前测试总是通过的，因为你可不想在失败的构建基础上验证契约。

4. 将契约推送到Amazon S3

Pact::Retreaty工具提供了一套极轻量级的机制，可以将pact契约推送到S3和从S3上拉取契约。