eShopOnDapr开源项目安装和使用指南

1. 项目的目录结构及介绍

在深入探讨eShopOnDapr的具体使用之前，我们首先了解该项目的主要目录结构及其意义。

主要目录结构：

• src/: 包含所有源代码，分为不同子项目。
  • Services/: 存放各个微服务的源码，如订单处理服务(Ordering), 身份认证服务(Identity)，等等。
  • WebApp 和 WebMVC: 分别对应Blazor WASM前端和传统的MVC前端。
• apiservices/: API网关和服务注册的相关代码。
• infrastructure/: 包括数据库脚本、日志配置等基础设施相关文件。
• test/: 测试代码的位置。
• docs/: 文档资料，包括设计决策、API文档等。
• .dapr: Dapr配置文件所在的目录，包含了Dapr component和sidecar的配置。
• Dockerfile: Docker镜像构建文件，用于创建容器。
• Kubernetes/: Kubernetes配置文件，用于在Kubernetes环境中部署该应用。

2. 项目的启动文件介绍

启动eShopOnDapr涉及到多个步骤，其中关键的是启动Dapr并随后运行各项服务。

启动流程概览：

本地开发环境:

1. Dapr初始化: dapr init
2. Dapr组件加载: dapr run --app-id <service-id> --app-port <port> --components-path .dapr/components
3. 启动各个服务: 使用dotnet run或dotnet ef database update按需更新数据库后启动服务。

生产环境部署(Kubernetes):

1. 准备Kubernetes集群: 确保Kubernetes集群可用。
2. 部署Dapr侧车注入: 修改cluster-autoscaler或类似控制器。
3. 应用YAML部署: 使用kubectl apply -f Kubernetes/deployment.yaml进行部署。

具体到各个微服务或组件，它们一般都会有一个入口点，通常是在Program.cs或Startup.cs文件中定义的Main函数。

3. 项目的配置文件介绍

配置对于任何分布式系统而言都至关重要，eShopOnDapr也不例外。以下是配置文件的关键部分：

主要配置类型：

• appsettings.json: 存储服务级别的配置，包括数据库连接字符串、外部服务URL、安全凭据等。

  {
    "ConnectionStrings": {
      "CatalogDb": "<catalog-db-connection-string>"
    },
    "BaseUrl": "<base-url>",
    "AllowedHosts": "*",
    "Serilog": {
      // 日志记录配置...
    }
  }
  

• dapr.json: Dapr组件的配置文件，指定要启用的构建块，比如state management、binding、secret store等。

  {
    "components": [
      {
        "type": "state.kv.memory",
        "metadata": [
          { "name": "stateStoreName", "value": "eshop-statestore" }
        ],
        "name": "statestore"
      },
      // 更多Dapr组件配置...
    ]
  }
  

这些配置不仅决定了应用的行为，还影响着Dapr如何控制服务间交互的方式以及它们如何适应生产环境。

以上就是关于eShopOnDapr项目的基本目录结构、启动流程以及关键配置文件的概述。希望这能帮助您更好地理解这一复杂的分布式应用系统，为进一步的开发和维护打下坚实的基础。