作者：管理员  历史版本：1  最后编辑：Eddy  更新时间：2024-11-15 09:05

后端服务启动环境配置

  • 微服务和单体部署包环境配置的区别
    • 微服务部署包有4个服务文件夹下的配置文件要修改。其中business、oauth2server、platform要修改conf、config文件夹下的配置文件 gateway只需修改config文件夹下的配置文件。
    • 单体部署包只需修改boot服务文件夹下的conf、config文件夹下的配置文件。

以下配置修改均以business服务为例。单体部署只需按照下面例子，修改boot文件夹下同名的配置文件。

  • 首先指定服务的启动环境：

    • 有dev|test|prod可选，本文档示例的环境为dev。

    • 配置文件在对应服务的config/application.yml文件夹下。

      修改前：

      spring:
application:
  name: ibps-business-provider
profiles:
  active: ${SPRING_PROFILES_ACTIVE:test}
  include: common,app

      修改后：

      spring:
application:
  name: ibps-business-provider
profiles:
  active: ${SPRING_PROFILES_ACTIVE:dev} # 修改位置
  include: common,app

  • 如配置文件指定的启动环境为dev，代表生效的是下图红框中对应的application-dev-xxxx.yml的配置文件，test|prod环境以此类推。

微服务
环境配置文件目录示例

单体
环境配置文件目录示例

修改后端数据源信息

  • 根据上面配置的启动环境，修改business、oauth2server、platform的数据源配置文件。单体只许修改boot 的数据源配置文件。

  • 配置文件是对应的conf/dataSorce-xxx.xml文件，xxx指的是配置的环境，则对应修改如下文件名 dataSource-dev.xml。dataSorce-xxx.xml文件为默认的mysql数据源配置文件，其它支持数据库配置文件为dataSorce-yyy-xxx.xml文件，yyy为数据库名。

  • 以business为例，修改business/conf/dataSource-dev.xml文件。

    后端数据源配置文件目录2
    修改信息如下所示：

修改前：
```xml
    <!-- dev下使用该链接 -->
    <dbType>mysql</dbType>
    <driver>com.mysql.jdbc.Driver</driver>
    <driverUrl>jdbc:mysql://192.168.3.210:3306/ibps_tom_business?useUnicode=true&amp;characterEncoding=utf-8</driverUrl>
    <user>root</user>
    <password>root</password>
```

修改后：
```xml
    <!-- dev下使用该链接 -->
    <dbType>mysql</dbType>
    <driver>com.mysql.jdbc.Driver</driver>
    <driverUrl>jdbc:mysql://127.0.0.1:3306/ibps_jerry?useUnicode=true&amp;characterEncoding=utf-8</driverUrl> #修改位置
    <user>admin</user> #修改位置
    <password>admin</password> #修改位置
```

将对应的数据库服务的 IP192.168.3.210，端口3306，数据库名ibps_tom_business，账号root，密码root修改为你自己的数据库配置即可。

注意：oauth2server和platform服务的数据源使用的是platform数据库，business服务的数据源使用的是business数据库。单体boot服务的数据源要合并为一个boot数据库。执行mysql脚本

如果使用的不是MySQL数据库,还需要在application-app.yml中修改dbType为当前使用的数据库配置

数据库类型修改示意图

授权文件替换

授权文件过期的话后端服务会宕机，服务也无法启动。
授权文件替换示意图
替换最新授权文件方法详见 部署FAQ

修改注册中心IP和端口

在V3.5.1 版本后默认注册中心为nacos

如何切换nacos

  • 当默认注册中心为consul时
    修改各个服务文件下的config/application-dev-consul.yml文件,修改以下内容：

修改前：

consul:
  serviceUrl:
    defaultZone: ${CONSUL_SERVICEURL_DEFAULTZONE：http://192.168.3.230:18500}
spring:
  cloud:
    consul:
      host: ${SPRING_CLOUD_CONSUL_HOST:192.168.3.230}
      port: ${SPRING_CLOUD_CONSUL_PORT:18500}
      discovery:
        health-check-path: /health
        health-check-interval: 20s

修改后：

consul:
  serviceUrl:
    defaultZone: ${CONSUL_SERVICEURL_DEFAULTZONE:http://127.0.0.1:8500} #修改位置 对应consul的IP地址和端口
spring:
  cloud:
    consul:
      host: ${SPRING_CLOUD_CONSUL_HOST:127.0.0.1} # 修改位置 对应consul配置的IP地址
      port: ${SPRING_CLOUD_CONSUL_PORT:8500} #修改位置 对应consul配置的端口
      discovery:
        health-check-path: /health
        health-check-interval: 20s
  • 当默认注册中心为nacos时

修改各个服务文件下的config/application-dev-nacos.yml文件,修改以下内容：

修改前：

spring:
  cloud:
    nacos:
      discovery:
        server-addr: ${NACOS_SERVER_ADDR:192.168.3.230:8848}
              # 填写命名空间ID！！！
        namespace: ${NACOS_NAMESPACE:ibps_dev}
        group: ${NACOS_GROUP:ibps_dev}
        service: ${spring.application.name}

修改后：

spring:
  cloud:
    nacos:
      discovery:
        server-addr: ${NACOS_SERVER_ADDR:127.0.0.1:8848} # 修改位置 对应nacos服务配置的IP地址和端口号
              # 填写命名空间ID！！！
        namespace: ${NACOS_NAMESPACE:ibps_dev} #修改位置 填写nacos创建的命名空间ID
        group: ${NACOS_GROUP:xxx} #修改位置 填写分组名
        service: ${spring.application.name}

修改公用服务配置

  1. 邮箱配置：

    • 配置文件是对应服务文件夹下的/config/application-common.yml文件。

    • 以business服务的配置文件路径为business/config/application-common.yml

      邮箱配置内容如下所示：

      修改前：

      ##---------邮箱配置---------
mail:
notify-to: ${MAIL_NOTIFY_TO:}
from-address: ${MAIL_FROM_ADDRESS:}
host: ${MAIL_HOST:}
mailAddress: ${MAIL_ADDRESS:}
username: ${MAIL_USERNAME:}
password: ${MAIL_PASSWORD:}

      修改后：

        ##---------邮箱配置---------
  mail:
    notify-to: ${MAIL_NOTIFY_TO:xxx@qq.cn} #修改位置
    from-address: ${MAIL_FROM_ADDRESS:yyy@163.com}
    host: ${MAIL_HOST:smtp.163.com}
    mailAddress: ${MAIL_ADDRESS:yyy@163.com}
    username: ${MAIL_USERNAME:yyy}
    password: ${MAIL_PASSWORD:yyy}

  2. MQ和redis配置：

    • 配置文件是服务文件夹下的/config/application-dev-base.yml文件。

    • Rabbitmq有默认配置，可不用手动配置。若要手动配置，修改和新增以下内容：

      rabbitmq:
  host: ${SPRING_RABBITMQ_HOST:127.0.0.1} # 修改 127.0.0.1改为真实rabbitmq的IP地址
  port: ${SPRING_RABBITMQ_PORT:5672} # 修改 5672改为你真实rabbitmq的端口
  username: ${SPRING_RABBITMQ_USERNAME:ibps} # 新增 ibps改为真实用户名，没有该属性时默认用户名为ibps
  password: ${SPRING_RABBITMQ_PASSWORD:ibps} # 新增 ibps改为为真实密码，没有该属性时默认密码为ibps@123
  virtual-host: ${SPRING_RABBITMQ_VIRTUAL_HOST:/}

    • redis有默认配置，可不用手动配置。若要手动配置，修改以下内容：

      redis:
  database: ${SPRING_REDIS_DATABASE:0} # 修改为所需的数据库值
  host: ${SPRING_REDIS_HOST:127.0.0.1} # 127.0.0.1修改为真实redis的IP地址
  port: ${SPRING_REDIS_PORT:6379} # 6379修改为真实redis的端口
  password: ${SPRING_REDIS_PASSWORD:} # 如果redis设置密码请修改此处
  ssl: ${SPRING_REDIS_SSL:false}
  timeout: ${SPRING_REDIS_TIMEOUT:3000}
  lettuce:
    pool:
      max-active: ${SPRING_REDIS_LETTUCE_POOL_MAX_ACTIVE:10}
      max-idle: ${SPRING_REDIS_LETTUCE_POOL_MAX_IDLE:5}
      max-wait: ${SPRING_REDIS_LETTUCE_POOL_MAX_WAIT:3000}
      min-idle: ${SPRING_REDIS_LETTUCE_POOL_MIN_IDLE:0}

也可通过修改app.bat文件，设置相关参数，具体可看FAQ中的说明。

配置fastdfs文件服务的IP和端口

  • 配置文件位置：在platform\config\application-[dev|test|prod]-fileserver.yml文件。

  • 以dev环境为例，修改platform\config\application-dev-fileserver.yml文件。

    修改以下内容：

    修改前：

      fastdfs:
    common:
      tracker-servers: ${FILE_TRACKER_SERVER:192.168.3.207:22122}

    修改后：

      fastdfs:
    common:
      tracker-servers: ${FILE_TRACKER_SERVER:192.168.3.210:22122}

注意：fastdfs暂不支持Windows系统下安装部署，配置的地址和端口为fastdfs所在服务器的地址和端口。

socket端口配置

  • 配置文件是platform\config\application-[dev|test|prod]-socket.yml。

  • 以dev环境为例，修改platform\config\application-dev-socket.yml文件。

    新增内容如下：

      socket:
    port: 6888 # 对应所需端口，默认端口是15888

注意：前端代码部署时，基础配置中的platform服务的端口为这里所设置的端口。

授权文件替换

详见 部署FAQ