服务契约指基于OpenAPI规范的微服务接口描述,是微服务系统运行和治理的基础。您无需在应用中引入依赖,直接部署后,便可以通过服务契约在线查看微服务接口、路径等API信息,不但能查询提供的服务,还能方便的使用服务测试等功能。

背景信息

服务契约包含了以下3个主要功能:

  • API查询

    查看服务提供者或消费者的重要API信息,包括方法名、参数列表、返回类型。Spring Cloud服务还支持查看请求方法、请求路径、所属类的类名等信息。

  • Swagger注解解析

    作为OpenAPI规范的主要制定者,Swagger虽并非是唯一支持OpenAPI的工具,但基本也属于一种事实标准。

    服务契约支持Swagger注解解析,并在控制台的服务契约页面进行展示:

    • Swagger2的注解解析(例如@ApiOperation,@ApiParam,@ApiImplicitParam),解析value值在描述列展示。
    • OpenAPI3的注解解析(例如@Operation,@Parameter),解析description值在描述列展示。
  • 服务测试的前置条件

    服务测试功能需要基于通过服务契约收集的服务的API信息,对服务接口或路径进行测试。

查看应用的服务契约

  1. 登录EDAS控制台
  2. 在左侧导航栏选择微服务治理 > Spring Cloud
  3. Spring Cloud左侧导航栏单击服务查询
  4. 在顶部菜单栏选择地域,在页面中选择服务的微服务空间,然后单击具体服务名。
  5. 服务详情面板的元数据区域查看接口元数据中的服务的API信息。

    当使用Swagger注解时,会在描述列显示相应信息。

    服务详情-服务契约

查看服务契约的变更通知

  1. 登录EDAS控制台
  2. 在左侧导航栏单击应用列表,在顶部菜单栏选择地域,在页面中选择服务的微服务空间
  3. 在集群类型下拉列表中选择容器服务/Serverless K8s集群,然后单击目标应用名称。
  4. 应用总览页面左侧导航栏单击变更记录
  5. 变更记录页面的变更类型下拉列表中,选择部署应用,然后单击变更记录操作列的查看
  6. 在变更记录详情页面单击单击查看变更
    查看服务契约变更通知
    您可在服务契约变化面板中查看服务契约的变更记录,包括增加Methods删除Methods修改Methods