【SpringCloud】微服务框架后端部署详细过程记录20240119

前言：前两天公司接到客户提供的一个微服务框架，导师让我在本地部署验证一下该框架的可用性，借此机会记录一下微服务项目的一个基本部署流程，仅供学习参考，如有不足还请指正！

文件结构

提供的压缩文件共包含源码、Maven配置信息以及一份框架说明

部署过程

1、修改Maven信息

• 打开源码后先将Maven修改为框架提供的Maven配置文件（修改后需刷新Maven）

• 附（Maven配置源码，供参考；该项目主要采用阿里云组件库）：

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <mirrors>
        <mirror>
            <id>mirror</id>
            <mirrorOf>central,jcenter,!rdc-releases,!rdc-snapshots</mirrorOf>
            <name>mirror</name>
            <url>https://maven.aliyun.com/nexus/content/groups/public</url>
        </mirror>

    </mirrors>
    <servers>
        <server>
            <id>rdc-releases</id>
            <username>64423e0f253e98e0c616d548</username>
            <password>cFMOPZMySW7I</password>
        </server>
        <server>
            <id>rdc-snapshots</id>
            <username>64423e0f253e98e0c616d548</username>
            <password>cFMOPZMySW7I</password>
        </server>
    </servers>
    <profiles>
        <profile>
            <id>rdc</id>
            <properties>
                <altReleaseDeploymentRepository>
                    rdc-releases::default::https://packages.aliyun.com/maven/repository/2260349-release-dYnJeL/
                </altReleaseDeploymentRepository>
                <altSnapshotDeploymentRepository>
                    rdc-snapshots::default::https://packages.aliyun.com/maven/repository/2260349-snapshot-x4T8Ra/
                </altSnapshotDeploymentRepository>
            </properties>
            <repositories>
                <repository>
                    <id>central</id>
                    <url>https://maven.aliyun.com/nexus/content/groups/public</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                </repository>
                <repository>
                    <id>snapshots</id>
                    <url>https://maven.aliyun.com/nexus/content/groups/public</url>
                    <releases>
                        <enabled>false</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
                <repository>
                    <id>rdc-releases</id>
                    <url>https://packages.aliyun.com/maven/repository/2260349-release-dYnJeL/</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                </repository>
                <repository>
                    <id>rdc-snapshots</id>
                    <url>https://packages.aliyun.com/maven/repository/2260349-snapshot-x4T8Ra/</url>
                    <releases>
                        <enabled>false</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
            </repositories>
            <pluginRepositories>
                <pluginRepository>
                    <id>central</id>
                    <url>https://maven.aliyun.com/nexus/content/groups/public</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                </pluginRepository>
                <pluginRepository>
                    <id>snapshots</id>
                    <url>https://maven.aliyun.com/nexus/content/groups/public</url>
                    <releases>
                        <enabled>false</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </pluginRepository>
                <pluginRepository>
                    <id>rdc-releases</id>
                    <url>https://packages.aliyun.com/maven/repository/2260349-release-dYnJeL/</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                </pluginRepository>
                <pluginRepository>
                    <id>rdc-snapshots</id>
                    <url>https://packages.aliyun.com/maven/repository/2260349-snapshot-x4T8Ra/</url>
                    <releases>
                        <enabled>false</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </pluginRepository>
            </pluginRepositories>
        </profile>
    </profiles>
    <activeProfiles>
        <activeProfile>rdc</activeProfile>
    </activeProfiles>
</settings>

2、框架结构

• 该框架主要包括gateway（网关）、uaa（认证系统）、platform（基础平台）、plugin（功能组件）四大部分，可根据需要部署使用。

3、初始化数据库

• 将源码中doc/sq文件夹下的SQL导入本地数据库：

• navicat中新建数据库（marscloud），字符集参考sql文件中字符集（utf8mb4）：

• 导入结果：

4、初始化nacos

nacos 配置文件在：doc/nacos 目录下，在 nacos 控制台导入目录下的 yaml 文件

• 首先启动本地nacos

• 在nacos新建命名空间（marscloud）

  

• 导入yaml文件（可以现将所有yaml文件压缩为zip然后再导入）

• 导入结果

  

5、修改nacos中的连接信息

• 主要是修改Redis和MySQL的连接信息 ，Redis可以修改为自己服务器，MySQL为刚刚我们新建的本地marscloud数据库。（修改后记得发布【手动狗头】）

  

  

6、修改项目中nacos的连接信息

• 通常情况下nacos连接信息在项目的bootstrap.yml文件夹中，但该框架无bootstrap.yml文件，而是配置项目启动的环境变量；每个微服务模块启动的环境变量都需要修改，以下为idea中的操作。

  

  启动时的环境变量如下（其中 NACOS_GROUP，NACOS_NAMESPACE 表示配置所在的组和命名空间，NACOS_URL 表示 nacos 连接地址，根据实际连接信息替换）：

  Active profiles 为当前使用的配置环境

  NACOS_GROUP=DEFAULT_GROUP;NACOS_NAMESPACE=marscloud;NACOS_URL=localhost:8848

  

完成以上步骤后即可正常启动

Other 可能会出现的异常

若启动报错如下，说明未连接到nacos，需检查启动时的环境变量。

验证测试

• 根据以上操作启动gateway、system、uaa三个模块

• 使用apifox获取图片验证码进行测试，正常获取验证码，即项目后端部署完成（10002为网关端口）

Other 可能会出现的异常

若接口请求测试时出现以下异常，则可能是jdk版本导致，将jdk版本切换为1.8即可

Over！