Velero UI 镜像文档

概述

Velero UI 是一个实时轻量级Web仪表板，用于与Velero (vmware-tanzu)交互，实现与Velero CLI相同的全部功能。该仪表板提供直观的图形界面，帮助用户可视化管理Velero资源，监控状态并执行关键操作，简化备份、恢复和调度等任务的管理流程。

核心功能与特性

界面功能

• 安全认证：支持多种认证方式的安全访问机制
• 资源管理：提供资源搜索、排序及快速操作功能
• 操作确认：关键操作配备二次确认弹窗，防止误操作
• 向导式表单：分步式表单向导，简化资源创建与编辑流程
• 详细资源页面：每个资源均有专属页面，展示规格、状态、清单及日志
• 多语言支持：提供多语言界面切换

认证机制

• 内置认证：默认通过用户名密码凭证进行安全保护
• 联邦认证：支持最多五个外部认证提供商，包括GitHub、GitLab、Google、Microsoft及通用OAuth/OpenID
• LDAP集成：可配置与现有LDAP系统集成

统计分析

• 全局概览：查看Velero资源（备份、调度、恢复等）的汇总信息
• 图表可视化：通过直观图表跟踪资源状态和成功率等关键指标

高级设置

• 集群信息：访问运行Velero Server的集群基本信息
• 日志监控：实时监控Velero Server和节点代理的日志

技术特性

• 性能优化：采用缓存机制实现快速性能和渲染
• 响应式设计：完全支持移动设备和平板访问

使用场景

适用于需要通过Web界面管理Velero资源的用户，特别是：

• 需要可视化监控Velero备份、恢复、调度等资源状态的团队
• 希望简化Velero资源创建和管理流程的运维人员
• 需要多认证方式支持的企业级环境
• 需要实时监控Velero服务日志和集群信息的管理员

系统要求

• Velero server 版本：≥ 1.13.0

  ⚠️ 该仪表板仅在1.13.x、1.14.x和1.15.x版本测试通过，使用旧版本可能因API过时或未受支持导致功能异常

使用方法

安装部署

1. 确定本地Kube Config文件路径，默认路径为~/.kube/config

2. 执行以下Docker命令部署（可通过环境变量KUBE_CONTEXT指定集群上下文）：

bash
docker run --name velero-ui \
  -v ~/.kube/config:/app/.kube/config \
  -e KUBE_CONFIG_PATH=/app/.kube/config \
  -d -p 3333:3000 \
  otwld/velero-ui:latest

参数说明：

• -v ~/.kube/config:/app/.kube/config：将主机的Kube Config文件挂载到容器内
• -e KUBE_CONFIG_PATH=/app/.kube/config：指定容器内Kube Config文件路径
• -p 3333:3000：将容器的3000端口映射到主机的3333端口
• --name velero-ui：指定容器名称

访问方式

部署完成后，通过浏览器访问 http://localhost:3333 即可打开Velero UI仪表板，使用默认或配置的认证方式登录。

配置说明

环境变量

认证配置

支持通过界面配置多种认证方式：

• 内置用户名密码认证（默认启用）
• 外部OAuth/OpenID提供商（GitHub、GitLab等）
• LDAP集成（需在设置页面配置LDAP服务器信息）

扩展文档

如需了解更多功能详情，可参考***文档：Velero UI 文档