UpgradeLink

简体中文

English

简体中文

English

主题

UpgradeLink 集群化部署 ​

这个手册是帮忙您快速在通过 UpgradeLink 的项目的镜像示例，在 Docker 容器中部署并使用 UpgradeLink。

在开始前，希望您有拥有一下经验：

  • 熟悉 Docker 容器化部署。
  • 熟悉 MySQL 数据库。
  • 熟悉 Redis 缓存。
  • 熟悉 后端项目的部署。
  • 阅读下项目模块介绍，了解每个模块的功能。 项目模块介绍

1. 环境准备 ​

需要安装 Docker。

2. 下载项目 ​

2.1. 从 GitHub 下载项目 ​

shell
git clone https://github.com/toolsetlink/upgradelink

3.修改 mysql 与 redis 的配置替换为自己的数据库相关信息。 ​

注意 1：若使用独立的 MySQL/Redis 环境需调整配置。

注意 2：【关键】若数据库部署在宿主机（物理机/虚拟机），但应用程序运行在 Docker 容器中：

  • 禁止填写 127.0.0.1（容器内的 127.0.0.1 指向容器自身，无法访问宿主机）；
  • 需替换为宿主机的实际内网 IP（如 192.168.1.100、10.0.0.5 等）。

注意 3：MySQL 初始化脚本路径：development/upgradelink-2.4.0.sql。

数据库初始化

如何查询宿主机内网 IP？ ​

  • Linux/macOS：执行 ip addr（或 ifconfig），查看 eth0/en0 等网卡的 inet 字段；
  • Windows：执行 ipconfig，查看"以太网/WLAN"下的 IPv4 地址。

调整下方的配置文件 ​

upgradelink-admin-core/server/api/etc/core-api.yaml

upgradelink-admin-core/server/rpc/etc/core-rpc.yaml

upgradelink-admin-file/build/Dockerfile
upgradelink-admin-message/build/Dockerfile
upgradelink-admin-upgrade/build/Dockerfile
upgradelink-admin-task/build/Dockerfile
upgradelink-admin-ui/build/Dockerfile

upgradelink-api/build/Dockerfile

4. 进行 docker 镜像 build ​

4.1 构建对应模块的 docker 镜像 ​

dockerfile 参考

upgradelink-admin-core/build/Dockerfile-api
upgradelink-admin-core/build/Dockerfile-api
upgradelink-admin-file/build/Dockerfile
upgradelink-admin-message/build/Dockerfile
upgradelink-admin-upgrade/build/Dockerfile
upgradelink-admin-task/build/Dockerfile
upgradelink-admin-ui/build/Dockerfile

upgradelink-api/build/Dockerfile

6.调整 upgradelink-admin-ui 前端项目的 nginx 文件 ​

后台管理系统相关

调整 location /sys-api/ 为 指向 upgradelink-admin-core-api 模块的地址 调整 location /fms-api/ 为 指向 upgradelink-admin-file 模块的地址 调整 location /upgrade/ 为 指向 upgradelink-admin-upgrade 模块的地址

7. 启动 UpgradeLink ​

项目模块介绍

启动顺序

  1. 启动 upgradelink-admin-core-rpc 模块
  2. 启动 upgradelink-admin-file 模块
  3. 启动 upgradelink-admin-message 模块
  4. 启动 upgradelink-admin-upgrade 模块
  5. 启动 upgradelink-admin-core-api 模块
  6. 启动 upgradelink-admin-task 模块
  7. 启动 upgradelink-admin-ui 模块
  8. 启动 upgradelink-api 模块

8. 访问 UpgradeLink 后台管理系统 ​

可以通过下列服务，快速检验 UpgradeLink 的功能。

8.1 UpgradeLink 控制台页面 ​

打开任意浏览器，输入地址：http://127.0.0.1:80, 即可进入 UpgradeLink 控制台页面。

注意：默认账号密码为 admin simple-admin

8.2 api 接口 ​

api 服务地址为 http://127.0.0.1:8888,可参考 api 文档替换地址进行测试。