服务
服务代表后端应用或外部微服务,将该应用或微服务提供的所有 API 组织在一起。以下是几个关键关系。
-
路由与四层路由通常与服务保持一对多关系。一个服务只能具有路由或四层路由中的一种类型。单个服务可以关联多个路由或四层路由,定义如何将传入的 API 请求定向到服务中的相应功能。
-
上游通常与服务保持一对一关系。上游充当容器,指定处理服务请求的后端服务器地址。对于灰度部署、蓝绿部署或管理多个集群等高级场景,服务可以使用多个上游。此时,默认上游是大多数请求的主要目标,其他上游用于特定用途,例如将流量定向到灰度部署或辅助集群。
对于熟悉 Apache APISIX 的用户,需要注意 API7 企业版中的服务对象与 Apache APISIX 中的服务对象有所不同。
服务工作原理
下图展示了一个表示 Petstore 服务的已发布服务,其中包含两条配置不同的路由。你可以使用 HTTP GET 方法获取相关数据。

本示例仅将流量转发到一个上游节点。你可以根据需要添加更多上游节点,以维持平稳运行和响应,并避免单点故障。
服务状态
服务状态表示服务的整个 API 生命周期,包括模板、已发布和历史状态。
模板
API7 网关使用服务模板进行版本控制。这是可选的初始状态,允许在 API 上线前进行配置。配置完成后,将服务模板发布到网关组,为其分配版本并使 API 可访问。修改服务模板不会影响现有的已发布版本。
服务中心集中存放所有服务模板,每个模板都与其对应的已发布版本关联。
已发布
API7 网关的已发布服务提供可访问的 API。这些服务可以来自服务模板,并具有指定版本号,也可以直接在网关组中创建,不分配版本。对已发布服务的修改会立即生效,影响通过该服务路由的现有流量。
一个服务可以具有多个版本,每个版本具有唯一版本号,确保同一版本在不同网关组中的 API 行为一致。 API7 网关在每个网关组中只允许一个已发布的服务版本。你可以在不同网关组运行不同服务版本,实现并行部署。
直接在网关组中或通过 Ingress Controller 创建已发布服务时,API7 网关会自动创建服务模板,供后续版本控制使用。
历史
API7 网关在以下两种情况下创建历史版本。
- 将较新的服务版本发布到网关组时。
- 直接修改已发布服务,而不重新发布时。
这些历史版本仍可访问并用于参考,但不再处理 API 流量。
历史版本提供过去的服务配置,便于问题追踪和回滚。与模板状态类似,历史版本不可编辑。
运行时配置
以下配置属于服务运行时配置。
- 上游
- 服务主机
- 路径前缀
- 跳过路径前缀
- 插件
- 路由超时
服务运行时配置可以针对每个网关组进行定制,以适应不同环境。这些配置与服务版本和服务模板无关,由每个网关组独立管理。
例如,同一服务版本在不同网关组中的配置可以如下所示。
test环境的 API URL 为 https://api7-test.ai/v1/pet,节点地址为 127.0.0.1:80。production环境的 API URL 为 https://api7.ai/petstore/pet,节点地址为 192.168.0.1:80。
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 的关系也类似。