Gloo Gateway 在 Kubernetes 集群中的安装前准备指南

前言

Gloo Gateway 作为一款功能强大的 API 网关，需要在 Kubernetes 或 OpenShift 环境中进行部署。本文将详细介绍如何为 Gloo Gateway 准备不同类型的 Kubernetes 环境，包括本地开发环境和主流云服务商的托管 Kubernetes 服务。

准备工作

在开始安装 Gloo Gateway 之前，需要完成以下准备工作：

1. 确保 Kubernetes 版本符合 Gloo Gateway 的支持要求
2. 安装并配置好 kubectl 命令行工具
3. 根据您的 Kubernetes 发行版选择对应的配置方案

本地开发环境配置

Minikube 环境

Minikube 是在本地机器上运行单节点 Kubernetes 集群的理想选择，非常适合开发和测试场景。

配置步骤：

1. 启动 Minikube 集群（建议分配足够资源）：

   minikube start --memory=4096 --cpus=2
   

2. 验证 kubectl 上下文：

   kubectl config current-context
   

   应返回 minikube

3. 如上下文不正确，可切换：

   kubectl config use-context minikube
   

注意事项：

• 建议为 Minikube 分配至少 4GB 内存和 2个 CPU 核心
• 可通过 minikube dashboard 访问集群仪表盘

Kind 环境

Kind (Kubernetes in Docker) 使用 Docker 容器作为节点运行本地 Kubernetes 集群，比 Minikube 更轻量。

特殊配置：

1. 创建集群时暴露必要端口：

   kind create cluster --name kind --image kindest/node:v1.25.3 --config=- <<EOF
   kind: Cluster
   apiVersion: kind.x-k8s.io/v1alpha4
   nodes:
   - role: control-plane
     extraPortMappings:
     - containerPort: 31500
       hostPort: 31500
       protocol: TCP
     - containerPort: 32500
       hostPort: 32500
       protocol: TCP
   EOF
   

2. 访问服务时需使用本地端口：

   curl http://localhost:31500/all-pets
   

优势：

• 无需额外虚拟化软件
• 启动速度快
• 资源占用低

生产环境配置

OpenShift 环境

OpenShift 在安全方面与标准 Kubernetes 有显著差异，需要特别注意：

关键配置：

1. 使用浮动用户 ID 的 Helm 配置：

   global:
     securitySettings:
       floatingUserId: true
   

2. 企业版可能需要额外权限：

   oc adm policy add-scc-to-user anyuid -z default -n gloo-system
   

安全考虑：

• 默认使用随机用户 ID 运行容器
• 可通过 Security Context Constraints (SCCs) 调整安全策略
• 建议遵循 OpenShift 默认安全行为

主流云服务商 Kubernetes 服务

Google Kubernetes Engine (GKE)

1. 创建集群：

   gcloud container clusters create myGKECluster --zone=us-central1-a
   

2. 设置管理员权限：

   kubectl create clusterrolebinding cluster-admin-binding \
     --clusterrole cluster-admin \
     --user $(gcloud config get-value account)
   

私有集群注意事项：

• 需配置 Cloud NAT 访问外部容器仓库
• 需设置防火墙规则允许主节点与工作节点通信

Azure Kubernetes Service (AKS)

1. 创建资源组和集群：

   az group create --name myResourceGroup --location eastus
   az aks create --resource-group myResourceGroup --name myAKSCluster --node-count 1
   

2. 获取管理员凭证：

   az aks get-credentials --resource-group myResourceGroup --name myAKSCluster --admin
   

Amazon EKS

1. 使用 eksctl 创建集群：

   eksctl create cluster --name myEKSCluster --region=us-east-1
   

2. 更新 kubeconfig：

   aws eks --region us-east-1 update-kubeconfig --name myEKSCluster
   

进阶配置建议

DNS 管理

虽然 Kubernetes 会处理集群内部 DNS，但对外部访问需要考虑：

• 配置外部 DNS 服务
• 设置适当的 DNS 记录指向网关服务
• 考虑使用通配符 DNS 简化配置

证书管理

为生产环境考虑：

• 使用 Let's Encrypt 自动获取证书
• 配置证书自动续期
• 考虑使用证书管理器（如 cert-manager）

后续步骤

完成集群配置后，您可以：

1. 按照 Gloo Gateway 官方安装指南进行部署
2. 验证各组件是否正常运行
3. 开始配置路由规则和流量管理策略

通过以上步骤，您已经为 Gloo Gateway 的安装准备了合适的 Kubernetes 环境。不同环境有各自的特点和注意事项，请根据实际需求选择最适合的配置方案。