mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-09-29 14:06:36 +08:00
ryan
86 lines
2.1 KiB
Markdown
86 lines
2.1 KiB
Markdown
# 升级与维护
|
||
|
||
你会学到：如何升级 Server 与 Agent、如何清理观测数据，以及维护前后应该执行哪些验证命令。
|
||
|
||
升级前建议先确认当前激活版本、最近一次 Agent 应用结果和数据库备份策略。生产环境不要在发布配置、Agent 大规模重连或数据库迁移进行中同时升级。
|
||
|
||
## Server 升级
|
||
|
||
Root 用户可以在管理端顶栏检查并升级 Server 正式版。也可以通过上传 Server 二进制的方式执行确认升级。
|
||
|
||
如需尝试 preview 版本，可手动检查对应发布。生产环境建议优先使用正式版。
|
||
|
||
升级后确认：
|
||
|
||
```bash
|
||
docker compose ps
|
||
docker compose logs -n 100 openflare
|
||
```
|
||
|
||
如果是源码部署，重新启动 Server 后确认日志中没有数据库迁移或启动错误。
|
||
|
||
## Agent 升级
|
||
|
||
节点 Agent 默认只跟随正式版自动更新。preview 升级需要手动触发。
|
||
|
||
安装脚本可重复执行，用于重装或升级 Agent：
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/Rain-kl/OpenFlare/main/scripts/install-agent.sh | bash -s -- \
|
||
--server-url http://your-server:3000 \
|
||
--agent-token YOUR_AGENT_TOKEN
|
||
```
|
||
|
||
注意：当前安装脚本重装时会删除整个安装目录，包括旧 `agent.json`、本地状态、缓存数据和下载的二进制。执行前请确认手头仍有可用 Token。
|
||
|
||
升级后确认：
|
||
|
||
```bash
|
||
systemctl status openflare-agent
|
||
journalctl -u openflare-agent -n 100 --no-pager
|
||
```
|
||
|
||
## 数据维护
|
||
|
||
管理端设置页可以维护观测数据自动清理策略：
|
||
|
||
| 配置项 | 说明 |
|
||
| --- | --- |
|
||
| `DatabaseAutoCleanupEnabled` | 是否启用每日自动清理 |
|
||
| `DatabaseAutoCleanupRetentionDays` | 自动清理保留天数，至少 1 天 |
|
||
|
||
开启后，Server 会在每天凌晨 3 点清理访问日志、指标快照与请求报告。
|
||
|
||
## 常用验证命令
|
||
|
||
Server：
|
||
|
||
```bash
|
||
cd openflare_server
|
||
GOCACHE=/tmp/openflare-go-cache go test ./...
|
||
```
|
||
|
||
Agent：
|
||
|
||
```bash
|
||
cd openflare_agent
|
||
GOCACHE=/tmp/openflare-go-cache go test ./...
|
||
```
|
||
|
||
Frontend：
|
||
|
||
```bash
|
||
cd openflare_server/web
|
||
pnpm lint
|
||
pnpm typecheck
|
||
pnpm test
|
||
pnpm build
|
||
```
|
||
|
||
Docs：
|
||
|
||
```bash
|
||
cd docs
|
||
pnpm build
|
||
```
|