socialcomputing/elas-official-backend-1-service-registry

ELAS后端服务注册器镜像文档

镜像概述和主要用途

ELAS（Exploratory Learning Analytics toolkit for Students）是杜伊斯堡-埃森大学Social Computing Group开发的学生学习分析工具平台，旨在通过学生开发的学习分析应用支持学习者的学习活动。本镜像为ELAS平台的后端服务注册器（Service Registry），是微服务架构的核心组件，负责管理和协调平台中的各个微服务，实现服务注册、发现与健康状态监控，确保各学习分析应用之间的通信与协作。

核心功能和特性

• 服务注册：允许ELAS平台的各微服务（如认证服务、学习分析应用服务等）在启动时注册自身信息（服务名称、地址、端口等）
• 服务发现：为其他服务提供查询接口，使其能够发现并访问已注册的服务
• 健康检查：监控已注册服务的运行状态，及时发现并标记异常服务
• 微服务协调：作为ELAS微服务架构的中枢，支持服务间的通信与协作，保障平台整体稳定性

使用场景和适用范围

• ELAS平台开发环境：供开发人员在本地搭建ELAS平台时，启动服务注册器以协调各后端服务
• ELAS平台部署环境：在生产或预览环境中，作为基础组件部署，确保各微服务正常通信
• 学习分析应用集成：支持新开发的学习分析应用服务接入ELAS平台，实现服务的即插即用

详细使用方法和配置说明

Docker部署

Docker Compose部署

ELAS平台推荐使用Docker Compose进行整体部署，服务注册器将作为其中的一个服务自动启动：

bash
docker compose up

该命令会启动包括服务注册器在内的所有ELAS后端服务，无需单独配置服务注册器。

开发环境设置

如需在本地开发环境中单独运行服务注册器，需完成以下步骤：

前置依赖

• OpenJDK 21（Ubuntu安装指南 / Windows安装指南）
• Maven（最新版，Ubuntu安装指南 / Windows安装指南）
• Git（Ubuntu安装指南 / Windows安装指南）

安装步骤

1. 克隆代码仓库

   bash
   git clone https://github.com/ude-soco/elas-official.git
   cd elas-official/backend/1-service-registry
   

2. 打包应用

   在服务注册器目录下，使用Maven打包为jar文件：

   bash
   mvn clean package
   

3. 配置环境变量

   设置服务注册器运行的主机地址（默认使用localhost）：

   cmd
   # Windows
   set HOST=localhost
   

   bash
   # Linux/Mac
   export HOST=localhost
   

4. 启动服务

   运行打包后的jar文件：

   bash
   java -jar target/ServiceRegistry.jar
   

   服务将在默认端口（通常为8761，Eureka默认端口）启动，可通过http://localhost:8761访问服务注册器控制台。

环境变量配置

服务注册器支持以下环境变量配置：

相关服务和实例

ELAS平台提供以下公开实例，服务注册器在其中协调各服务运行：

• 生产环境：elas-official.soco.inko.cloud（基于最新https://github.com/ude-soco/elas-official/releases%EF%BC%89
• 预览环境：edge.elas-official.soco.inko.cloud（基于main分支）