一个强大的命令行工具，用于在 AWS EKS 上自动化部署 Higress 云原生网关。
- 🚀 一键部署 - 单个命令完成 EKS 集群创建和 Higress 部署
- 🔧 灵活配置 - 通过 YAML 文件管理所有配置参数
- 🏗️ 高可用架构 - 跨 3 个可用区部署，自动扩缩容
- 🔒 安全加固 - 集成 AWS 最佳实践和安全配置
- 🌐 ALB 集成 - 自动创建和配置 Application Load Balancer
- 🧹 灵活清理 - 支持选择性删除资源（仅 Higress 或整个集群）
- Python 3.8+
- AWS CLI v2.x
- kubectl v1.28+
- eksctl v0.170.0+
- Helm v3.10+
- 1 个 VPC
- 3 个公有子网（跨 3 个可用区）
- 3 个私有子网（跨 3 个可用区）
- NAT Gateway 已配置
#尝试使用setup.sh
bash setup.sh如果报错，分步骤
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install
aws configure
# 输入 Access Key ID、Secret Access Key、Region 等信息
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
kubectl version --client
curl --silent --location "https://github.com/weaveworks/eksctl/releases/latest/download/eksctl_$(uname -s)_amd64.tar.gz" | tar xz -C /tmp
sudo mv /tmp/eksctl /usr/local/bin
eksctl version
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
helm version
# 运行安装脚本
./setup.sh
# 或手动安装
pip3 install -r requirements.txt
chmod +x higress_deploy.py# 创建配置文件
./higress_deploy.py init
# 编辑配置文件，填入您的 AWS 资源信息
vim config.yaml或手动执行各步骤（详见 部署顺序指南）：
./higress_deploy.py create # 创建 EKS 集群
./higress_deploy.py install-alb # 安装 ALB Controller
./higress_deploy.py deploy # 部署 Higress
./higress_deploy.py create-lb # 创建 ALB
./higress_deploy.py status # 查看状态
# 获取访问地址
cat alb-endpoint.txt./higress_deploy.py init # 初始化配置文件
./higress_deploy.py validate # 验证配置文件完整性
./higress_deploy.py create # 创建 EKS 集群（自动安装 EBS CSI Driver）
./higress_deploy.py install-ebs-csi # 安装 EBS CSI Driver（可选，create 已包含）
./higress_deploy.py install-alb # 安装 ALB Controller
./higress_deploy.py deploy # 部署 Higress
./higress_deploy.py create-lb # 创建 ALB
./higress_deploy.py install-all # 一键安装所有组件
./higress_deploy.py status # 查看部署状态./higress_deploy.py fix-alb-security-group # 修复 ALB Security Group 问题
./higress_deploy.py fix-alb-permissions # 修复 ALB IAM 权限问题# 仅删除 Higress（保留 EKS 集群）
./higress_deploy.py clean higress
# 删除整个 EKS 集群
./higress_deploy.py clean eks
# 强制删除（不需要确认）
./higress_deploy.py clean higress --force
./higress_deploy.py clean eks --forcemake install-all # 一键部署
make status # 查看状态
make clean-higress # 仅删除 Higress
make clean-eks # 删除整个集群
make troubleshoot # 运行故障排查
make fix-webhook # 修复 webhook 问题| 文档 | 说明 |
|---|---|
| 部署顺序指南 | ⭐ 正确的部署步骤和顺序 |
| 快速开始 | 5 分钟快速入门指南 |
| 完整指南 | 详细使用文档 |
| StorageClass 配置 | ⭐ 新增 - 持久化存储配置 |
| 验证指南 | 集群验证和功能测试 |
| 清理指南 | 资源清理详细说明 |
| 故障排查 | 常见问题和解决方案 |
| 配置说明 | 配置文件详细说明 |
| 架构设计 | 架构和设计文档 |
| 更新日志 | 版本更新历史 |
./setup.sh # 安装工具
./higress_deploy.py init # 初始化配置
vim config.yaml # 编辑配置
./higress_deploy.py install-all # 一键部署./higress_deploy.py clean higress # 删除 Higress
./higress_deploy.py deploy # 重新部署
./higress_deploy.py create-lb # 创建 ALB./higress_deploy.py clean eks # 删除整个集群# 运行自动故障排查脚本
./troubleshoot.sh
# 修复 webhook 问题
make fix-webhook
# 验证配置
./higress_deploy.py validate问题 1: ALB 创建失败 - Security Group 无效
# 症状：InvalidConfigurationRequest: One or more security groups are invalid
# 解决方案：
./higress_deploy.py fix-alb-security-group
# 或手动修复
bash fix-alb-security-group.sh问题 2: IAM 权限不足（创建 ALB 失败）
# 症状：elasticloadbalancing:DescribeListenerAttributes 权限错误
# 解决方案：
./higress_deploy.py fix-alb-permissions
# 或
make fix-alb-permissions
# 然后重新创建 ALB
kubectl delete ingress higress-alb -n higress-system
./higress_deploy.py create-lb问题 3: Webhook 服务未就绪
# 解决方案
kubectl rollout restart deployment aws-load-balancer-controller -n kube-system
sleep 30
./higress_deploy.py deploy问题 4: ALB 未创建
# 检查子网标签
aws ec2 describe-subnets --subnet-ids <subnet-id> --query 'Subnets[*].Tags'
# 检查 Ingress 状态
kubectl describe ingress higress-alb -n higress-system
# 查看 ALB Controller 日志
kubectl logs -n kube-system deployment/aws-load-balancer-controller | tail -50更多问题请参考 故障排查文档。