UpgradeAll Server

UpgradeAll 服务端代码仓库

该项目旨在为 UpgradeAll 项目 提供数据支持。 它由以下部分构成

1. 服务端主体。
2. 软件源脚本仓库。

内容列表

• 背景
• 安装
• 使用说明
  • 运行这个项目
    • Docker Compose
    • Podman
    • 手动安装并运行
• 相关仓库
• 维护者
• 如何贡献
• 使用许可

背景

UpgradeAll 服务端 最开始因为 @yah 在维护脚本时发觉本地爬虫的效率问题而被提出，并于 0.1.2 版本（客户端版本）的开发阶段实现。

安装

这个项目使用 Python 3。请确保你本地安装了它们。

使用说明

克隆仓库，这样你就可以开始使用该项目了

$ git clone --depth=1 https://github.com/DUpdateSystem/Server.git
# 获取你的调试/开发的基础环境
$ cd server
# 进入 Server 主体代码文件夹

运行这个项目

Docker Compose

Most easy way!

# 在项目根目录下
$ docker-compose -f ./oci_build/docker-compose.yml up
# 更新/重启服务
$ cd ./oci_build && docker compose pull && docker compose down && docker compose up -d

Docker/Podman

该方法适合分布式部署

数据库

1. 按照 oci_build/db.env 设置 mariadb 初始环境（主要是用户/密码），然后运行它
2. 使用 Docker/Podman 运行数据库

# 在项目根目录下
$ podman run --rm --name=upa-db --env-file oci_build/db.env -v $PWD/db_data/:/var/lib/mysql -p 3306:3306 mariadb

服务端

$ podman run --rm --name=upa-proxy -p 5256:5256 xiangzhedev/upgradeall-server discovery --bind 'tcp://0.0.0.0:5256' # 启动服务发现
$ podman run --rm --name=upa-getter --network=host -e ip='127.0.0.1' xiangzhedev/upgradeall-server getter -r 'tcp://127.0.0.1:5256' -b 'tcp://0.0.0.0:(5257)' -db 'upa@127.0.0.1:3306' # 启动后端
$ podman run --rm --name=upa-hello --network=host -e discovery_url=tcp://127.0.0.1:5256 -e database_url=upa@127.0.0.1:3306 xiangzhedev/upgradeall-server hello # 启动 API 前端
$ curl -w "%{http_code}\n" localhost:5255/about # 测试服务端

手动运行

该方法只用于开发调试

数据库

部署方法与 Docker 一致

服务端

1. 安装 Python 依赖

# 在项目根目录下
$ python3 -m venv venv
$ source venv/bin/activate
$ pip install -r server/requirements.txt
$ deactivate

2. 部署

# 在 server 目录下
$ ../scripts/boot_dev.sh discovery --bind 'tcp://127.0.0.1:5256' # 启动服务发现
$ ../scripts/boot_dev.sh getter -r tcp://127.0.0.1:5256 -b 'tcp://127.0.0.1:(5257)' -db 'upa@127.0.0.1:3306' # 启动后端
$ discovery_url='tcp://127.0.0.1:5256' database_url='upa@127.0.0.1:3306' ../scripts/boot_dev.sh hello # 启动 API 前端
$ curl -w "%{http_code}\n" localhost:5255/about # 测试服务端

相关仓库

• UpgradeAll — UpgradeAll 的安卓实现。
• UpgradeAll-rules — UpgradeAll 的配置文件仓库。

维护者

@xz-dev。

如何贡献

非常欢迎你的加入！官方文档-参与我们
你已经有一个明确的想法了?请 提一个 Issue 或者提交一个 Pull Request。

使用许可

GPL-3.0 © xz-dev