工作流执行历史

为减轻 MongoDB 中 mdworkflow 库的存储空间持续增长压力，你可以选择将工作流执行历史进行归档，存储至新的 MongoDB 实例中。同时归档了的历史执行记录也可以在页面上进行选择查看。

如有历史未审批完、依旧进行中的的流程，数据被归档后会受影响，流程无法继续进行。

归档任务配置步骤

提前部署一套 MongoDB 实例，用与存储归档的数据。
- 我们提供了一个单节点 MongoDB 部署文档供参考。

docker pull registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-archivetools:1.0.4

创建 config.json 配置文件，示例内容如下：

[
    {
        "id": "1",
        "text": "描述",
        "start": "2022-12-31 16:00:00",
        "end": "2023-12-31 16:00:00",
        "src": "mongodb://root:password@192.168.1.20:27017/mdworkflow?authSource=admin",
        "archive": "mongodb://root:password@192.168.1.30:27017/mdworkflow_archive_2023?authSource=admin",
        "table": "wf_instance",
        "delete": true,
        "batchSize": 500,
        "retentionDays": 0
    },
    {
        "id": "2",
        "text": "描述",
        "start": "2022-12-31 16:00:00",
        "end": "2023-12-31 16:00:00",
        "src": "mongodb://root:password@192.168.1.20:27017/mdworkflow?authSource=admin",
        "archive": "mongodb://root:password@192.168.1.30:27017/mdworkflow_archive_2023?authSource=admin",
        "table": "wf_subInstanceActivity",
        "delete": true,
        "batchSize": 500,
        "retentionDays": 0
    },
    {
        "id": "3",
        "text": "描述",
        "start": "2022-12-31 16:00:00",
        "end": "2023-12-31 16:00:00",
        "src": "mongodb://root:password@192.168.1.20:27017/mdworkflow?authSource=admin",
        "archive": "mongodb://root:password@192.168.1.30:27017/mdworkflow_archive_2023?authSource=admin",
        "table": "wf_subInstanceCallback",
        "delete": true,
        "batchSize": 500,
        "retentionDays": 0
    }
]

根据上述配置文件格式，调整配置内容
注意，配置文件中指定的时间是世界时间 (UTC)
- UTC: 2022-12-31 16:00:00
  - 对应东八区时间 (UTC+8): 2023-01-01 00:00:00（2022-12-31 16:00:00 + 8 小时）
- UTC: 2023-12-31 16:00:00
  - 对应东八区时间 (UTC+8): 2024-01-01 00:00:00（2023-12-31 16:00:00 + 8 小时）

参数说明：

"id": "任务标识ID",
"text": "描述",
"start": "指定归档的数据起始时间，UTC 时区（retentionDays值大于0则此配置自动失效），归档大于等于这个时间的数据",
"end": "指定归档的数据结束时间，UTC 时区（retentionDays值大于0则此配置自动失效），归档小于这个时间的数据",
"src": "来源库连接地址",
"archive": "目标库连接地址（如果值为空，则不归档只按照设定的规则进行删除）",
"table": "数据表",
"delete": "默认为true，在当次归档任务完成后，并且校验记录数量正确时清理来源库已归档数据，不需要删除则改为 false",
"batchSize": "单次批量插入以及批量删除条数",
"retentionDays": "默认值为0。大于0时代表删除多少天前的数据，并开启定时删除任务模式，start与end指定的日期自动失效，默认每24h执行一次"

启动归档服务，在 config.json 文件所在目录下执行
```
docker run -d -it -v $(pwd)/config.json:/usr/local/MDArchiveTools/config.json  -v /usr/share/zoneinfo/Etc/GMT-8:/etc/localtime registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-archivetools:1.0.4
```
其他事项：
- 资源占用：程序运行期间，会对来源库、目标库及程序所在机器产生一定的资源占用压力，建议在业务空闲期间执行。
- 日志查看：
  - 后台运行（默认）：使用 docker ps -a 找到容器ID，然后执行 docker logs 容器ID 查看日志。
  - 前台运行：去掉 -d 参数，日志会实时输出到终端，方便观察进度。
- 在 config.json 配置文件示例中，以 源库名_archive_日期 格式给新库命名。每次执行时，请修改 archive 目标库名。
  - 因为程序在归档完成后会先统计目标表的数据量，如果不相等则不会进行删除。如果第二次运行时未修改 archive 目标库名，则可能导致目标表中数据总量比本次归档的多，导致源数据未删除。
- 回收磁盘空间：归档完成后会删除源库中的对应数据，但已删除数据所占用的磁盘空间不会立即释放，但通常会相同表被复用。

配置归档数据可视化

创建 application-www-ext.properties 配置文件

如：/data/mingdao/script/volume/workflow/application-www-ext.properties
```
spring.data.mongodb.archive.group[0].id=0
spring.data.mongodb.archive.group[0].text=\u5f52\u6863-2023
spring.data.mongodb.archive.group[0].uri=mongodb://root:password@192.168.1.30:27017/mdworkflow_archive_2023?authSource=admin
spring.data.mongodb.archive.group[0].start=2023-01-01
spring.data.mongodb.archive.group[0].end=2024-01-01
```
参数说明：
- group[0]：默认0，如果有多个归档数据则递增
- id：默认0，如果有多个归档数据则递增
- text：展示在页面上的名称，如有中文需要 Unicode 编码
- uri：归档数据库的连接地址
- start：归档数据的起始日期，仅支持填写日期，时间是00:00:00，基于程序默认东八区时间。
- end：归档数据的截至日期，仅支持填写日期，时间是00:00:00，基于程序默认东八区时间。
挂载配置文件
- 单机模式
- 集群模式
在微服务应用对应的 docker-compose.yaml volumes 中增加：
- ./volume/workflow/application-www-ext.properties:/usr/local/MDPrivateDeployment/workflow/application-www-ext.properties
参考集群挂载配置文件的方法将创建好的配置文件挂载至微服务容器内 /usr/local/MDPrivateDeployment/workflow/application-www-ext.properties 路径
重启微服务

归档任务配置步骤​

配置归档数据可视化​

归档任务配置步骤

配置归档数据可视化