跳到主要内容
版本：3.10.x

安装包

API7 网关以签名容器镜像的形式发布到 Docker Hub，并以 Helm Chart 的形式发布到 API7 官方 Chart 仓库。

容器镜像​

以下官方镜像发布在 Docker Hub 上，并使用 Cosign 签名。部署前请验证镜像签名，确认镜像完整性。

镜像用途
api7/api7-ee-3-gateway基于 Apache APISIX 的数据面（API 网关）。
api7/api7-ee-dp-manager控制面组件，在 mTLS 端口 7943 上向数据面公开 etcd 兼容 API。
api7/api7-ee-3-integrated集成控制面镜像，捆绑控制台、Admin API 和相关服务，用于单容器部署。
api7/api7-ee-developer-portal开发者门户后端。
api7/api7-ee-developer-portal-fe开发者门户前端。

网关镜像内容​

API7 企业版从 3.10.9 版本开始支持。

api7/api7-ee-3-gateway 是基于 scratch 构建的 distroless 镜像。镜像中包含网关、网关所需的系统库、CA 证书、时区数据，以及一个静态 BusyBox，提供 /bin/sh 和 wget、nc、nslookup、cat、grep、tail 等常用工具。镜像不包含 curl、getent、Bash，也不包含 apt 和 dpkg 包管理工具。/bin/bash 路径是一个转发到 BusyBox shell 的包装脚本。网关以 apisix 用户运行，UID 为 636。

更早的版本中，该镜像基于 Ubuntu 24.04，同样以 UID 636 运行，也不包含 curl、wget 和 nslookup。

如需从网关的网络视角排查问题，请在网关的网络命名空间中另起一个带有所需工具的容器，而不是向网关容器中添加工具。这种方式对两类镜像都适用：

  • 在 Kubernetes 上，在网关 Pod 中启动临时调试容器，例如 kubectl debug -n api7 -it <gateway-pod> --image=curlimages/curl:8.10.1 -- curl -v "http://<upstream-host>:<upstream-port>/"。
  • 在 Docker 上，加入网关容器的网络，例如 docker run --rm --network container:<gateway-container> curlimages/curl:8.10.1 -v "http://<upstream-host>:<upstream-port>/"。

基于 FROM api7/api7-ee-3-gateway 构建的自定义镜像无法使用 apt-get 安装软件包，请改用 COPY 向此类镜像添加文件。

独立的 api7/api7-ee-3-gateway-distroless 镜像在 3.10.8 版本之后不再发布，已发布的标签仍可拉取。如果你正在使用该镜像，请改用 api7/api7-ee-3-gateway。

拉取镜像​

镜像默认托管在 Docker Hub 上。对于离线环境，请先拉取这些镜像，再将其推送到私有镜像仓库。

docker pull api7/api7-ee-3-gateway:<version>
docker pull api7/api7-ee-dp-manager:<version>
docker pull api7/api7-ee-3-integrated:<version>

将 <version> 替换为与目标 API7 网关版本完全匹配的标签。生产环境中应始终固定明确版本，不要使用 latest。

Helm Chart​

Helm Chart 是在 Kubernetes 上部署 API7 网关的推荐方式。

Chart仓库用途
API7 控制面api7/api7ee3部署控制台、Admin API、DP Manager、开发者门户，以及用于评估的可选内置 PostgreSQL。
API7 数据面api7/gateway部署一个或多个连接现有控制面的数据面实例。

添加 Helm 仓库​

helm repo add api7 https://charts.api7.ai
helm repo update

完整的 Helm 安装步骤请参阅在 Kubernetes 上部署 API7 企业版。

CLI 工具​

以下 CLI 工具通常与 API7 网关配合使用：

工具用途获取方式
ADCAPI7 网关的声明式配置 CLI。安装和使用方法请参阅 ADC 文档。
kubectlKubernetes 集群管理。安装 kubectl
helmKubernetes 包管理。安装 Helm

许可证文件​

所有 API7 网关安装都需要有效许可证。