在 Kubernetes 上部署 API7 Ingress Controller
本教程介绍如何在 Kubernetes 上部署 API7 网关和 Ingress Controller。API7 Ingress Controller 允许你在 Kubernetes 中以声明式方式配置 API7 网关。请参阅 API7 Ingress Controller 架构了解更多信息。
如果你不打算使用 Kubernetes 和 API7 Ingress Controller,可以跳过本教程,从启动第一个 API开始。
前提条件
- 安装 API7 企业版。
- 有一个运行中的 Kubernetes 集群。
- 已安装 kubectl。
配置 DP Manager 和 Admin API 地址
进入控制台:
- 从顶部导航栏选择组织,然后选择设置。
- 从左侧导航栏选择网关设置,然后选择部署选项卡。
- 将 DP Manager 地址(
:7943)和 Admin API 地址(:7443)更新为 HTTPS URL。
创建并设置命名空间
你可以选择为资源创建一个新的命名空间,并将其设置为首选命名空间,从而不必在每条命令中显式指定命名空间。
创建新的命名空间 api7,并将其设置为首选命名空间:
kubectl create namespace api7 && \
kubectl config set-context --current --namespace=api7
验证默认命名空间是否已修改:
kubectl config view --minify | grep namespace:
你应该看到命名空间已设置:
namespace: api7
新增网关组
进入控制台:
- 从侧边导航栏选择网关组,然后点击新增网关组。
- 将类型选择为 Ingress Controller。
- 在名称字段中输入
api7-ingress。 - 点击新增。
网关组创建成功后,部署步骤面板会提示你安装 Ingress Controller 并部署 GatewayProxy 配置。
安装 Ingress Controller
复制控制台中的部署脚本,并在终端中运行。如果部署成功,你应该看到类似以下内容的响应:
NAME: api7-ingress
LAST DEPLOYED: Tue Jul 29 10:17:51 2025
NAMESPACE: api7
STATUS: deployed
REVISION: 1
TEST SUITE: None
部署 GatewayProxy 配置
- 在命名空间字段中输入
api7。 - 在名称字段中输入
apisix。 - 点击生成脚本。
- 选择 Gateway API 或 Ingress 脚本。
- 如果使用 Gateway API,选择 Gateway API 选项卡。
- 如果使用 Ingress 或 APISIX CRD,选择 Ingress 选项卡。
- 复制生成的脚本,并在终端中运行。
安装网关实例
进入控制台:
- 从侧边导航栏选择网关实例,然后点击新增网关实例。
- 切换到 Kubernetes 选项卡。
- 填写命名空间和其他参数,点击生成以查看部署脚本。
- 在终端中运行部署脚本。
信息
安装 API7 企业版时,可能已在 default 网关组中初始化一个网关实例。为避免端口冲突,可以修改新网关实例的监听端口,或移除 default 网关组中未使用的实例。
验证
检查 Pod 状态:
kubectl get pods
你应该看到所有 Pod 均处于 Running 状态:
NAME READY STATUS RESTARTS AGE
api7-ee-3-gateway-698f85d98b-jxrwp 1/1 Running 0 6m
api7-ingress-774578b557-lw2wk 1/1 Running 0 10m
返回控制台并选择网关实例,你应该看到一个处于 healthy 状态的网关实例。
请注意,使用 API7 Ingress Controller 创建的资源(例如服务和路由)在控制台中为只读。