跳到主要内容
版本:3.8.x

服务

服务代表后端应用或外部微服务,将该应用或微服务提供的所有 API 组织在一起。以下是几个关键关系。

  • 路由与四层路由通常与服务保持一对多关系。一个服务只能具有路由或四层路由中的一种类型。单个服务可以关联多个路由或四层路由,定义如何将传入的 API 请求定向到服务中的相应功能。

  • 上游通常与服务保持一对一关系。上游充当容器,指定处理服务请求的后端服务器地址。对于灰度部署、蓝绿部署或管理多个集群等高级场景,服务可以使用多个上游。此时,默认上游是大多数请求的主要目标,其他上游用于特定用途,例如将流量定向到灰度部署或辅助集群。

信息

对于熟悉 Apache APISIX 的用户,需要注意 API7 企业版中的服务对象与 Apache APISIX 中的服务对象有所不同。

服务工作原理​

下图展示了一个表示 Petstore 服务的已发布服务,其中包含两条配置不同的路由。你可以使用 HTTP GET 方法获取相关数据。

服务

本示例仅将流量转发到一个上游节点。你可以根据需要添加更多上游节点,以维持平稳运行和响应,并避免单点故障。

服务状态​

服务状态表示服务的整个 API 生命周期,包括模板、已发布和历史状态。

模板​

API7 网关使用服务模板进行版本控制。这是可选的初始状态,允许在 API 上线前进行配置。配置完成后,将服务模板发布到网关组,为其分配版本并使 API 可访问。修改服务模板不会影响现有的已发布版本。

服务中心集中存放所有服务模板,每个模板都与其对应的已发布版本关联。

已发布​

API7 网关的已发布服务提供可访问的 API。这些服务可以来自服务模板,并具有指定版本号,也可以直接在网关组中创建,不分配版本。对已发布服务的修改会立即生效,影响通过该服务路由的现有流量。

一个服务可以具有多个版本,每个版本具有唯一版本号,确保同一版本在不同网关组中的 API 行为一致。 API7 网关在每个网关组中只允许一个已发布的服务版本。你可以在不同网关组运行不同服务版本,实现并行部署。

备注

直接在网关组中或通过 Ingress Controller 创建已发布服务时,API7 网关会自动创建服务模板,供后续版本控制使用。

历史​

API7 网关在以下两种情况下创建历史版本。

  1. 将较新的服务版本发布到网关组时。
  2. 直接修改已发布服务,而不重新发布时。

这些历史版本仍可访问并用于参考,但不再处理 API 流量。

历史版本提供过去的服务配置,便于问题追踪和回滚。与模板状态类似,历史版本不可编辑。

运行时配置​

以下配置属于服务运行时配置。

  • 上游
  • 服务主机
  • 路径前缀
  • 跳过路径前缀
  • 插件
  • 路由超时

服务运行时配置可以针对每个网关组进行定制,以适应不同环境。这些配置与服务版本和服务模板无关,由每个网关组独立管理。

备注

例如,同一服务版本在不同网关组中的配置可以如下所示。

ServiceID 与 ServiceTemplateID​

API7 网关使用 Service Template ID 和 Service ID 两个关键标识符来标识服务,路由和四层路由也有类似的关键标识符。

  • 服务模板只具有 Service Template ID。服务模板中的路由或四层路由只具有 Route Template ID 或 Stream Route Template ID。
  • 网关组中的已发布服务同时具有 Service Template ID 和 Service ID,用于不同用途。已发布服务中的路由或四层路由同时具有 Route Template ID 或 Stream Route Template ID,以及 Route ID 或 Stream Route ID。
  • 历史版本只具有 Service Template ID。历史版本中的路由或四层路由只具有 Route Template ID 或 Stream Route Template ID。

Service ID 对应特定网关组中的一个已发布服务。直接通过 ADC、Admin API 或 Ingress Controller 创建已发布服务时,可以自定义此 ID。

ServiceID 只在其所属网关组内唯一。不同网关组中的两个已发布服务可以具有相同的 ServiceID,但不建议这样做。 Service ID 不能用于权限策略。

Service Template ID 由系统自动生成,是跨所有网关组持久存在的唯一、不可变标识符,用于服务版本控制。 此 ID 适用于服务本身,包括服务模板、所有网关组中的所有已发布版本,以及所有历史版本。 它在权限策略中发挥重要作用,允许你根据服务身份分配资源。

备注

Route ID 与 Route Template ID、Stream Route ID 与 Stream Route Template ID 的关系也类似。

相关阅读​