ljwx-stock/K8S_DEPLOYMENT_SUMMARY.md

Kubernetes 部署总结

部署日期: 2024-12-24 命名空间: ljwx-stock 状态: ✅ 部署成功（Backend正在初始化）

---

📊 部署概览

成功部署的资源

资源类型	名称	状态	说明
Namespace	ljwx-stock	✅ Active	已创建命名空间
StatefulSet	postgres	✅ Running (1/1)	PostgreSQL 16
StatefulSet	redis	✅ Running (1/1)	Redis 7
Deployment	claude-stock-backend	⏳ Initializing (1/2)	Backend + Frontend Pod
Service	claude-stock-backend	✅ LoadBalancer	External IP: 192.168.139.200
Service	claude-stock-frontend	✅ LoadBalancer	External IP: 192.168.139.201
PVC	postgres-pvc	✅ Bound	10Gi 持久存储
PVC	redis-pvc	✅ Bound	5Gi 持久存储
ConfigMap	claude-stock-config	✅ Created	应用配置
Secret	postgres-secret	✅ Created	数据库密码
Secret	redis-secret	✅ Created	Redis密码

---

🌐 访问地址

External Services (LoadBalancer)

# Backend API
http://192.168.139.200:80

# Frontend Dashboard
http://192.168.139.201:8090

测试访问

# 测试 Backend Health Endpoint
curl http://192.168.139.200/health

# 测试 Frontend
curl http://192.168.139.201:8090

---

📁 数据持久化

PostgreSQL 数据卷

• PVC名称: postgres-pvc
• 容量: 10Gi
• 挂载路径: /var/lib/postgresql/data
• StorageClass: (默认)

Redis 数据卷

• PVC名称: redis-pvc
• 容量: 5Gi
• 挂载路径: /data
• StorageClass: (默认)

---

🔧 当前状态详情

Pod 状态

NAME                                    READY   STATUS    RESTARTS   AGE
claude-stock-backend-549f8c6ff4-7w9p9   1/2     Running   6          14m
postgres-0                              1/1     Running   1          3h43m
redis-0                                 1/1     Running   1          3h43m

说明:

• ✅ Frontend容器: 已就绪并运行 (Vite dev server on port 5173)
• ⏳ Backend容器: 正在初始化，首次启动需安装Python依赖包
  • 已重启6次（因liveness probe超时）
  • 预计需要5-10分钟完成依赖安装

Services 端口映射

Service	Type	Cluster IP	External IP	Port Mapping
claude-stock-backend	LoadBalancer	192.168.194.251	192.168.139.200	80:31272/TCP
claude-stock-frontend	LoadBalancer	192.168.194.148	192.168.139.201	8090:31535/TCP
postgres	ClusterIP (Headless)	None	-	5432/TCP
redis	ClusterIP (Headless)	-	-	6379/TCP

---

📝 配置详情

环境变量 (Backend)

DATABASE_URL: postgresql://stockai:[email protected]:5432/stockai
REDIS_URL: redis://:[email protected]:6379/0
ENVIRONMENT: production

Volume Mounts (使用 HostPath)

Backend Code: /Users/brunogao/work/codes/ljwx/ljwx-stock/backend
Frontend Code: /Users/brunogao/work/codes/ljwx/ljwx-stock/frontend

优势: 代码修改实时生效，无需重新构建镜像 限制: 仅适用于单节点K8s集群（如Docker Desktop Kubernetes）

---

⚙️ 资源配额

Backend Container

Requests:
  CPU: 250m
  Memory: 512Mi
Limits:
  CPU: 1000m (1 core)
  Memory: 1Gi

Frontend Container

Requests:
  CPU: 100m
  Memory: 256Mi
Limits:
  CPU: 500m
  Memory: 512Mi

HPA (Horizontal Pod Autoscaler)

Min Replicas: 1
Max Replicas: 3
Target CPU: 70%
Target Memory: 80%

---

🔍 监控和日志

查看 Pod 状态

kubectl get pods -n ljwx-stock
kubectl describe pod <pod-name> -n ljwx-stock

查看日志

# Backend logs
kubectl logs -f -n ljwx-stock -l app=claude-stock-backend -c backend

# Frontend logs
kubectl logs -f -n ljwx-stock -l app=claude-stock-backend -c frontend

# PostgreSQL logs
kubectl logs -f -n ljwx-stock postgres-0

# Redis logs
kubectl logs -f -n ljwx-stock redis-0

实时监控

# Watch pod status
kubectl get pods -n ljwx-stock -w

# Watch all resources
kubectl get all -n ljwx-stock -w

---

🐛 已知问题和解决方案

问题1: Backend容器反复重启

现象: Pod RESTARTS次数持续增加

原因:

• 首次启动安装依赖包耗时较长（5-10分钟）
• Liveness probe initialDelaySeconds=60秒不足
• 容器在依赖安装完成前被探针杀死

临时解决方案:

# 方案1: 延长探针初始延迟
kubectl patch deployment claude-stock-backend -n ljwx-stock -p '{"spec":{"template":{"spec":{"containers":[{"name":"backend","livenessProbe":{"initialDelaySeconds":300}}]}}}}'

# 方案2: 临时禁用探针（不推荐生产环境）
kubectl patch deployment claude-stock-backend -n ljwx-stock -p '{"spec":{"template":{"spec":{"containers":[{"name":"backend","livenessProbe":null}]}}}}'

永久解决方案: 构建包含所有依赖的Docker镜像

问题2: HostPath在多节点集群不可用

现象: 如果K8s集群有多个worker节点，Pod调度到其他节点时无法访问代码

解决方案:

1. 使用 PVC + NFS/Ceph 共享存储
2. 构建完整Docker镜像并push到registry
3. 添加节点亲和性确保Pod调度到特定节点

---

🚀 后续优化建议

短期优化

1. 构建Docker镜像 - 避免每次启动都安装依赖

   # Backend
   docker build -t ljwx-stock/backend:v1.0 backend/
   docker push ljwx-stock/backend:v1.0
   
   # Frontend
   docker build -t ljwx-stock/frontend:v1.0 frontend/
   docker push ljwx-stock/frontend:v1.0
   

2. 调整探针参数

   livenessProbe:
     initialDelaySeconds: 300  # 增加到5分钟
     periodSeconds: 30
   readinessProbe:
     initialDelaySeconds: 120  # 增加到2分钟
     periodSeconds: 10
   

3. 添加Init Container - 预先检查数据库连接

   initContainers:
   - name: wait-for-postgres
     image: busybox:1.35
     command: ['sh', '-c', 'until nc -z postgres.ljwx-stock.svc 5432; do sleep 2; done']
   

中期优化

1. Ingress配置 - 统一入口，SSL termination
2. Prometheus监控 - 集成Prometheus抓取metrics
3. 日志聚合 - ELK/Loki stack
4. Secrets管理 - 使用External Secrets Operator

长期优化

1. GitOps - 使用ArgoCD/FluxCD自动部署
2. 多环境 - dev/staging/prod命名空间隔离
3. 蓝绿部署 - 零停机更新
4. 备份恢复 - Velero备份整个namespace

---

📋 验收检查清单

• Namespace创建成功
• PostgreSQL StatefulSet运行正常
• Redis StatefulSet运行正常
• Backend Deployment创建成功
• Backend容器完全启动（等待依赖安装完成）
• Frontend容器运行正常
• LoadBalancer分配External IP
• Health endpoint响应正常
• 数据库连接测试通过
• Redis连接测试通过

---

🔗 相关文档

• K8s配置文件: /k8s/temp/
• 原始配置: /k8s/
• README: /README.md (包含数据抓取和维护指南)
• 数据管理: 参考README中的"数据增量更新与维护"章节

---

📞 故障排查命令

# 检查所有资源
kubectl get all -n ljwx-stock

# 检查配置
kubectl get configmap,secret -n ljwx-stock

# 检查PVC
kubectl get pvc -n ljwx-stock

# 检查Events
kubectl get events -n ljwx-stock --sort-by='.lastTimestamp'

# 进入Pod调试
kubectl exec -it <pod-name> -n ljwx-stock -c backend -- /bin/bash

# 端口转发（本地调试）
kubectl port-forward -n ljwx-stock service/claude-stock-backend 8000:80
kubectl port-forward -n ljwx-stock service/claude-stock-frontend 8090:8090

---

部署完成时间: 2024-12-24 15:00:00 K8s集群: Docker Desktop Kubernetes (localhost:26443) 命名空间: ljwx-stock