docs: 新增 update.sh 更新脚本 + README 更新升级章节
- update.sh:对应 install.sh 的两种模式做升级(① Docker 拉新镜像重建 / ② 本地重编内嵌二进制),可选 git pull;DB 迁移靠启动幂等重跑 schema.sql - README 新增「更新升级」一节(方式一~四),说明数据不丢 + 重启即迁移 + 建议先备份
This commit is contained in:
1 parent
052c35a954
commit
cb64fdb0e4
2 files changed
+127
No files matched your search
@@ -110,6 +110,54 @@ CGO_ENABLED=0 go build -tags embedui -o artex ./cmd/artex
|
||||
|
||||
---
|
||||
|
||||
## 更新升级
|
||||
|
||||
> 升级只换程序、不动数据:Postgres 数据卷 `pgdata`、`./data`(jwt.key / SQLite 等)、`./skills` 都会保留。**数据库迁移无需手动执行**——`artex` 每次启动会幂等重跑 `schema.sql`(含 `ADD COLUMN` / `CREATE INDEX IF NOT EXISTS`),即“重启即迁移”。升级前仍建议先备份 `./data` 与数据库。
|
||||
|
||||
### 方式一:一键更新脚本(推荐)
|
||||
|
||||
```bash
|
||||
cd ARTEX
|
||||
./update.sh
|
||||
```
|
||||
|
||||
脚本先可选 `git pull` 拉取最新代码,再让你选 **① Docker 更新** 或 **② 本地编译更新**(与 `install.sh` 对应):
|
||||
|
||||
- **① Docker**:可指定目标镜像 tag(回车沿用 `.env` 的 `ARTEX_TAG`,缺省 `latest`)→ `docker compose pull` → `docker compose up -d`(换新镜像重启即自动迁移)。
|
||||
- **② 本地**:重建前端静态产物 → 重新编译 `./artex`(完成后重启进程生效)。
|
||||
|
||||
### 方式二:Docker Compose(手动)
|
||||
|
||||
```bash
|
||||
cd ARTEX
|
||||
git pull # 更新 compose / 脚本(可选)
|
||||
# 指定版本:在 .env 设 ARTEX_TAG=v0.2.0;不设则用 latest
|
||||
docker compose pull artex
|
||||
docker compose up -d artex # 换新镜像重启 → 自动迁移 schema
|
||||
docker image prune -f # 清理旧镜像(可选)
|
||||
```
|
||||
|
||||
### 方式三:预编译二进制(Releases)
|
||||
|
||||
到 [Releases](https://github.com/Autumn-27/ARTEX/releases) 下载新版本 zip,停掉旧进程后覆盖 `artex` 与 `skills/`(保留你的 `config.json` 与 `data/`),重启即可:
|
||||
|
||||
```bash
|
||||
cp -r <解压目录>/skills ./ && cp <解压目录>/artex ./
|
||||
./artex
|
||||
```
|
||||
|
||||
### 方式四:从源码编译
|
||||
|
||||
```bash
|
||||
git pull
|
||||
cd web && npm ci && npm run build:static && cd ..
|
||||
cp -r web/out server/webui/dist
|
||||
CGO_ENABLED=0 go build -tags embedui -o artex ./cmd/artex
|
||||
# 重启 ./artex
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 配置
|
||||
|
||||
**数据库**(`config.json`,或用环境变量 `ARTEX_PG_DSN` 覆盖):
|
||||
|
||||
@@ -0,0 +1,79 @@
|
||||
#!/usr/bin/env bash
|
||||
# ARTEX 更新脚本:① Docker 更新(拉新镜像重建) ② 本地编译更新(重建二进制)
|
||||
# 与 install.sh 对应:install 负责首次落地,update 负责升级到新版本。
|
||||
# DB 迁移无需手动执行——artex 每次启动都会幂等重跑 schema.sql(含 ADD COLUMN/CREATE
|
||||
# INDEX IF NOT EXISTS),所以“重启即迁移”。数据(pgdata 卷、./data、./skills)不受影响。
|
||||
set -euo pipefail
|
||||
cd "$(cd "$(dirname "$0")" && pwd)"
|
||||
|
||||
info(){ printf '\033[36m[*]\033[0m %s\n' "$*"; }
|
||||
ok(){ printf '\033[32m[+]\033[0m %s\n' "$*"; }
|
||||
warn(){ printf '\033[33m[!]\033[0m %s\n' "$*"; }
|
||||
die(){ printf '\033[31m[x]\033[0m %s\n' "$*" >&2; exit 1; }
|
||||
ask(){ local p="$1" d="${2:-}" a; read -rp "$p${d:+ [$d]}: " a; echo "${a:-$d}"; }
|
||||
|
||||
# ── 可选:同步仓库到最新代码(compose/脚本/本地编译源码都靠它更新)───────
|
||||
sync_repo(){
|
||||
[ -d .git ] && command -v git >/dev/null 2>&1 || { warn "非 git 工作副本,跳过 git pull"; return; }
|
||||
[ "$(ask '拉取最新代码 (git pull --ff-only)? (y/n)' y)" = y ] || return
|
||||
if ! git pull --ff-only; then
|
||||
warn "git pull 未能快进(本地有改动或分支分叉)——请手动处理后重试,本次沿用当前代码"
|
||||
fi
|
||||
}
|
||||
|
||||
# ── ① Docker 更新 ───────────────────────────────
|
||||
update_docker(){
|
||||
command -v docker >/dev/null 2>&1 && docker compose version >/dev/null 2>&1 \
|
||||
|| die "未检测到 docker / docker compose,请先用 ./install.sh 安装部署"
|
||||
[ -f .env ] || die "未找到 .env,请先运行 ./install.sh 完成首次部署"
|
||||
|
||||
# 可选:升级到指定版本 tag(不填则沿用 .env 中的 ARTEX_TAG,缺省为 latest)
|
||||
local tag; tag="$(ask '目标镜像 tag(回车沿用 .env / latest)' '')"
|
||||
if [ -n "$tag" ]; then
|
||||
if grep -q '^ARTEX_TAG=' .env; then
|
||||
sed -i.bak "s|^ARTEX_TAG=.*|ARTEX_TAG=${tag}|" .env && rm -f .env.bak
|
||||
else
|
||||
printf '\nARTEX_TAG=%s\n' "$tag" >> .env
|
||||
fi
|
||||
ok "已将 ARTEX_TAG 设为 ${tag}"
|
||||
fi
|
||||
|
||||
info "拉取新镜像…"
|
||||
docker compose pull
|
||||
info "重建并启动(artex 重启时自动迁移 schema)…"
|
||||
docker compose up -d
|
||||
ok "更新完成 → http://localhost:8787"
|
||||
info "查看日志:docker compose logs -f artex"
|
||||
info "清理旧镜像(可选):docker image prune -f"
|
||||
}
|
||||
|
||||
# ── ② 本地编译更新 ──────────────────────────────
|
||||
update_local(){
|
||||
command -v go >/dev/null 2>&1 || die "未检测到 Go(>=1.26):https://go.dev/dl/"
|
||||
[ -f config.json ] || warn "未找到 config.json——若首次部署请改用 ./install.sh"
|
||||
ok "Go: $(go version)"
|
||||
|
||||
if command -v npm >/dev/null 2>&1; then
|
||||
info "重建前端静态产物…"
|
||||
( cd web && npm ci && npm run build:static )
|
||||
rm -rf server/webui/dist && cp -r web/out server/webui/dist
|
||||
info "重新编译内嵌单二进制…"
|
||||
CGO_ENABLED=0 go build -tags embedui -trimpath -o artex ./cmd/artex
|
||||
else
|
||||
warn "未检测到 npm:编译**不内嵌前端**的后端(前端需另跑 npm run dev)"
|
||||
CGO_ENABLED=0 go build -o artex ./cmd/artex
|
||||
fi
|
||||
ok "编译完成 → ./artex"
|
||||
warn "请重启正在运行的 artex 进程以生效(重启时会自动迁移 schema)"
|
||||
}
|
||||
|
||||
echo "=============================="
|
||||
echo " ARTEX 更新"
|
||||
echo " 1) Docker 更新(拉新镜像重建)"
|
||||
echo " 2) 本地更新(go 重新编译)"
|
||||
echo "=============================="
|
||||
case "$(ask '选择' 1)" in
|
||||
1) sync_repo; update_docker ;;
|
||||
2) sync_repo; update_local ;;
|
||||
*) die "无效选择" ;;
|
||||
esac
|
||||
Reference in new issue
Block a user