1.3.6 使用Pact Broker共享契约

优质
小牛编辑
135浏览
2023-12-01

在你的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上拉取契约。