跳转到内容
Nantian Gateway

环境要求

安装 Nantian Gateway 之前，请确认环境满足以下要求。

Kubernetes 集群

Section titled “Kubernetes 集群”

需要运行 1.28 或更高版本的 Kubernetes 集群。任何符合标准的 Kubernetes 发行版均受支持，从本地开发环境到托管云服务均可。

本地开发推荐使用 Kind（Kubernetes IN Docker）。Kind 是一个单二进制文件、快速创建集群的工具，与项目预配置的 Kind 配置文件配合良好。

创建 Kind 集群

Section titled “创建 Kind 集群”

从 Kind 官方发布页面 安装 Kind。使用提供的配置文件创建集群：

Terminal window
kind create cluster --config gateway/deploy/kubernetes/overlays/kind/kind-config.yaml

此配置创建一个单节点集群，并设置宿主机端口映射以访问网关：

服务集群端口宿主机端口
HTTP3008018080
HTTPS3044318443
UDP 主300005300
UDP 备300015301
Admin API3000019000
Admin API (gRPC)3000119001

部署完成后，网关可通过 http://localhost:18080 访问。

验证集群运行正常：

Terminal window
kubectl cluster-info

预期输出：

Kubernetes control plane is running at https://127.0.0.1:XXXX
CoreDNS is running at https://127.0.0.1:XXXX/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

CLI 工具

Section titled “CLI 工具”

以下命令行工具必须已安装并可在 PATH 中访问：

工具最低版本用途
kubectl1.28集群交互和资源清单应用
helm3.12通过 Helm Chart 安装 Nantian Gateway

kubectl

Section titled “kubectl”

按照 Kubernetes 官方文档 安装 kubectl。验证安装：

Terminal window
kubectl version --client

预期输出（版本号因安装而异）：

Client Version: v1.31.0
Kustomize Version: v5.4.2

Helm

Section titled “Helm”

按照 Helm 官方文档 安装 Helm。验证安装：

Terminal window
helm version --short

预期输出：

v3.14.0+ge36b354

Gateway API CRD

Section titled “Gateway API CRD”

Nantian Gateway 要求集群中已安装 Kubernetes Gateway API CRD。这些 CRD 定义了 Gateway、GatewayClass、HTTPRoute 等网关用于配置的资源类型。

安装标准上游通道的 Gateway API CRD：

Terminal window
kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.5.1/standard-install.yaml

验证 CRD 已安装：

Terminal window
kubectl get crd gateways.gateway.networking.k8s.io

预期输出：

NAME                                    CREATED AT
gateways.gateway.networking.k8s.io      2024-01-01T00:00:00Z

下一步

Section titled “下一步”

完成所有环境要求验证后，继续前往快速开始部署 Nantian Gateway。