ljwx-health/K8S-QUICK-START.md

Kubernetes 一键部署 - 快速开始

快速将灵境万象系统部署到 Kubernetes 集群。

🚀 5 分钟快速部署

前提条件

1. Kubernetes 集群 已经运行

   kubectl cluster-info
   

2. 本地 Registry 已经启动

   curl http://localhost:15000/v2/_catalog
   

一键部署

# 进入项目目录
cd /Users/brunogao/work/codes/shenye/release

# 执行一键部署
./k8s-deploy.sh

完成！系统将自动：

• ✅ 构建所有 Docker 镜像
• ✅ 推送到本地 Registry
• ✅ 生成 K8s 配置文件
• ✅ 部署到 Kubernetes
• ✅ 等待服务就绪

📋 部署脚本

脚本	功能	用法
k8s-deploy.sh	一键部署	./k8s-deploy.sh
k8s-status.sh	状态检查	./k8s-status.sh
k8s-undeploy.sh	卸载系统	./k8s-undeploy.sh

🔍 访问应用

方式 1: 配置本地域名

# 1. 获取节点 IP
kubectl get nodes -o wide

# 2. 编辑 /etc/hosts
sudo nano /etc/hosts

# 3. 添加域名映射
192.168.65.4  ljwx.local

# 4. 访问应用
open http://ljwx.local

方式 2: 端口转发

# 转发前端管理
kubectl port-forward svc/ljwx-admin 8080:80 -n ljwx-system

# 访问
open http://localhost:8080

📊 查看状态

# 完整状态检查
./k8s-status.sh

# 查看 Pods
kubectl get pods -n ljwx-system

# 查看日志
kubectl logs -f deployment/ljwx-boot -n ljwx-system

🛠️ 常用命令

扩容

# 扩展到 3 个副本
kubectl scale deployment ljwx-boot --replicas=3 -n ljwx-system

重启

# 重启服务
kubectl rollout restart deployment/ljwx-boot -n ljwx-system

更新

# 1. 重新构建镜像
./build-and-push.sh all

# 2. 重新部署
./k8s-deploy.sh --skip-build

卸载

# 完全删除（包括数据）
DELETE_PVC=true ./k8s-undeploy.sh

# 保留数据
./k8s-undeploy.sh

🎯 高级选项

使用已有镜像

# 跳过镜像构建
./k8s-deploy.sh --skip-build

使用外部数据库

# 跳过 MySQL 和 Redis 部署
./k8s-deploy.sh --skip-mysql --skip-redis

自定义配置

# 自定义命名空间和域名
K8S_NAMESPACE=ljwx-prod \
LJWX_DOMAIN=ljwx.example.com \
./k8s-deploy.sh

查看帮助

./k8s-deploy.sh --help

🐛 故障排查

Pod 无法启动

# 查看 Pod 状态
kubectl get pods -n ljwx-system

# 查看详细信息
kubectl describe pod <pod-name> -n ljwx-system

# 查看日志
kubectl logs <pod-name> -n ljwx-system

镜像拉取失败

# 检查本地 Registry
curl http://localhost:15000/v2/_catalog

# 重新构建镜像
./build-and-push.sh all

服务无法访问

# 检查 Ingress
kubectl get ingress -n ljwx-system

# 检查 Service
kubectl get svc -n ljwx-system

# 使用端口转发测试
kubectl port-forward svc/ljwx-admin 8080:80 -n ljwx-system

📚 完整文档

详细文档请参考: K8S-DEPLOYMENT-GUIDE.md

内容包括：

• 🏗️ 系统架构详解
• ⚙️ 详细配置说明
• 🔧 运维管理指南
• 🐞 完整故障排查
• ✨ 最佳实践建议
• 🚀 生产环境部署

💡 提示

1. 首次部署较慢（需要构建镜像），后续部署会很快
2. 确保 Registry 运行，否则无法推送镜像
3. 检查集群资源，确保有足够的 CPU 和内存
4. 使用 ./k8s-status.sh 随时查看系统状态

🎉 成功指标

部署成功后，您应该看到：

✅ 所有 Pods 运行正常
✅ 所有 Services 可访问
✅ Ingress 配置正确
✅ 应用可以通过域名访问

---

快速支持:

• 状态检查: ./k8s-status.sh
• 查看日志: kubectl logs -f <pod> -n ljwx-system
• 完整文档: K8S-DEPLOYMENT-GUIDE.md