用 GitHub Actions 实现每天自动跑脚本的实战指南

用 GitHub Actions 实现自动化，不仅可以提高开发效率，还能减少大量的重复工作。去年我帮朋友配置了一个项目，每天自动运行脚本来检查代码质量，效果非常好。今天，我就来分享一下具体的实战经验，帮助你轻松实现项目管理的自动化。

## 为什么要用 GitHub Actions？

GitHub Actions 是 GitHub 提供的一个强大的自动化工具，可以让你在代码仓库中定义各种自动化任务。无论是持续集成（CI）、持续交付（CD），还是定时任务，GitHub Actions 都能轻松搞定。相比其他 CI/CD 工具，GitHub Actions 的优势在于它与 GitHub 无缝集成，使用起来更加方便。

### 主要优势
- **无缝集成**：直接在 GitHub 仓库中管理自动化任务。
- **灵活性**：支持多种编程语言和环境。
- **免费额度**：对于个人项目和小型团队，免费额度足够使用。
- **社区支持**：庞大的 GitHub 社区，资源丰富，问题容易解决。

## 准备工作

在开始之前，你需要确保以下几点：
1. 有一个 GitHub 账号
2. 有一个 GitHub 仓库
3. 基本的 YAML 语法知识

如果你还没有 GitHub 账号，赶紧注册一个吧。至于仓库，可以选择你现有的一个项目，或者新建一个用于测试。YAML 语法虽然简单，但掌握一些基础还是有必要的，毕竟它会用在 GitHub Actions 的配置文件中。

### 创建仓库
如果你还没有现成的仓库，可以在 GitHub 上新建一个。点击右上角的 "+" 号，选择 "New repository"，填写相关信息即可。

## 配置 GitHub Actions

### 创建 .github/workflows 目录
在你的仓库中，需要创建一个 `.github/workflows` 目录来存放 GitHub Actions 的配置文件。你可以通过 GitHub 的 Web 界面来操作，也可以在本地用 Git 命令创建。

```bash
mkdir -p .github/workflows
```

### 编写配置文件
配置文件的格式是 YAML，文件名可以自定义，但建议使用有意义的名称，比如 `daily-script.yml`。以下是一个简单的示例配置文件，用于每天运行一个简单的脚本：

```yaml
name: Daily Script

on:
schedule:
- cron: '0 0 * * *' # 每天午夜运行

jobs:
run-script:
runs-on: ubuntu-latest

steps:
- name: Checkout repository
uses: actions/checkout@v2

- name: Set up Python
uses: actions/setup-python@v2
with:
python-version: '3.8'

- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install -r requirements.txt

- name: Run script
run: python script.py
```

### 解释配置文件
- **name**: 任务的名称，可以自定义。
- **on.schedule.cron**: 定时任务的配置，使用标准的 cron 表达式。`0 0 * * *` 表示每天午夜运行。
- **jobs**: 定义任务的执行环境和步骤。
- **runs-on**: 选择运行环境，这里使用 Ubuntu 最新版本。
- **steps**: 任务的具体步骤，包括检出仓库、设置 Python 环境、安装依赖和运行脚本。

## 具体案例：每日代码质量检查

去年我帮一个朋友配置了一个每日代码质量检查的 GitHub Actions。他每天都要手动运行一些脚本来检查代码质量，非常麻烦。于是，我帮他设置了一个定时任务，每天自动运行这些脚本。

### 项目背景
这个项目是一个 Python 项目，使用了 `flake8` 和 `black` 两个工具来检查代码质量和格式化代码。我们希望每天午夜自动运行这些工具，并将结果发送到 Slack 频道。

### 配置文件
以下是具体的配置文件：

```yaml
name: Daily Code Quality Check

on:
schedule:
- cron: '0 0 * * *' # 每天午夜运行

jobs:
code-quality:
runs-on: ubuntu-latest

steps:
- name: Checkout repository
uses: actions/checkout@v2

- name: Set up Python
uses: actions/setup-python@v2
with:
python-version: '3.8'

- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install flake8 black

- name: Run flake8
run: flake8 .

- name: Run black
run: black .

- name: Send results to Slack
uses: rtCamp/action-slack-notify@v2
with:
webhook_url: ${{ secrets.SLACK_WEBHOOK_URL }}
text: 'Code quality check completed successfully!'
```

### 解释配置文件
- **name**: 任务的名称，这里是 "Daily Code Quality Check"。
- **on.schedule.cron**: 每天午夜运行。
- **jobs**: 定义任务的执行环境和步骤。
- **runs-on**: 使用 Ubuntu 最新版本。
- **steps**: 具体步骤，包括检出仓库、设置 Python 环境、安装 `flake8` 和 `black`，运行这些工具，并将结果发送到 Slack。

## 具体案例：每日数据同步

另一个常见的应用场景是数据同步。假设你有一个项目需要每天从一个 API 拉取数据并存储到数据库中。你可以使用 GitHub Actions 来自动化这个过程。

### 项目背景
这个项目是一个 Node.js 项目，需要每天从一个外部 API 拉取数据，并将数据存储到 MongoDB 数据库中。我们希望每天早上 6 点自动运行这个脚本。

### 配置文件
以下是具体的配置文件：

```yaml
name: Daily Data Sync

on:
schedule:
- cron: '0 6 * * *' # 每天早上 6 点运行

jobs:
data-sync:
runs-on: ubuntu-latest

steps:
- name: Checkout repository
uses: actions/checkout@v2

- name: Set up Node.js
uses: actions/setup-node@v2
with:
node-version: '14'

- name: Install dependencies
run: npm install

- name: Run data sync script
run: node sync.js
env:
API_KEY: ${{ secrets.API_KEY }}
MONGO_URI: ${{ secrets.MONGO_URI }}
```

### 解释配置文件
- **name**: 任务的名称，这里是 "Daily Data Sync"。
- **on.schedule.cron**: 每天早上 6 点运行。
- **jobs**: 定义任务的执行环境和步骤。
- **runs-on**: 使用 Ubuntu 最新版本。
- **steps**: 具体步骤，包括检出仓库、设置 Node.js 环境、安装依赖、运行脚本，并设置环境变量 `API_KEY` 和 `MONGO_URI`。

## 常见问题与解决方案

### 1. 脚本运行失败
如果你的脚本运行失败，GitHub Actions 会记录详细的日志。你可以在 GitHub 仓库的 "Actions" 标签页中查看。常见的问题包括：
- **依赖未安装**：确保在 `Install dependencies` 步骤中安装了所有必要的依赖。
- **环境变量未设置**：确保在 `env` 中正确设置了所有必要的环境变量。
- **脚本路径错误**：检查 `run` 步骤中的脚本路径是否正确。

### 2. 定时任务不准确
GitHub Actions 的定时任务使用的是 UTC 时间。如果你发现定时任务不准确，可以调整 `cron` 表达式中的时间。例如，如果你希望每天北京时间早上 6 点运行，可以设置为 `0 22 * * *`（北京时间早上 6 点是 UTC 时间的前一天晚上 10 点）。

## 小结与行动建议

通过本文的介绍，你应该已经了解了如何使用 GitHub Actions 实现每天自动运行脚本。无论是代码质量检查还是数据同步，GitHub Actions 都能帮助你轻松实现自动化。如果你还没有尝试过 GitHub Actions，不妨从一个简单的项目开始，逐步熟悉它的使用方法。相信你会在实践中发现它的强大和便捷。

如果你在配置过程中遇到任何问题，欢迎在评论区留言，我会尽力帮助你解决。希望这篇文章对你有所帮助，祝你开发顺利！
```