21 使用市场行动之引入第三方行动

在上一篇中，我们探讨了如何有效地查找和选择适合自己项目的 GitHub 行动。现在，我们将进一步了解如何在我们的工作流中引入这些市场上的第三方行动。通过使用这些行动，我们可以大大简化工作流程，节省时间并减少重复的工作。

1. 什么是第三方行动？

第三方行动是指在 GitHub Marketplace 上发布的预构建的操作。这些行动是由其他开发者或团队创建的，可以帮助我们在 CI/CD 流程中执行特定的任务，比如测试、构建、部署等。使用这些行动时，我们只需通过简单的配置即可让我们的工作流具备更多能力。

2. 如何引入第三方行动？

2.1 查找适合的行动

引入第三方行动的第一步是查找合适的行动。你可以在 GitHub Marketplace 上浏览、搜索不同的行动。在选择时，请关注以下几点：

• 评分和使用情况：选择有较高评分和活跃使用的行动。
• 文档：查看每个行动是否有详细的文档，说明如何配置和使用它。
• 更新频率：选择最近有更新的行动，保证其兼容性和安全性。

2.2 引入行动的格式

在你的工作流文件 (.github/workflows/your-workflow-file.yml) 中引入第三方行动的基本格式如下：

steps:
  - name: 使用示例行动
    uses: owner/repo@version

其中 owner/repo 是 GitHub 仓库的所有者和名称，version 是特定版本或者标签（如 v1.0.0），也可以使用 branch（如 main）或者 latest。

2.3 示例：使用 actions/checkout

作为一个简单的例子，假设我们想要在工作流中引入 actions/checkout 行动，以自动检出代码。以下是完整的工作流配置示例：

name: 示例工作流

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: 检出代码
        uses: actions/checkout@v2

      - name: 设置 Node.js 版本
        uses: actions/setup-node@v2
        with:
          node-version: '14'

      - name: 安装依赖
        run: npm install

      - name: 运行测试
        run: npm test

在上面的示例中，我们首先引入了 actions/checkout 来拉取项目代码，这是一个在 CI/CD 流程中经常使用的行动。接着我们设置 Node.js 环境、安装依赖并运行测试。

2.4 引入多个第三方行动

在一个工作流中，你可以引入多个第三方行动。以下是一个更复杂的示例：

name: CI 工作流

on:
  push:
    branches:
      - main

jobs:
  ci:
    runs-on: ubuntu-latest
    steps:
      - name: 检出代码
        uses: actions/checkout@v2

      - name: 设置 Python 版本
        uses: actions/setup-python@v2
        with:
          python-version: '3.8'

      - name: 安装依赖
        run: pip install -r requirements.txt

      - name: 运行单元测试
        run: pytest

      - name: 构建 Docker 镜像
        uses: melvin0008/docker-build@v1
        with:
          context: .
          file: Dockerfile

在这个示例中，我们引入了 actions/setup-python 行动来设置 Python 版本，并引入了 melvin0008/docker-build 行动来构建 Docker 镜像。这样的配置能使工作流更加灵活和强大。

3. 注意事项

• 版本管理：尽量指定具体的版本而非使用 latest，以避免潜在的不兼容或错误。
• 测试：在引入新的行动后，确保充分测试工作流，以验证其是否正常运行。

4. 小结

通过引入市场上的第三方行动，我们可以方便地扩展 GitHub Actions 的功能，减少了手动编写代码的需求。在确定合适的行动后，只需简单的配置，就能实现更多的自动化操作。接下来，我们将讨论如何创建并使用自定义行动，以满足更特定的需求。

希望这篇教程能够帮助你更好地理解如何引入第三方行动，并将其应用于你的项目中！