1.3.6 使用Pact Broker共享契约
优质
小牛编辑
137浏览
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手动操作
- 参见API定义中的
cURL
例子
更多信息,请前往Pact Broker站点。
另外的备选方法
1. 消费者
的CI构建时将契约提交到提供者
的代码库中
无须赘述。
2. 将契约发布为CI构建产物
找出最近一次成功构建所创建契约的URL地址,在pact:verify任务中将配置指向该URL。
3. 使用Github/Bitbucket URL
这只适用于不需要授权认证的仓库。在对pact测试做了任何修改并提交之前,确保你总会重新生成一份契约文件,并且提交之前测试总是通过的,因为你可不想在失败的构建基础上验证契约。
4. 将契约推送到Amazon S3
Pact::Retreaty工具提供了一套极轻量级的机制,可以将pact契约推送到S3和从S3上拉取契约。