🚀 Tier0 完整架构文档

Tier0 EKS 集群完整架构文档

版本: v2.1 | 更新时间: 2026-01-18

一、系统架构总览

1.1 整体架构图

1.2 租户服务架构

二、请求流转链路

2.1 用户访问前端

2.2 API 请求链路

2.3 租户服务请求链路

2.4 IoT 设备数据链路

三、基础设施详情

3.1 网络架构

3.2 EKS 集群配置

3.3 EC2 PostgreSQL HA 集群

四、服务详情

4.1 业务服务矩阵

4.2 中间件服务

4.3 租户服务

五、监控系统

5.1 监控架构

5.2 Grafana 面板列表

5.3 告警规则分类

六、域名与入口

七、运维手册

7.1 常用命令

# 查看所有服务状态
kubectl get pods -A | grep -v Running

# 查看业务服务日志
kubectl logs -n default -l app=gwsvr --tail=100 -f

# 查看租户服务
kubectl get pods -n tenant-tenant-***

# 扩缩容
kubectl scale deployment -n default gwsvr --replicas=2

# 启动压测
kubectl scale deployment -n locust locust-master --replicas=1
kubectl scale deployment -n locust locust-worker --replicas=3

# 查看监控 targets
kubectl port-forward -n monitoring svc/prometheus-operated 9090:9090

7.2 故障排查

# Pod 异常
kubectl describe pod  -n 
kubectl logs  -n  --previous

# 网络问题
kubectl exec -it  -- curl -v http://service:port

# 数据库连接
kubectl exec -it  -- psql -h postgres-leader -U *** -d ***

# 查看事件
kubectl get events -n  --sort-by='.lastTimestamp'

八、目录结构

/data/cdk-kiro/
├── tier0/                          # 一键部署
│   ├── config/
│   │   └── env.template            # 环境变量模板
│   ├── infrastructure/
│   │   └── terraform/              # Terraform 模块
│   │       ├── main.tf
│   │       ├── variables.tf
│   │       └── modules/
│   │           ├── vpc/
│   │           ├── eks/
│   │           ├── efs/
│   │           ├── s3/
│   │           └── iam/
│   ├── business/
│   │   ├── services/               # 业务服务 YAML
│   │   ├── tenants/                # 租户配置
│   │   ├── configmaps/             # ConfigMap
│   │   └── ingress/                # Ingress 配置
│   ├── monitoring/
│   │   ├── postgres-complete-monitoring.yaml
│   │   └── production-monitoring-rules.yaml
│   └── scripts/
│       ├── deploy.sh               # 主部署脚本
│       ├── deploy-infrastructure.sh
│       ├── deploy-business.sh
│       └── common.sh
├── monitoring/                     # 监控配置
├── locust/                         # 压测工具
│   ├── k8s/
│   │   └── locust-deployment.yaml
│   └── scripts/
│       └── database_load_test.py
├── docs/                           # 文档
│   ├── v2-current/
│   │   └── tier0-complete-architecture.md
│   └── v1-archive/
└── backups/

九、连接信息与凭证

9.1 数据库连接

PostgreSQL (EC2 HA)

# K8s 内部连接
psql -h postgres-leader -U *** -d ***

# 外部连接 (通过 NLB)
psql -h postgres-nlb-***.elb.ap-southeast-1.amazonaws.com -U *** -d ***

Redis

# 连接测试
kubectl exec -it deployment/redis -n default -- redis-cli ping

ETCD

# 连接测试
kubectl exec -it etcd-0 -n default -- etcdctl endpoint health

9.2 消息队列

EMQX (MQTT Broker)

# MQTT 连接测试
mosquitto_pub -h k8s-mid-emqxserv-*.elb.ap-southeast-1.amazonaws.com -p 1883 -t test -m "hello"

9.3 监控系统

Grafana

Prometheus

Alertmanager

9.4 AWS 云组件

S3 存储桶

# 访问示例
aws s3 ls s3://tier0-upload-pre/ --region ap-southeast-1

EFS 文件系统

# 挂载点
mount -t efs fs-05278dec70d98abd2:/ /mnt/efs

NLB 负载均衡器

EC2 实例

# SSH 连接 (通过 SSM)
aws ssm start-session --target i-*** --region ap-southeast-1

9.5 业务服务端口

9.6 租户服务端口

9.7 监控 Exporter 端口

十、环境变量配置

10.1 业务服务环境变量

# 数据库配置
dbType: pgsql
dbDSN: postgres://***:***@postgres-leader:5432/***?sslmode=disable
dbIsInitTable: true

# Redis 配置
REDIS_ADDR: redis.default.svc.cluster.local:6379

# ETCD 配置
ETCD_ENDPOINTS: http://etcd.default.svc.cluster.local:2379

# EMQX 配置
MQTT_BROKER: tcp://emqx.mid.svc.cluster.local:1883

# S3 配置
AWS_REGION: ap-southeast-1
S3_BUCKET: tier0-upload-pre
S3_PUBLIC_BUCKET: tier0-upload-public-pre

10.2 环境变量模板位置

/data/cdk-kiro/tier0/config/env.template