mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 18:35:56 +00:00
61 lines
2.0 KiB
Markdown
61 lines
2.0 KiB
Markdown
---
|
||
id: appstore.update.howto
|
||
title: 更新一个插件
|
||
type: howto
|
||
feature: appstore
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 更新插件
|
||
- 升级插件
|
||
- 怎么升级 AI
|
||
- 插件有新版本
|
||
- update plugin
|
||
- 升级应用
|
||
related_tools: []
|
||
related_pages: [application]
|
||
prerequisites:
|
||
- 需要系统管理员权限
|
||
- 服务器能拉取新镜像
|
||
negative:
|
||
- 更新会触发容器重建，期间该插件功能短暂不可用
|
||
- 不支持回滚到旧版本（除非自行管理镜像）
|
||
- 不支持自动升级（每次需要管理员手动确认）
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 更新一个插件
|
||
|
||
## 入口
|
||
桌面端：左侧栏「应用」→「应用商店」（仅管理员）→ 已安装的插件如果有新版本，会显示「更新」按钮。
|
||
|
||
## 操作步骤
|
||
1. 进入应用商店，看到有新版本提示（红点 / 数字）
|
||
2. 点击插件 → 「更新」
|
||
3. 阅读更新日志，确认无破坏性变更
|
||
4. 点「确认更新」
|
||
5. AppStore 微服务拉新镜像 → 停旧容器 → 起新容器
|
||
6. `config.yml` 的 `install_version` 更新
|
||
|
||
## 更新期间会发生什么
|
||
- 该插件提供的接口短暂返回 502 / 不可用（几秒到一分钟）
|
||
- 微应用入口仍在「应用」页，但点开可能加载失败
|
||
- 与该插件交互的 AI 工具、机器人会失败（前端通常会重试）
|
||
|
||
## 更新失败怎么办
|
||
- 多数因为新镜像拉取失败（网络、镜像源），先看 [[appstore.cannot-install.faq]] 的网络部分
|
||
- 容器起不来：服务器 `docker logs` 看日志
|
||
- 状态卡在「更新中」：到 `docker/appstore/config/{appId}/config.yml` 检查状态字段
|
||
- 必要时卸载重装
|
||
|
||
## 更新前建议
|
||
1. 浏览插件官方说明，确认有无破坏性变更（DB 迁移、参数改名等）
|
||
2. 业务高峰期之外操作
|
||
3. 关键插件（AI / 审批 / 签到）先备份对应数据
|
||
4. 提前通知使用方
|
||
|
||
## 不支持
|
||
- 不支持选择目标版本号升级（只能升到最新）
|
||
- 不支持自动定时升级
|
||
- 不支持回滚（除非自己留旧镜像 + 手动改 docker-compose）
|