docs(cron): edit text

Author: ruanyf

docs/cron.md

@@ -4,21 +4,42 @@
 
 Cron 是一个用来执行定时任务的工具，可以在指定的时间自动执行重复性任务。
 
-它的核心是 cron 守护进程，名为 crond。它在后台每分钟运行一次，检查是否有需要在指定时间执行的计划任务。
+它的核心是 cron 守护进程，名为 crond。它在后台每分钟运行一次，检查是否有需要在当前时间执行的计划任务。
 
 下面命令可以查看 cron 守护进程，是否正常运行。
 
 ```bash
+# Ubuntu / Debian
 $ sudo systemctl status cron
+# or
+$ ps aux | grep cron
+
+# rockyOS / RHEL
+$ sudo systemctl status crond
+# or
+$ ps aux | grep crond
 ```
 
 ## crontab
 
-crond 检查的定时任务，保存在 crontab 文件。该文件的每一行代表一个单独的作业，包含何时运行该任务，以及所要执行的命令。
+crond 检查的定时任务，保存在 crontab 文件。该文件的每一行代表一个单独的任务，包含何时运行该任务，以及所要执行的命令。
 
 crontab 分成两个级别：用户个人的crontab，系统的 crontab。前者由用户本人编辑，后者只能由根用户编辑。
 
-系统的 crontab 存放在`/etc/crontab`，以及一系列特殊目录之中：`/etc/cron.daily`、`/etc/cron.hourly`、`/etc/cron.weekly`和`/etc/cron.monthly`。
+系统的 crontab 存放在`/etc/crontab`（或目录`/etc/cron.d/`），以及一系列特殊目录之中：`/etc/cron.daily`、`/etc/cron.hourly`、`/etc/cron.weekly`和`/etc/cron.monthly`。
+
+`crontab`本身也是一个命令，下面的命令可以检查现有的 cron 任务。
+
+```bash
+# 当前用户的 cron 任务
+$ crontab -l
+
+# 根用户的 cron 任务
+$ sudo crontab -l
+
+# 某个指定用户的 cron 任务
+$ sudo crontab -u [USERNAME] -l
+```
 
 ## cron 任务的语法
 
@@ -59,18 +80,38 @@ crontab 文件中，以“#”符号开头的行表示注释。
 
 以下是一些示例。
 
-- `* * * * *`	每分钟运行一次 cron 作业。
-- `0 * * * *`	每小时运行一次 cron 作业。
-- `0 0 * * *`	每天午夜运行 cron 作业。
-- `0 2 * * *`	每天凌晨 2 点运行 cron 作业。
-- `0 0 15 * *`	每个月 15 日午夜运行一次 cron 作业。
-- `0 0 0 12 *`	周六午夜运行 cron 作业。
-- `0 0 * * 6`	从周一到周五每天下午 3 点运行 cron 作业。
-- `0 15 * * 1-5`	从周一到周五每天下午 3 点运行 cron 作业。
-- `*/5 * * * *`	每 5 分钟运行一次 cron 作业。
-- `0 8-16 * * *` 每天、每小时、从上午 8 点到下午 4 点准时执行 cron 作业。
+- `* * * * *`	每分钟运行一次 cron 任务。
+- `0 * * * *`	每小时运行一次 cron 任务。
+- `0 0 * * *`	每天午夜运行 cron 任务。
+- `0 2 * * *`	每天凌晨 2 点运行 cron 任务。
+- `0 0 15 * *`	每个月 15 日午夜运行一次 cron 任务。
+- `0 0 0 12 *`	周六午夜运行 cron 任务。
+- `0 0 * * 6`	从周一到周五每天下午 3 点运行 cron 任务。
+- `0 15 * * 1-5`	从周一到周五每天下午 3 点运行 cron 任务。
+- `*/5 * * * *`	每 5 分钟运行一次 cron 任务。
+- `0 8-16 * * *` 每天、每小时、从上午 8 点到下午 4 点准时执行 cron 任务。
 - `0 4 * * 2,4`	在周二和周四凌晨 4 点运行 cron 作业。
-- `@reboot`	系统启动时运行 cron 作业。
+- `@reboot`	系统启动时或 crond 进程启动时运行 cron 任务。
+
+此外，还有几个特殊字母。
+
+`L` 表示 Last，仅适用于“月份中的某一天”和“星期几”。
+
+```bash
+0 4 L * * command -每月最后一天凌晨 4 点
+0 4 * * 5L command -每月最后一个星期五凌晨 4 点
+```
+`W`表示 weekday，即该月内最近的一个工作日，仅适用于“月份中的某一天”。
+
+```bash
+0 4 15W * * command -每月 15 日最近的工作日（周一至周五）凌晨 4 点
+```
+
+`#`表示该月的第几个，仅适用于“星期几”。
+
+```bash
+0 4 * * 5#2 -每月第二个周五凌晨 4 点
+```
 
 ### 环境变量
 
@@ -92,51 +133,64 @@ SHELL=/bin/sh
 
 上面示例设定执行 cron 任务时，使用 Bash。
 
+添加其他环境变量，都是这种格式。
+
+```bash
+result="HELLO WORLD"
+```
+
+上面示例添加了环境变量`result`，值为“HELLO WORLD”。
+
 ## cron 任务管理
 
 ### 个人任务
 
 创建或编辑用户的 crontab 文件，使用下面的命令。
 
 ```bash
-crontab -e
-```
-
-上面的命令会打开系统默认文本编辑器，对用户的 crontab 文件进行编辑。
+# 编辑当前用户的 cron 任务
+$ crontab -e
 
-添加 cron 任务，只需在 crontab 文件中添加一个新行即可。例如，备份脚本 backup.sh 每天凌晨 3:00 运行，就是添加下面的内容。
+# 编辑根用户的 cron 任务
+$ sudo crontab -e
 
-```bash
-0 3 * * * /home/linuxiac/backup.sh
+# 编辑指定用户的 cron 任务
+$ sudo crontab -u [USERNAME] -e
 ```
 
-编辑完成后，保存并退出编辑器。Cron 服务会自动检查 crontab 文件，因此无需在更改后重新启动 Cron 进程。
+上面的命令会打开系统默认文本编辑器，对用户的 crontab 文件进行编辑。
 
-`crontab -e`还会在保存和退出文件时，自动检查语法，防止意外输入无效的 cron 任务。
+另一种方法是手动把 cron 任务添加到系统的`/etc/cronjob`文件，或者在`/etc/cron.d/`目录中创建一个新文件。建议使用后者，因为`/etc/cronjob`有可能在系统更新时被覆盖。
 
-下面命令可以列出当前用户的所有 cron 任务。
+更新上面两个位置的 crontab 文件时，每个任务需要在第六个字段添加某个用户名，表示该任务运行在哪个用户名下。
 
 ```bash
-$ crontab -l
+* * * * * user command
 ```
 
-如果拥有根用户权限，可以查看其他用户的 cron 任务。
+定期运行脚本还有一种方法，就是使用`/etc/cron.*`目录，将脚本保存在以下目录之一的里面，就可以直接以根用户的身份运行该任务。（为了确保脚本可以运行，最好打开脚本的运行权限。）
+
+- /etc/cron.hourly/
+- /etc/cron.daily/
+- /etc/cron.weekly/
+- /etc/cron.monthly/
+
+添加 cron 任务，只需在 crontab 文件中添加一个新行即可。例如，备份脚本 backup.sh 每天凌晨 3:00 运行，就是添加下面的内容。
 
 ```bash
-$ sudo crontab -u [用户名] -l
+0 3 * * * /home/linuxiac/backup.sh
 ```
 
-上面示例中，`[用户名]`是需要替换的部分。
+编辑完成后，保存并退出编辑器。cron 服务会自动检查 crontab 文件，因此无需在更改后重新启动 cron 进程。
 
-编辑其他用户的 cron 任务，可以使用命令行参数`-e`。
+`crontab -e`还会在保存和退出文件时，自动检查语法，防止意外输入无效的 cron 任务。
 
-```bash
-$ sudo crontab -u [用户名] -e
-```
+删除某个 cron 任务时，只要删除那一行即可。
 
-删除某个 cron 任务时，只要删除那一行即可。如果想要删除所有的 cron 任务，只要删除 crontab 文件即可，也可以使用命令行参数`-r`。
+如果想要删除所有的 cron 任务，只要删除 crontab 文件即可，也可以使用命令行参数`-r`。
 
 ```bash
+# 删除当前用户的所有 cron 任务，而且没有提示
 $ crontab -r
 ```
 
@@ -145,9 +199,20 @@ $ crontab -r
 如果希望删除前出现确认提示，则可以使用命令行参数`-i`。
 
 ```bash
+# 删除当前用户的所有 cron 任务之前，会有确认提示
 $ crontab -i -r
 ```
 
+下面是删除根用户和其他用户的 cron 任务。
+
+```bash
+# 删除根用户的所有 cron 任务
+$ sudo crontab -r
+
+# 删除特定用户的所有 cron 任务
+$ sudo crontab -u USERNAME -r
+```
+
 ### 系统任务
 
 创建系统级别的 cron 任务，需要直接编辑`/etc/crontab`文件。
@@ -171,8 +236,22 @@ $ crontab -i -r
 - /etc/cron.weekly/ 目录
 - /etc/cron.monthly/ 目录
 
+### cron 任务的日志
+
+cron 任务执行的 stdout 输出不会被记录，必须添加到命令或脚本本身。
+
+```bash
+0 4 * * 5L command -v >> /var/logs/command.log
+```
+
+简单的执行记录，可以查看系统日志。Ubuntu / Debian 是`/var/log/syslog`或者`/var/log/auth.log`，RHEL/RHEL 是`/var/log/cron`，可以使用 grep 命令过滤日志。
+
+```bash
+$ sudo grep -i cron /var/log/syslog /var/log/auth.log
+```
+
 ## 参考链接
 
 - [How to Use Cron on Linux: Tips, Tricks, and Examples](https://linuxiac.com/how-to-use-cron-and-crontab-on-linux/)
-
+- [Cron Jobs on Linux - Comprehensive Guide with Examples](https://ittavern.com/cron-jobs-on-linux-comprehensive-guide/)