环境配置

在开始 AegisCloud 项目开发之前，需要先准备 本地开发环境和依赖管理环境，确保所有模块和微服务组件能够顺利构建和运行。

1. JDK & IDE

  • 推荐 JDK：17 及以上（AegisCloud 支持最新版本，也可用 JDK 21）
  • IDE：IntelliJ IDEA 或者 Eclipse，推荐 IntelliJ IDEA Ultimate
  • 系统要求：macOS / Windows / Linux 均可

2. Maven

  • Maven 版本：3.8.x 或更高
  • Maven 配置：
    • 确保 ~/.m2/settings.xml 配置了国内仓库镜像（如阿里云 Maven）以提高下载速度：
1
2
3
4
5
6
7
8
<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>*</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

3. Spring Boot / Spring Cloud / Spring Cloud Alibaba 版本对应表

AegisCloud 选择 最新稳定组合，参考官方版本兼容表：

Spring Cloud Alibaba 分支 Spring Cloud 版本 Spring Boot 版本 JDK
2025.1.x 2025.1.x 4.0.x 17+
2025.0.x 2025.0.x 3.5.x 17+
2023.x 2023.x 3.2.x 17+
2022.x 2022.x 3.0.x 17+
2021.x 2021.x 2.6.x 1.8+
2020.0 2020.0 2.4.x 1.8+
2.2.x Hoxton 2.2.x 1.8+
greenwich Greenwich 2.1.x 1.8+
finchley Finchley 2.0.x 1.8+
1.x Edgware 1.x 1.7+

💡 AegisCloud 当前选型：

  • Spring Boot 3.5.5
  • Spring Cloud 2023.2.0（BOM 管理 Spring Cloud 核心依赖）
  • Spring Cloud Alibaba 2025.0.0.0（BOM 管理 Nacos、Sentinel 等中间件）
  • JDK 21（向后兼容 JDK 17+）

4. Maven 仓库配置

为了确保 Spring Cloud Alibaba 和 Spring Cloud 依赖可下载，需要在父工程 POM 添加仓库：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
<properties>  
    <spring-boot.version>3.5.5</spring-boot.version>  
    <spring-cloud.version>2025.0.1</spring-cloud.version>  
    <spring-cloud-alibaba.version>2025.0.0.0</spring-cloud-alibaba.version>  
</properties>

<repositories>
    <!-- Spring 官方 Release 仓库 -->
    <repository>
        <id>spring-releases</id>
        <name>Spring Releases</name>
        <url>https://repo.spring.io/release</url>
    </repository>

    <!-- 阿里云公共仓库 -->
    <repository>
        <id>aliyun-public</id>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </repository>
</repositories>

<dependencyManagement>  
    <dependencies>  
        <!-- Spring Boot BOM -->  
        <dependency>  
            <groupId>org.springframework.boot</groupId>  
            <artifactId>spring-boot-dependencies</artifactId>  
            <version>${spring-boot.version}</version>  
            <type>pom</type>  
            <scope>import</scope>  
        </dependency>  
  
        <!-- Spring Cloud BOM -->  
        <dependency>  
            <groupId>org.springframework.cloud</groupId>  
            <artifactId>spring-cloud-dependencies</artifactId>  
            <version>${spring-cloud.version}</version>  
            <type>pom</type>  
            <scope>import</scope>  
        </dependency>  
  
        <!-- Spring Cloud Alibaba BOM -->  
        <dependency>  
            <groupId>com.alibaba.cloud</groupId>  
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>  
            <version>${spring-cloud-alibaba.version}</version>  
            <type>pom</type>  
            <scope>import</scope>  
        </dependency>  
    </dependencies>  
</dependencyManagement>

5. Docker & 中间件

  • Docker：版本 24.x 或以上
  • Docker Compose：版本 2.x
  • 常用中间件：
    • Nacos（服务注册与配置中心）
    • Sentinel（限流 / 熔断 / 自愈基础）
    • Kafka / RocketMQ（事件通信，可选）

💡 建议把 Nacos、Sentinel 放在 docker-compose.yml 中统一管理，方便本地启动测试。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
services:
  nacos:
    image: nacos/nacos-server:v3.1.0
    container_name: aegis-nacos
    platform: linux/amd64
    environment:
      - MODE=standalone
      - PREFER_HOST_MODE=hostname
      - NACOS_AUTH_ENABLE=true              # 开启认证
      - NACOS_AUTH_IDENTITY_KEY=${NACOS_USER}
      - NACOS_AUTH_IDENTITY_VALUE=${NACOS_PASSWORD}
      - NACOS_AUTH_TOKEN=${NACOS_AUTH_TOKEN}
    ports:
      - "8080:8080"   # 控制台端口
      - "8848:8848"   # 服务注册/客户端端口
      - "9848:9848"   # gRPC/cluster 端口（可选）
    volumes:
      - ./nacos-docker/data:/home/nacos/data
      - ./nacos-docker/logs:/home/nacos/logs

这里只配置了nacos，
后续我们会一步步完善这个compose文件的