Oxygen-Dapr EshopSample 项目常见问题解决方案

Oxygen-Dapr EshopSample 项目常见问题解决方案

项目基础介绍

Oxygen-Dapr EshopSample 是一个由 C# 编写的分布式电商系统 Demo，旨在帮助 .NET 开发者快速学习和上手 Dapr（分布式应用程序运行时）。该项目运行在 Kubernetes 上，使用 Dapr 作为服务网格组件，支持多种云原生技术，如 Docker、Helm 和 Kubernetes。

新手使用注意事项及解决方案

1. 环境依赖问题

问题描述：新手在运行项目时，可能会遇到环境依赖不满足的问题，导致项目无法正常启动。

解决方案：

1. 检查 Docker 和 Kubernetes 版本：确保 Docker 和 Kubernetes 版本符合项目要求（Docker for Windows/Linux，Kubernetes 1.19+）。
2. 安装 Helm 3：确保 Helm 3 已正确安装。
3. 安装 Dapr：确保 Dapr 版本为 1.0 或更高版本。

2. Ingress Controller 配置问题

问题描述：项目默认使用 Ingress-Nginx 作为 Ingress Controller，但新手可能会遇到 Ingress Controller 未正确配置的问题。

解决方案：

1. 安装 Ingress-Nginx：按照项目文档中的指引，安装 Ingress-Nginx。
2. 修改 Service 配置：使用以下命令修改 Ingress-Nginx 的 Service 配置，暴露 NodePort：

   kubectl edit svc ingress-nginx-controller
   

   修改 type 为 NodePort，并设置 nodePort 为 30882。

3. Host 文件配置问题

问题描述：新手在本地运行项目时，可能会遇到域名解析问题，导致无法访问项目页面。

解决方案：

1. 编辑 Host 文件：在本地 Host 文件中添加以下内容：

   127.0.0.1 admin.dapreshop.com
   127.0.0.1 m.dapreshop.com
   127.0.0.1 api.dapreshop.com
   127.0.0.1 image.dapreshop.com
   127.0.0.1 zipkin.dapreshop.com
   127.0.0.1 swagger.dapreshop.com
   

2. 保存并刷新 DNS 缓存：保存 Host 文件后，刷新 DNS 缓存以确保配置生效。

通过以上步骤，新手可以顺利解决常见问题，顺利运行 Oxygen-Dapr EshopSample 项目。