docs: 完善计划任务相关文档 (#20)

Author: wan92hen

docs/user_manual/cronjobs.md

@@ -1,52 +1,155 @@
-## 1 计划任务
+## 功能说明
 
 !!! Abstract ""
     主要用于管理需要定时执行的任务，如定期执行某shell脚本、定期备份、定期访问url等，同时支持手动执行。
 
 ![img.png](../img/cronjobs/cronjob_create.png)
 
-## 2 Shell 脚本
+## 任务类型
+
+### 1 Shell 脚本
+
+!!! Abstract "配置说明"
+    - 执行周期：选择当前计划任务的执行时间，可以同时配置多个执行周期；
+    - 在容器中执行：勾选后可以选择某个容器，在容器中执行指定的脚本；
+    - 脚本内容：具体需要执行的脚本内容；
+    - 是否告警（✨专业版）：定时任务执行失败时可以触发告警通知；
+    - 保留份数：执行记录及执行日志的保留份数，默认保存为7份；
+
+### 2 备份应用
+
+!!! Abstract "配置说明"
+
+    - 执行周期：选择当前计划任务的执行时间，可以同时配置多个执行周期；
+    - 备份应用：选择需要备份的应用，可以选择指定的应用备份，也可以备份所有应用；
+    - 备份账号：备份数据的存放位置，可以保存在当前服务器磁盘，或面板设置中配置的对象存储、FTP 等外部存储服务中；
+    - 压缩密码：备份数据压缩包的保护密码；
+    - 默认下载地址：当选择了多个备份账号，用于下载备份文件时默认使用的备份账号；
+    - 是否告警（✨专业版）：定时任务执行失败时可以触发告警通知；
+    - 保留份数：默认保存为7份，保留就近备份文件的数量，可以减少备份所使用的空间；
+    - 排除规则：备份数据压缩包中需要排除的文件，例如日志文件、临时目录等，支持配置多个排除规则；
+
+### 3 备份网站
+
+!!! Abstract "配置说明"
+
+    - 执行周期：选择当前计划任务的执行时间，可以同时配置多个执行周期；
+    - 备份网站：选择需要备份的网站，可以选择指定的网站备份，也可以备份所有网站；
+    - 备份账号：备份数据的存放位置，可以保存在当前服务器磁盘，或面板设置中配置的对象存储、FTP 等外部存储服务中；
+    - 压缩密码：备份数据压缩包的保护密码；
+    - 默认下载地址：当选择了多个备份账号，用于下载备份文件时默认使用的备份账号；
+    - 是否告警（✨专业版）：定时任务执行失败时可以触发告警通知；
+    - 保留份数：默认保存为7份，保留就近备份文件的数量，可以减少备份所使用的空间；
+    - 排除规则：备份数据压缩包中需要排除的文件，例如日志文件、临时目录等，支持配置多个排除规则；
+
+### 4 备份数据库
+
+!!! Abstract "配置说明"
+
+    - 执行周期：选择当前计划任务的执行时间，可以同时配置多个执行周期；
+    - 备份数据库：选择需要备份的数据库，可以选择指定的数据库备份，也可以备份所有数据库；
+    - 备份账号：备份数据的存放位置，可以保存在当前服务器磁盘，或面板设置中配置的对象存储、FTP 等外部存储服务中；
+    - 压缩密码：备份数据压缩包的保护密码；
+    - 默认下载地址：当选择了多个备份账号，用于下载备份文件时默认使用的备份账号；
+    - 是否告警（✨专业版）：定时任务执行失败时可以触发告警通知；
+    - 保留份数：默认保存为7份，保留就近备份文件的数量，可以减少备份所使用的空间；
+    - 排除规则：备份数据压缩包中需要排除的文件，例如日志文件、临时目录等，支持配置多个排除规则；
+
+## 5 备份目录
+
+!!! Abstract "配置说明"
+
+    - 执行周期：选择当前计划任务的执行时间，可以同时配置多个执行周期；
+    - 备份目录：选择需要备份的目录；
+    - 备份账号：备份数据的存放位置，可以保存在当前服务器磁盘，或面板设置中配置的对象存储、FTP 等外部存储服务中；
+    - 压缩密码：备份数据压缩包的保护密码；
+    - 默认下载地址：当选择了多个备份账号，用于下载备份文件时默认使用的备份账号；
+    - 是否告警（✨专业版）：定时任务执行失败时可以触发告警通知；
+    - 保留份数：默认保存为7份，保留就近备份文件的数量，可以减少备份所使用的空间；
+    - 排除规则：备份数据压缩包中需要排除的文件，例如日志文件、临时目录等，支持配置多个排除规则；
+
+## 6 备份日志
 
 !!! Abstract ""
-    输入任务名称，选择执行周期，输入执行的脚本内容。
 
-## 3 备份网站
+    备份以下日志内容：
+
+    - 1Panel 系统日志
+    - 服务器的 SSH 登录日志
+    - 所有网站日志
+
+!!! Abstract "配置说明"
+
+    - 执行周期：选择当前计划任务的执行时间，可以同时配置多个执行周期；
+    - 备份账号：备份数据的存放位置，可以保存在当前服务器磁盘，或面板设置中配置的对象存储、FTP 等外部存储服务中；
+    - 压缩密码：备份数据压缩包的保护密码；
+    - 默认下载地址：当选择了多个备份账号，用于下载备份文件时默认使用的备份账号；
+    - 是否告警（✨专业版）：定时任务执行失败时可以触发告警通知；
+    - 保留份数：默认保存为7份，保留就近备份文件的数量，可以减少备份所使用的空间；
+
+## 7 访问 URL
+
+!!! Abstract "配置说明"
+
+    - 执行周期：选择当前计划任务的执行时间，可以同时配置多个执行周期；
+    - 是否告警（✨专业版）：定时任务执行失败时可以触发告警通知；
+    - 保留份数：执行记录及执行日志的保留份数，默认保存为7份；
+    - URL 地址：需要定时访问的 URL 地址；
+
+## 8 切割网站日志
 
 !!! Abstract ""
 
-    - 执行周期，选择备份网站的执行时间；
-    - 选择需要备份的网站，可以选择指定的网站备份，也可以备份所有网站；
-    - 备份地点这里可以选择你安装存储相关的插件。如阿里云OSS、亚马逊 S3 云存储、MINIO、SFTP，和当前服务器磁盘；
-    - 备份保留数量，默认保存为7份，保留就近备份文件的数量，可以减少备份所使用的空间；
-    - 若是备份到服务器磁盘，则默认备份路径路径为 [安装目录]/1panel/backup/website。
+    计划任务执行时会将指定网站的日志进行切割，将之前产生的日志保存在备份目录下。
+
+!!! Abstract "配置说明"
+
+    - 执行周期：选择当前计划任务的执行时间，可以同时配置多个执行周期；
+    - 网站：选择需要进行日志切割的网站，可以选择指定的网站，也可以选择所有网站；    
+    - 是否告警（✨专业版）：定时任务执行失败时可以触发告警通知；
+    - 保留份数：默认保存为7份，保留就近切割后日志文件的数量；
 
-## 4 备份数据库
+## 9 缓存清理
 
 !!! Abstract ""
 
-    - 执行周期，选择备份网站的执行时间；
-    - 选择需要备份的数据库，可以选择指定的数据库备份，也可以备份所有数据库；
-    - 备份地点这里可以选择你安装存储相关的插件。如阿里云OSS、亚马逊 S3 云存储、MINIO、SFTP，和当前服务器磁盘；
-    - 备份保留数量，默认保存为7份，保留就近备份文件的数量，可以减少备份所使用的空间；
-    - 若是备份到服务器磁盘，则默认备份路径路径为 [安装目录]/1panel/backup/database。
+    定时执行面板 `工具箱` 菜单中的 `缓存清理` 任务。
 
-## 5 备份目录
+!!! Abstract "配置说明"
+
+    - 执行周期：选择当前计划任务的执行时间，可以同时配置多个执行周期；
+    - 是否告警（✨专业版）：定时任务执行失败时可以触发告警通知；
+    - 保留份数：执行记录及执行日志的保留份数，默认保存为7份；
+
+## 10 系统快照
 
 !!! Abstract ""
 
-    - 执行周期，选择备份网站的执行时间；
-    - 选择需要备份的文件目录；
-    - 备份地点这里可以选择你安装存储相关的插件。如阿里云OSS、亚马逊 S3 云存储、MINIO、SFTP，和当前服务器磁盘；
-    - 备份保留数量，默认保存为7份，保留就近备份文件的数量，可以减少备份所使用的空间；
-    - 若是备份到服务器磁盘，则默认备份路径路径为/www/backup/database；
-    - 支持设置排除文件，但是系统要求必须以换行符分隔，一行一个。
+    定时执行面板 `面本设置`-`快照` 菜单中的 [`创建快照`](../settings/#5) 任务，。
+
+!!! Abstract "配置说明"
 
-## 6 访问 URL
+    - 执行周期：选择当前计划任务的执行时间，可以同时配置多个执行周期；
+    - 备份账号：备份数据的存放位置，可以保存在当前服务器磁盘，或面板设置中配置的对象存储、FTP 等外部存储服务中；
+    - 压缩密码：备份数据压缩包的保护密码；
+    - 默认下载地址：当选择了多个备份账号，用于下载备份文件时默认使用的备份账号；
+    - 是否告警（✨专业版）：定时任务执行失败时可以触发告警通知；
+    - 保留份数：默认保存为7份，保留就近备份文件的数量，可以减少备份所使用的空间；
+    - 排除规则：备份数据压缩包中需要排除的文件，例如日志文件、临时目录等，支持配置多个排除规则；
+
+## 11 同步服务器时间
 
 !!! Abstract ""
-    用于自动执行URL地址访问，设置任务名称、执行周期和访问地址就可以计划访问URL地址了。
 
-## 7 计划报告
+    定时从 `工具箱`-`快速设置` 页面配置的 NTP 服务器进行时间同步。
+
+!!! Abstract "配置说明"
+
+    - 执行周期：选择当前计划任务的执行时间，可以同时配置多个执行周期；
+    - 是否告警（✨专业版）：定时任务执行失败时可以触发告警通知；
+    - 保留份数：执行记录及执行日志的保留份数，默认保存为7份；
+
+## 执行报告
 
 !!! Abstract ""
     显示该任务产生的所有报告详情，支持时间、状态筛选，如果计划任务为备份，则可通过报告详情的下载按钮直接下载。