Sonic云真机平台后端服务安装与使用指南

Sonic云真机平台后端服务安装与使用指南

项目地址:https://gitcode.com/gh_mirrors/so/sonic-server

目录结构及介绍

在克隆或下载了Sonic云真机平台后端服务代码库之后, 您将会看到以下主要目录和文件:

• sonic-server-common: 包含平台基础功能公共模块。
• sonic-server-controller: 负责处理HTTP请求的核心控制层。
• sonic-server-eureka: 提供服务发现与注册的服务模块。
• sonic-server-folder: 未详细说明其具体作用, 可能涉及文件管理或其他资源分类功能。
• sonic-server-gateway: API网关模块用于路由管理和身份验证等。
• env: 包括环境变量模板, 用于自定义部署环境。
• .gitignore: 规定哪些文件不应被纳入版本控制系统中。
• LICENSE: 许可证文件概述了项目使用的许可类型 (AGPL-3.0)。
• README.md, README_CN.md: 分别是英文和中文版的项目说明文件。
• docker-compose.yml, docker-compose-zh.yml: Docker Compose配置文件, 有助于容器化部署应用。
• logo.png: 项目Logo图像。
• pom.xml: Maven构建文件, 描述如何构建整个工程。

启动文件介绍

Maven 构建

要构建并打包项目, 在根目录下运行下面的Maven命令:

mvn clean install

成功完成后, 每个子模块的target目录下都会产生对应的jar包。

应用启动

每个微服务都有自己的启动类, 主要在src/main/java/com/sonic/下的对应模块里找到Application.java。以sonic-server-gateway为例, 其启动入口可能位于:

package com.sonic.gateway;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class GatewayApplication {
    public static void main(String[] args) {
        SpringApplication.run(GatewayApplication.class, args);
    }
}

可以通过执行该主类中的main()方法来启动相应的服务。通常我们会将所有微服务一起放在一个Docker Compose配置文件中进行一键部署和启动。

配置文件介绍

Sonic云真机平台依赖于Spring Boot框架, 因此采用application.yml或application.properties进行各项配置。

您可以在src/main/resources/application.yml中找到配置信息的例子:

spring:
  application:
    name: sonic-server # 你的服务名称
server:
  port: 8080 # 服务端口
management:
  endpoints:
    web:
      exposure:
        include: "*"
eureka:
  client:
    service-url:
      defaultZone: http://${eureka.instance.hostname}:${eureka.client.port}/eureka/
    register-with-eureka: true
    fetch-registry: true
logging:
  level:
    root: INFO

此外, docker-compose.yml也可以提供一些额外的环境变量设置。

总的来说, Sonic Server提供了全面的功能支持与良好的开发者体验, 上述三部分涵盖了基本的目录结构分析、常见启动流程以及初始化配置方式。如果您在使用过程中遇到问题可以查阅官方文档或社区寻求帮助。

sonic-server 🎉Back end of Sonic cloud real machine platform. Sonic云真机平台后端服务。 项目地址: https://gitcode.com/gh_mirrors/so/sonic-server