67 lines
2.5 KiB
Go
67 lines
2.5 KiB
Go
package v1
|
|
|
|
import (
|
|
"github.com/gogf/gf/v2/frame/g"
|
|
"github.com/gogf/gf/v2/os/gtime"
|
|
)
|
|
|
|
// === 系统在线升级（管理后台） ===
|
|
|
|
// UpdateCheck 检查系统更新
|
|
type UpdateCheckReq struct {
|
|
g.Meta `path:"/update/check" method:"get" mime:"json" tags:"管理后台-系统更新" summary:"检查系统更新"`
|
|
Force bool `json:"force" in:"query" d:"false" dc:"是否强制跳过缓存检查"`
|
|
}
|
|
|
|
type UpdateCheckRes struct {
|
|
CurrentVersion string `json:"current_version"`
|
|
LatestVersion string `json:"latest_version"`
|
|
HasUpdate bool `json:"has_update"`
|
|
ReleaseNotes string `json:"release_notes"`
|
|
ReleaseURL string `json:"release_url"`
|
|
PublishedAt *gtime.Time `json:"published_at,omitempty"`
|
|
CheckedAt *gtime.Time `json:"checked_at"`
|
|
DeploymentMode string `json:"deployment_mode"` // binary | docker
|
|
}
|
|
|
|
// UpdateStatus 获取更新状态（升级进行中时前端轮询）
|
|
type UpdateStatusReq struct {
|
|
g.Meta `path:"/update/status" method:"get" mime:"json" tags:"管理后台-系统更新" summary:"获取更新状态"`
|
|
}
|
|
|
|
type UpdateStatusRes struct {
|
|
CurrentVersion string `json:"current_version"`
|
|
DeploymentMode string `json:"deployment_mode"` // binary | docker
|
|
Updating bool `json:"updating"`
|
|
LastCheck *UpdateCheckRes `json:"last_check,omitempty"`
|
|
UpdateProgress *UpdateProgress `json:"update_progress,omitempty"`
|
|
RollbackAvailable bool `json:"rollback_available"`
|
|
BackupVersion string `json:"backup_version,omitempty"`
|
|
}
|
|
|
|
type UpdateProgress struct {
|
|
Phase string `json:"phase"` // downloading | verifying | backing_up | replacing | restarting | complete | failed
|
|
Message string `json:"message"` // 当前操作描述
|
|
Percentage int `json:"percentage"` // 0-100
|
|
Error string `json:"error,omitempty"` // 失败时的错误信息
|
|
}
|
|
|
|
// UpdateExecute 触发系统升级
|
|
type UpdateExecuteReq struct {
|
|
g.Meta `path:"/update/execute" method:"post" mime:"json" tags:"管理后台-系统更新" summary:"触发系统升级"`
|
|
Version string `json:"version" v:"required" dc:"目标版本号"`
|
|
}
|
|
|
|
type UpdateExecuteRes struct {
|
|
Message string `json:"message"`
|
|
}
|
|
|
|
// UpdateRollback 回滚到上一版本（仅二进制模式）
|
|
type UpdateRollbackReq struct {
|
|
g.Meta `path:"/update/rollback" method:"post" mime:"json" tags:"管理后台-系统更新" summary:"回滚到上一版本"`
|
|
}
|
|
|
|
type UpdateRollbackRes struct {
|
|
Message string `json:"message"`
|
|
}
|