摘要
本文深入探讨了 Higress 云原生 API 网关的 Helm 部署方案,从基础概念、环境准备、部署配置到运维管理,全面介绍了如何通过 Helm 在 Kubernetes 集群中部署和管理 Higress。通过详细的配置示例和最佳实践,帮助开发者快速掌握 Higress 的部署方法。
1. Higress 概述
1.1 系统架构
1.2 核心特性
mindmap
root((Higress))
网关功能
流量网关
微服务网关
安全网关
部署特性
Helm 部署
Kubernetes 集成
Istio 支持
运维特性
自动扩缩容
监控告警
配置管理
2. 环境准备
2.1 前置条件
- Kubernetes 集群
- Helm 3.x
- kubectl 工具
- 网络连接
2.2 部署流程
3. 部署配置
3.1 添加 Helm 仓库
# 添加 Higress Helm 仓库
helm repo add higress.io https://higress.io/helm-charts
helm repo update
3.2 基础配置
# values.yaml
controller:
# 控制器配置
replicas: 1
resources:
limits:
cpu: "1000m"
memory: "2048Mi"
requests:
cpu: "500m"
memory: "2048Mi"
# 自动扩缩容配置
autoscaling:
enabled: true
minReplicas: 1
maxReplicas: 5
targetCPUUtilizationPercentage: 80
gateway:
# 网关配置
replicas: 2
resources:
limits:
cpu: "2000m"
memory: "2048Mi"
requests:
cpu: "2000m"
memory: "2048Mi"
# 服务配置
service:
type: LoadBalancer
ports:
- name: http2
port: 80
targetPort: 80
- name: https
port: 443
targetPort: 443
3.3 高级配置
# 高级配置示例
controller:
# 自动 HTTPS 配置
automaticHttps:
enabled: true
email: "your-email@example.com"
# 探针配置
probe:
httpGet:
path: "/ready"
port: 8888
initialDelaySeconds: 1
periodSeconds: 3
timeoutSeconds: 5
gateway:
# 网络配置
hostNetwork: false
httpPort: 80
httpsPort: 443
# 监控配置
metrics:
enabled: true
provider: "monitoring.coreos.com"
interval: "15s"
4. 部署实践
4.1 安装部署
# 安装 Higress
helm install higress -n higress-system higress.io/higress \
--create-namespace \
--render-subchart-notes \
-f values.yaml
4.2 验证部署
# 检查 Pod 状态
kubectl get pods -n higress-system
# 检查服务状态
kubectl get svc -n higress-system
# 检查配置
kubectl get configmap -n higress-system
4.3 配置更新
# 更新配置
helm upgrade higress -n higress-system higress.io/higress \
-f values.yaml
5. 最佳实践
5.1 资源规划
5.2 高可用配置
# 高可用配置示例
controller:
replicas: 3
autoscaling:
enabled: true
minReplicas: 3
maxReplicas: 5
# 反亲和性配置
affinity:
podAntiAffinity:
requiredDuringSchedulingIgnoredDuringExecution:
- labelSelector:
matchExpressions:
- key: app
operator: In
values:
- higress-controller
topologyKey: kubernetes.io/hostname
gateway:
replicas: 3
autoscaling:
enabled: true
minReplicas: 3
maxReplicas: 5
5.3 监控配置
# 监控配置示例
gateway:
metrics:
enabled: true
provider: "monitoring.coreos.com"
interval: "15s"
scrapeTimeout: "10s"
honorLabels: true
relabelings:
- sourceLabels: [__meta_kubernetes_pod_label_app]
targetLabel: app
6. 常见问题与解决方案
6.1 部署问题
-
Pod 启动失败
- 检查资源配额
- 验证配置正确性
- 查看 Pod 日志
-
服务无法访问
- 检查网络策略
- 验证服务配置
- 确认端口开放
6.2 运维问题
-
性能问题
- 调整资源限制
- 优化配置参数
- 启用自动扩缩容
-
监控问题
- 配置监控指标
- 设置告警规则
- 优化采集间隔
7. 总结
Higress 的 Helm 部署是一个需要综合考虑多个方面的过程,从环境准备到配置管理,从部署验证到运维监控,每个环节都需要认真对待。通过本文介绍的方法和最佳实践,开发者可以更好地进行 Higress 的部署和管理工作。