1. 概述编辑
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V1.5.5 | - |
| V1.12.0 | 提高备份前磁盘空间检查要求，防止备份导致磁盘爆满 调整运维项目备份还原要求，存在24小时内备份即可还原 |
| V1.16.0 | 备份管理支持FineDataLink应用 |
| V2.7.0 | 备份内容精简，取消备份以下文件夹，防止时间过长 1）FineReport单机取消备份历史版本模板：/assets/vcs 2）FineDataLink单机取消备份历史快照：/dpworks/records 3）集群取消备份Excel源文件：/assets/temp_attach 4）FineDataLink集群取消备份历史快照：/dpworks/records |
| V2.10.0 | 备份内容精简，取消备份FineBI6.1的数据存储组件内容，仅对数据存储组件的配置进行备份 |
| V2.29.0 | 1）新增「项目备份状态异常」告警，备份失败时自动触发告警提醒 2）新增备份完整性校验逻辑，以防备份文件无效 |
1.2 应用场景
FineReport、FineBI、FineDataLink应用本身存在备份还原功能，但是存在一些短板：
1）应用备份文件，只能备份至工程目录下，无法异地备份，误操作时若删除工程，可能会将备份也删除掉。
2）应用中的模板、数据越多，应用备份的速度越慢。
3）应用备份时，jar包、模板、配置都是分开备份还原的，但是大多时候需要将这些内容按照时间点统一备份还原。
运维平台备份容器化项目时，对于自备的组件不会进行备份，也无法进行还原
建议用户在进行项目备份时，自行手动对这些组件进行备份，并在还原时同步还原
1.3 功能简介
运维平台提供「备份管理」功能。
支持一键备份，支持自动备份
支持将项目备份到运维平台所在服务器，实现异地备份。
支持界面化管理备份，查看备份失败记录等情况。
2. 使用前提编辑
2.1 确认镜像仓库配置
由于备份运维平台部署的项目时，可能需要备份项目所用镜像，因此必须确保运维平台与镜像仓库正常连接。
因此若运维平台未配置镜像仓库，不支持使用备份功能，提示「请配置镜像仓库后使用此功能」。
2.2 设置备份限制
由于备份会占用服务器内存，因此需要对备份个数和占用磁盘空间进行限制。
管理员登录运维平台，点击「设置>备份设置」，设置后点击「保存」生效。
此设置对运维平台内所有项目生效。
| 设置内容 | 说明 |
|---|---|
| 备份上限 | 限制每一个运维项目的备份个数上限 当某个项目的手动/自动备份文件个数达到上限时，会自动清理最早的一份备份文件 默认支持分别保留3份手动/自动备份文件 |
| 磁盘限制 | 支持对运维平台的备份保存目录的磁盘剩余可用空间设置一个约束值 一般存储在运维平台挂载目录/ops/resources/backup文件夹
|
2.3 了解备份内容
2.3.1 运维平台部署的项目
仅对运维平台部署的项目组件进行备份。用户自备组件不会备份，也无法通过运维平台进行还原。
建议用户在进行项目备份时，自行手动对这些自备组件进行备份，并在还原时同步还原。
| 组件 | 备份内容（容器内路径） | 说明 |
|---|---|---|
bi-web/bi6/fr/fdl 应用 | /usr/local/tomcat/webapps/webroot/APP/classes | 工程调用的默认和自定义class文件 |
| /usr/local/tomcat/webapps/webroot/APP/config | 平台调用的配置库（finedb）相关文件 | |
| /usr/local/tomcat/webapps/webroot/APP/customlib | 工程定制/外部引入的JAR包、字体等 | |
| /usr/local/tomcat/webapps/webroot/APP/drivers | 驱动管理上传的驱动 | |
| /usr/local/tomcat/webapps/webroot/APP/plugins | 插件相关文件 | |
bi6/fr/fdl 应用 仅单应用项目备份此部分内容 | /usr/local/tomcat/webapps/webroot/APP/assets 备份该文件夹下除temp_attach和vcs以外的内容 | 通用的共享持久化目录 |
| /usr/local/tomcat/webapps/webroot/APP/dashboards | 老版本FineBI仪表板相关文件（如无相关目录则不备份） | |
/usr/local/tomcat/webapps/webroot/APP/dpworks 备份该文件夹下除record和records以外的内容 | FineDataLink任务相关的配置文件（如无相关目录则不备份） | |
| /usr/local/tomcat/webapps/webroot/APP/reportlets | FineReport模板存放目录 | |
| /usr/local/tomcat/webapps/webroot/APP/resources | 工程相关的资源配置文件 | |
| /usr/local/tomcat/webapps/webroot/APP/schedule | 定时调度生成的文件 | |
bi-engine-master bi6.1引擎元数据 | /data/polars/rocks_data | meta信息持久化存储 |
| bi-engine-worker bi6.1引擎计算 | 不备份目录，只备份容器配置 | - |
bi-minio bi6.1数据存储 | 不备份目录，只备份容器配置 | - |
nginx 帆软内网关 | /usr/local/nginx/conf | Nginx 的配置文件 |
| /usr/local/nginx/lua | Lua 脚本文件 | |
mysql 外接配置库 | /var/lib/mysql 备份该文件夹下除mysql.sock以外的内容 | MySQL 数据库的实际数据文件 |
| elasticsearch 日志服务 | /usr/share/elasticsearch/config/elasticsearch.yml | Elasticsearch 的配置文件 |
| /run/secrets | ElasticSearch一些敏感信息或者安全相关的文件 | |
filebeat 日志采集 | /usr/share/filebeat/filebeat.yml | filebeat的配置文件 |
| /usr/share/filebeat/data | filebeat的数据目录 | |
| /usr/share/filebeat/config | input文件 | |
| redis 状态服务 | /data | redis的数据目录 |
| minio 文件存储 | assets 备份该文件夹下除temp_attach和vcs以外的内容 | 通用的共享持久化目录 |
| dashboards | 老版本FineBI仪表板相关文件（如无相关目录则不备份） | |
dpworks 备份该文件夹下除record和records以外的内容 | FineDataLink任务相关的配置文件（如无相关目录则不备份） | |
| reportlets | FineReport模板存放目录 | |
| resources | 存放工程相关的资源配置文件 | |
| schedule | 定时调度生成的文件 | |
nacos 服务注册中心 | /home/nacos/data | 数据库derby等数据 |
nacos_mysql nacos服务所需的配置存储 | /var/lib/mysql 备份该文件夹下除mysql.sock以外的内容 | MySQL 数据库的实际数据文件 |
| kafka 管道服务 | 不备份目录，只备份容器配置 | - |
2.3.2 非运维平台部署的项目
仅对工程相关文件进行备份。外接配置库、日志存储等组件，均不进行备份。
建议用户在进行项目备份时，自行手动对这些必要组件进行备份，并在还原时同步还原。
| 位置 | 备份内容 | 说明 |
|---|---|---|
bi/fr/fdl应用节点 | /webroot/WEB-INF/classes | 工程调用的默认和自定义class文件 |
| /webroot/WEB-INF/config | 平台调用的配置库（finedb）相关文件 | |
| /webroot/WEB-INF/customlib | 工程定制/外部引入的JAR包、字体等 | |
| /webroot/WEB-INF/drivers | 驱动管理上传的驱动 | |
| /webroot/WEB-INF/plugins | 插件相关文件 | |
单机：bi/fr/fdl应用节点下 集群：文件服务器中 | /webroot/WEB-INF/assets 备份该文件夹下除temp_attach和vcs以外的内容 | 通用的共享持久化目录 |
| /webroot/WEB-INF/dashboards | 老版本FineBI仪表板相关文件（如无相关目录则不备份） | |
/webroot/WEB-INF/dpworks 备份该文件夹下除record和records以外的内容 | FineDataLink任务相关的配置文件（如无相关目录则不备份） | |
| /webroot/WEB-INF/reportlets | FineReport模板存放目录 | |
| /webroot/WEB-INF/resources | 工程相关的资源配置文件 |
3. 备份项目编辑
两种备份方式：
手动备份：管理员可手动触发对项目的备份
自动备份：可设定自动备份时间，运维平台在指定时间点对项目自动备份
3.1 手动备份
管理员登录运维平台，选择运维项目，点击「维护>备份管理」。
1）选择备份内容：
| 项目类型 | 选择 | 备份内容 |
|---|---|---|
| 运维平台部署的项目 | 不勾选 备份镜像 | 备份2.3.1节列出的所有内容 注：仅对运维平台部署的项目组件进行备份。用户自备组件不会备份 建议用户在进行项目备份时，自行手动对这些自备组件进行备份，并在还原时同步还原 |
勾选 备份镜像 | 1）备份项目组件当前版本的镜像文件 2）备份2.3.1节列出的所有内容 注：仅对运维平台部署的项目组件进行备份。用户自备组件不会备份 建议用户在进行项目备份时，自行手动对这些自备组件进行备份，并在还原时同步还原 | |
| 非运维平台部署的项目 | 不勾选 备份jar包 | 备份2.3.2节列出的所有内容 注：仅对工程相关文件进行备份。外接配置库、日志存储等组件，均不进行备份 建议用户在进行项目备份时，自行手动对这些必要组件进行备份，并在还原时同步还原 |
勾选 备份jar包 | 1）备份项目当前使用版本的JAR包文件 2）备份2.3.2节列出的所有内容 注：仅对工程相关文件进行备份。外接配置库、日志存储等组件，均不进行备份 建议用户在进行项目备份时，自行手动对这些必要组件进行备份，并在还原时同步还原 |
2）开始备份：
点击「开始备份」，设置备份的名称，点击「确定」，即可开始手动备份该项目。
开始备份后，用户可切换到其他页面进行操作，备份可在后台进行。
注1：手动备份超出备份上限时，提醒「此项目已存在X个手动备份，此次备份将覆盖最早一次手动备份，是否继续？」。
注2：若备份保存目录剩余可用空间小于2.2节的限制，则备份失败。
注3：备份文件禁止命名重复。
3.2 定时自动备份
管理员登录运维平台，选择运维项目，点击「维护>备份管理」。
1）选择备份内容：
| 项目类型 | 选择 | 备份内容 |
|---|---|---|
| 运维平台部署的项目 | 不勾选 备份镜像 | 备份2.3.1节列出的所有内容 注：仅对运维平台部署的项目组件进行备份。用户自备组件不会备份 建议用户在进行项目备份时，自行手动对这些自备组件进行备份，并在还原时同步还原 |
勾选 备份镜像 | 1）备份项目组件当前版本的镜像文件 2）备份2.3.1节列出的所有内容 注：仅对运维平台部署的项目组件进行备份。用户自备组件不会备份 建议用户在进行项目备份时，自行手动对这些自备组件进行备份，并在还原时同步还原 | |
| 非运维平台部署的项目 | 不勾选 备份jar包 | 备份2.3.2节列出的所有内容 注：仅对工程相关文件进行备份。外接配置库、日志存储等组件，均不进行备份 建议用户在进行项目备份时，自行手动对这些必要组件进行备份，并在还原时同步还原 |
勾选 备份jar包 | 1）备份项目当前使用版本的JAR包文件 2）备份2.3.2节列出的所有内容 注：仅对工程相关文件进行备份。外接配置库、日志存储等组件，均不进行备份 建议用户在进行项目备份时，自行手动对这些必要组件进行备份，并在还原时同步还原 |
2）开始备份：
开启「自动备份」按钮，设置好备份频率。在指定时间，运维平台会自动对该项目进行备份。
自动生成的备份名称为备份时间。
注1：自动备份超出2.2节的备份上限时，自动删除最早 1 份。
注2：若备份保存目录剩余可用空间小于2.2节的限制，则不再进行自动备份。
4. 管理备份编辑
4.1 备份生成位置
自动/手动备份生成的内容，存放在运维平台的挂载目录/ops/resources/backup下。
用户可将运维平台和项目的服务器分开，实现异机备份。
注1：不支持修改和自定义项目备份存放的位置。
注2：外挂目录的查找方式可参考：导出运维平台部署信息
注3：在存储备份、日常巡检、还原备份时，均会对备份内容进行完整性检查，因此请勿手动修改备份内容，可能会导致备份无效。
4.2 展示备份信息
在运维平台「全部备份」中，以明细表格式展示每一个备份的详细情况。右上角展示备份保存目录剩余可用空间。
| 展示项 | 说明 |
|---|---|
| 备份名称 | 备份文件的名称 |
| 备份类型 | 备份的类型，包括：手动备份、自动备份 |
| 开始时间 | 备份开始的时间，精确到秒 |
| 结束时间 | 备份结束的时间，精确到秒 |
| 备份大小 | 备份文件的大小 |
4.3 删除备份
勾选需要删除的备份，点击「删除」，即可删除备份。如下图所示：
4.4 重命名备份
点击备份后方的「重命名」按钮，对备份进行重命名，点击「确定」，重命名生效。
注：备份文件禁止命名重复。
4.5 备份及还原失败记录
点击「备份及还原失败记录」，可查看备份及还原失败的记录明细表。如下图所示：
V2.29.0及之后版本，运维平台内置了「项目备份状态异常」告警，当备份失败时自动触发告警提醒。
4.6 查看备份目录名
非容器化部署的工程，手动生成的备份，在运维平台的备份目录中显示的文件名均为ID。用户很难判断每个备份文件对应的前端显示内容，在进行还原时十分不方便。
对于非容器化部署的工程，手动生成的备份，鼠标悬浮即可查看备份目录名，点击按钮时可复制名称到剪贴板。
