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

在 Kubernetes 上部署 API7 Ingress Controller

本教程介绍如何在 Kubernetes 上部署 API7 网关和 Ingress Controller。API7 Ingress Controller 允许你在 Kubernetes 中以声明式方式配置 API7 网关。请参阅 API7 Ingress Controller 架构了解更多信息。

如果你不打算使用 Kubernetes 和 API7 Ingress Controller,可以跳过本教程,从启动第一个 API开始。

前提条件​

  1. 安装 API7 企业版。
  2. 有一个运行中的 Kubernetes 集群。
  3. 已安装 kubectl。

配置 DP Manager 和 Admin API 地址​

进入控制台:

  1. 从顶部导航栏选择组织,然后选择设置。
  2. 从左侧导航栏选择网关设置,然后选择部署选项卡。
  3. 将 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

新增网关组​

进入控制台:

  1. 从侧边导航栏选择网关组,然后点击新增网关组。
  2. 将类型选择为 Ingress Controller。
  3. 在名称字段中输入 api7-ingress。
  4. 点击新增。

网关组创建成功后,部署步骤面板会提示你安装 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 配置​

  1. 在命名空间字段中输入 api7。
  2. 在名称字段中输入 apisix。
  3. 点击生成脚本。
  4. 选择 Gateway API 或 Ingress 脚本。
    1. 如果使用 Gateway API,选择 Gateway API 选项卡。
    2. 如果使用 Ingress 或 APISIX CRD,选择 Ingress 选项卡。
  5. 复制生成的脚本,并在终端中运行。

安装网关实例​

进入控制台:

  1. 从侧边导航栏选择网关实例,然后点击新增网关实例。
  2. 切换到 Kubernetes 选项卡。
  3. 填写命名空间和其他参数,点击生成以查看部署脚本。
  4. 在终端中运行部署脚本。
信息

安装 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 创建的资源(例如服务和路由)在控制台中为只读。

后续步骤​

  1. 了解如何在网关组中创建网关实例。
  2. 按照入门教程,进一步了解如何在 API7 企业版中使用 API7 Ingress Controller。