opsx
3ea7f2dcc6
- homepage/:品牌落地页(Hero/特性/快速开始),参考 opsxapi 站点风格,绿色品牌系 - docs/:docsify 文档站 + user-guide 十篇手册(安装/向导/采集/查询/分析/告警/授权/备份/FAQ) - 后端 serveStaticDir 挂载 /docs 与 /homepage(可执行文件相对定位,独立于前端 dist)
117 lines
3.7 KiB
Go
117 lines
3.7 KiB
Go
package controllers
|
||
|
||
import (
|
||
"fmt"
|
||
"lokistack/pkg/metrics"
|
||
"time"
|
||
|
||
"github.com/gin-gonic/gin"
|
||
|
||
"lokistack/services"
|
||
"lokistack/utils"
|
||
)
|
||
|
||
// SystemController 系统级运维操作：备份 / 恢复 / 巡检。
|
||
type SystemController struct{}
|
||
|
||
func NewSystemController() *SystemController { return &SystemController{} }
|
||
|
||
// Backup 导出当前平台数据（tar.gz 下载）。
|
||
//
|
||
// 内容：数据文件 + kubeconfigs/ + known_hosts/ + manifest.json（含密钥指纹），
|
||
// 不含明文密钥。恢复必须使用同一把 ENCRYPTION_KEY。
|
||
func (ctrl *SystemController) Backup(c *gin.Context) {
|
||
name := fmt.Sprintf("lokistack-backup-%s.tar.gz", time.Now().Format("20060102-150405"))
|
||
c.Header("Content-Type", "application/gzip")
|
||
c.Header("Content-Disposition", fmt.Sprintf(`attachment; filename="%s"`, name))
|
||
|
||
if _, err := services.CreateBackup(c.Writer); err != nil {
|
||
// 已经写了响应头，无法再改状态码，只能把错误写进 body 尾部
|
||
_, _ = c.Writer.WriteString(fmt.Sprintf("\n\n# 备份失败: %v", err))
|
||
return
|
||
}
|
||
}
|
||
|
||
// Restore 上传备份包：校验 + 暂存，**不直接覆盖**线上数据库。
|
||
// 返回暂存路径与密钥指纹比对结果，由管理员确认后再调用 RestoreApply。
|
||
func (ctrl *SystemController) Restore(c *gin.Context) {
|
||
file, err := c.FormFile("file")
|
||
if err != nil {
|
||
utils.BadRequest(c, "请上传备份文件（form-data 字段名 file）")
|
||
return
|
||
}
|
||
if file.Size > 128<<20 {
|
||
utils.BadRequest(c, "备份文件超过 128MB，请用 run.sh restore 在服务器上操作")
|
||
return
|
||
}
|
||
f, err := file.Open()
|
||
if err != nil {
|
||
utils.InternalServerError(c, fmt.Sprintf("读取上传文件失败: %v", err))
|
||
return
|
||
}
|
||
defer f.Close()
|
||
|
||
res, err := services.ValidateAndStageBackup(f)
|
||
if err != nil {
|
||
utils.BadRequest(c, fmt.Sprintf("备份校验失败: %v", err))
|
||
return
|
||
}
|
||
utils.Success(c, res)
|
||
}
|
||
|
||
// RestoreApply 应用已暂存的备份。应用后需重启平台进程才生效。
|
||
func (ctrl *SystemController) RestoreApply(c *gin.Context) {
|
||
var req struct {
|
||
Confirm bool `json:"confirm"`
|
||
}
|
||
_ = c.ShouldBindJSON(&req)
|
||
if !req.Confirm {
|
||
utils.BadRequest(c, "恢复会覆盖当前全部数据，请传 confirm=true 确认")
|
||
return
|
||
}
|
||
path, err := services.ApplyStagedBackup()
|
||
if err != nil {
|
||
utils.BadRequest(c, err.Error())
|
||
return
|
||
}
|
||
utils.Success(c, gin.H{
|
||
"message": "备份已应用，请重启平台使新数据生效（kubectl -n log rollout restart deploy/lokistack）",
|
||
"dbPath": path,
|
||
})
|
||
}
|
||
|
||
// Backups 列出服务器上已有的备份文件（run.sh backup 产出）。
|
||
func (ctrl *SystemController) Backups(c *gin.Context) {
|
||
utils.Success(c, gin.H{"list": services.ListBackups()})
|
||
}
|
||
|
||
// GetRetention 读取平台数据保留期（告警发送历史 / 审计日志）。
|
||
func (ctrl *SystemController) GetRetention(c *gin.Context) {
|
||
utils.Success(c, services.GetRetentionSettings())
|
||
}
|
||
|
||
// SaveRetention 保存平台数据保留期。
|
||
// 校验范围而不是直接接受：保留 0 天等于"什么都不留"，通常是误操作。
|
||
func (ctrl *SystemController) SaveRetention(c *gin.Context) {
|
||
var req services.RetentionSettings
|
||
if !utils.BindAndValidate(c, &req) {
|
||
return
|
||
}
|
||
if err := services.SaveRetentionSettings(req.AlertDeliveryDays, req.AuditLogDays); err != nil {
|
||
utils.BadRequest(c, err.Error())
|
||
return
|
||
}
|
||
utils.Success(c, services.GetRetentionSettings())
|
||
}
|
||
|
||
// Health 平台自检：一键诊断用。
|
||
// 聚合「能不能用」的判断，避免排障时在多个页面之间跳。
|
||
func (ctrl *SystemController) Health(c *gin.Context) {
|
||
utils.Success(c, services.SelfCheck())
|
||
}
|
||
|
||
// MetricsSummary 平台自监控快照(仅 admin;原始 Prometheus 文本在 /api/v1/metrics)
|
||
func (ctrl *SystemController) MetricsSummary(c *gin.Context) {
|
||
utils.Success(c, metrics.Snapshot())
|
||
}
|