maestroserver/server-maestro

Maestro Server

镜像概述

Maestro Server 是一个开源的软件平台，专为混合 IT 环境中的服务器、应用程序和系统的管理与发现而设计。本镜像（Server App）是 Maestro Server 的核心主应用程序，主要负责处理用户认证与授权、实体验证与创建（CRUD 操作），以及作为代理将请求路由至其他微服务。它能够管理从小型到大型规模的 IT 环境，并可视化最新的多云环境状态。

核心功能与特性

• 认证与授权：提供安全的用户身份验证和权限控制机制。
• 实体管理：支持各类核心实体的验证与 CRUD（创建、读取、更新、删除）操作。
• 微服务代理：作为 API 代理，将请求分发至后端的各个微服务。
• 领域驱动设计 (DDD)：代码结构基于 DDD 组织，包含基础设施层、仓储层、实体（值对象）、接口、应用层和领域层。
• 模块化 API：基于 KrakenJS 构建，核心 API 按模块划分，包括核心组件、配置文件、团队、项目、架构、应用、云清单、系统、客户端、服务器、报告、事件、分析、图表、任务和清单等。

使用场景与适用范围

• 混合 IT 环境管理：统一管理本地数据中心与多云环境中的基础设施。
• 多云状态可视化：实时展示和监控跨多个云提供商的资源状态。
• 企业级资产盘点：适用于需要全面掌握服务器、应用和系统资产的中大型企业。

技术栈与关联服务

技术栈

• Node.js 8.11.2
• MongoDB 3.4
• AWS S3（用于文件上传存储）

关联微服务

本服务需要与以下 Maestro 微服务协同工作：

• Maestro Discovery (服务发现)
• Maestro Reports (报告服务)
• Maestro Analytics (分析服务)
• Maestro Analytics Front (分析前端)
• Maestro Audit (审计服务)

部署与使用方法

使用 Docker Run 部署

bash
docker run -d -p 8888:8888 \
  -e "MAESTRO_MONGO_URI=mongodb" \
  -e "MAESTRO_MONGO_DATABASE=maestro-client" \
  -e "MAESTRO_DISCOVERY_URI=http://discovery:5000" \
  -e "MAESTRO_ANALYTICS_URI=http://analytics:5020" \
  -e "MAESTRO_REPORT_URI=http://reports:5005" \
  -e "MAESTRO_AUDIT_URI=http://audit:10900" \
  docker.xuanyuan.run/maestroserver/server-maestro

使用 Docker Compose 部署

创建 docker-compose.yml 文件：

yaml
version: '2'

services:
  server:
    image: docker.xuanyuan.run/maestroserver/server-maestro
    ports:
      - "8888:8888"
    environment:
      - "MAESTRO_MONGO_URI=mongodb"
      - "MAESTRO_MONGO_DATABASE=maestro-client"
      - "MAESTRO_DISCOVERY_URI=http://discovery:5000"
      - "MAESTRO_REPORT_URI=http://reports:5005"
      - "MAESTRO_ANALYTICS_URI=http://analytics:5020"
      - "MAESTRO_AUDIT_URI=http://audit:10900"

启动服务：

bash
docker-compose up -d

开发环境配置

1. 启动 MongoDB 和模拟 SMTP 服务：

bash
cd devtools/
docker-compose up -d

2. 在 .env 文件中配置数据库和端口：

env
MAESTRO_PORT=8888
MAESTRO_MONGO_URI='localhost'
MAESTRO_MONGO_DATABASE='maestro-client'
MAESTRO_DISCOVERY_URI=http://localhost:5000
MAESTRO_REPORT_URI=http://localhost:5005
MAESTRO_ANALYTICS_URI=http://localhost:5020
MAESTRO_AUDIT_URI=http://localhost:10900

3. 安装依赖并运行（需要 Node.js 7.6+ 且 MongoDB 正在运行）：

bash
npm install
npm run migrate  # 初始化 MongoDB 数据
npm run server

4. 运行测试：

bash
mocha test/**/*js --reporter spec
gulp test_e2e
gulp test_unit
gulp eslint

环境变量配置说明

参与贡献

如果您有兴趣参与 Maestro Server 的开发、创建新功能或扩展现有功能，请参阅官方提供的开发者指南，了解如何设置开发环境、编码规范、标准以及系统架构。