Moleculer 微服务框架教程：从目录结构到配置详解

1. 项目目录结构及介绍

Moleculer 是一个强大的微服务框架，其仓库 moleculerjs/awesome-moleculer 实际上是个资源列表，而非框架的核心代码库。不过，为了符合您的要求，我们将基于一般Moleculer项目的一般结构进行说明。

标准Moleculer项目目录概览：

- `src` 或 `services`: 包含所有服务的源码文件。
    - 例如，`src/hello.service.js` 是一个简单的问候服务。
- `bootstrap.js`: 应用程序启动逻辑可能存放的地方。
- `config`: 包含不同环境下的配置文件。
    - `config/default.json`, `config/development.json`, `config/production.json` 等。
- `package.json`: Node.js项目的配置文件，定义了依赖项、脚本等。
- `.gitignore`: 版控中忽略的文件或目录列表。
- `README.md`: 项目简介和快速入门指南。
- `LICENSE`: 许可证文件。

2. 项目启动文件介绍

在标准的Moleculer项目中，启动文件通常不是直接命名为 bootstrap.js 而是通过主 package.json 中的 "start" 命令指定。然而，若遵循自定义架构，bootstrap.js 可能作为初始化应用和加载配置的关键文件。它负责创建并启动 Moleculer Runtime，执行服务注册、网络连接等初始化步骤。示例启动逻辑可能包括：

require("moleculer");
const { Broker } = require("moleculer");

// 加载配置
const config = require("./config/environment");

// 创建服务经纪人
const broker = new Broker(config);

// 添加自定义中间件或监听器
broker.createMiddleware(myCustomMiddleware);

// 启动经纪人和服务
broker.start()
    .then(() => console.log(`ServiceBroker is started`))
    .catch(err => console.error("Cannot start broker", err));

3. 项目的配置文件介绍

Moleculer允许通过多个配置文件来管理环境特定的设置，典型的配置结构以.json或.yaml文件存在，如config/default.json。一个基础的配置文件可能包含以下部分：

{
  "nodes": [
    {
      "id": "node1",
      "transporter": "nats://localhost"
    }
  ],
  "services": ["./services/*.js"],
  "logger": {
    "type": "console"
  },
  "repl": true,
  "metrics": {
    "enabled": true
  }
}

• nodes: 定义网络中的节点信息，包括ID和使用的传输协议。
• transporter: 指定服务间通信的中间件，如NATS, Redis等。
• services: 服务的导入路径，决定了哪些服务将被加载。
• logger: 日志配置，控制日志输出的方式和级别。
• repl: 是否开启交互式命令行工具。
• metrics: 性能监控是否启用及相关配置。

请注意，实际的项目目录结构和配置可能会根据开发者的需求有所不同，务必参考项目自身的文档进行具体实践。