Skip to main content

GitHub Actions 快速入门

在 5 分钟或更短的时间内尝试 GitHub Actions 的功能。

介绍

GitHub Actions 是一种持续集成和持续交付 (CI/CD) 平台,可用于自动执行生成、测试和部署管道。 你可以创建工作流,以便在推送更改到存储库时运行测试,或将合并的拉取请求部署到生产环境。

本快速入门指南将介绍如何使用 GitHub 的用户界面添加工作流,以便演示 GitHub Actions 的某些基本功能。

若要开始使用预配置的工作流,请浏览 actions/starter-workflows 存储库中的模板列表。 有关详细信息,请参阅“使用工作流模板”。

有关 GitHub Actions 工作流的概述,请参阅“关于工作流程”。 如果要了解构成 GitHub Actions 的各种组件,请参阅“了解 GitHub Actions”。

使用工作流模板

GitHub 提供预配置的工作流模板,可以按原样使用或自定义它来创建自己的工作流。 GitHub 分析代码并显示可能对存储库有用的工作流模板。 例如,如果仓库包含 Node.js 代码,您就会看到 Node.js 项目的建议。

这些工作流模板旨在帮助你快速启动和运行,提供了一系列配置,例如:

使用这些工作流作为构建自定义工作流的起点或按原样使用它们。 可以在 actions/starter-workflows 存储库中浏览工作流模板的完整列表。 有关详细信息,请参阅“使用工作流模板”。

先决条件

本指南假定:

  • 你至少有关于如何使用 GitHub 的基本知识。 如果没有,你将发现先阅读存储库和拉取请求文档中的一些文章会非常有帮助。 有关示例,请参阅“仓库快速入门”、“关于分支”和“关于拉取请求”。

  • 你在 GitHub 上有一个存储库,可在其中添加文件。

  • 你有 GitHub Actions 的访问权限

    Note

    如果 “操作”**** 选项卡未显示在 GitHub 上的存储库名称下,则可能是因为为存储库禁用了“操作”。 有关详细信息,请参阅“管理存储库的 GitHub Actions 设置”。

创建第一个工作流程

  1. 在 GitHub 上的存储库中,创建 .github/workflows 目录中名为 github-actions-demo.yml 的工作流文件。 要执行此操作:

    • 如果 .github/workflows 目录已存在,请导航到 GitHub 上的该目录,单击“添加文件”,然后单击“创建新文件”,然后将命名文件 github-actions-demo.yml

    • 如果存储库没有 .github/workflows 目录,请转到 GitHub 上的存储库主页,单击“添加文件”,然后单击“创建新文件”,并命名文件 .github/workflows/github-actions-demo.yml。 这会在单个步骤中创建 .githubworkflows 目录以及 github-actions-demo.yml 文件。

    Note

    若要使 GitHub 在存储库中发现任何 GitHub Actions 工作流,必须将工作流文件保存在名为 .github/workflows 的目录中。

    你可以为工作流文件指定所需的任何名称,但必须使用 .yml.yaml 作为文件扩展名。 YAML 通常是用于配置文件的标记语言。

  2. 将以下 YAML 内容复制到 github-actions-demo.yml 文件中:

    YAML
    name: GitHub Actions Demo
    run-name: ${{ github.actor }} is testing out GitHub Actions 🚀
    on: [push]
    jobs:
      Explore-GitHub-Actions:
        runs-on: ubuntu-latest
        steps:
          - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event."
          - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!"
          - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."
          - name: Check out repository code
            uses: actions/checkout@v4
          - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner."
          - run: echo "🖥️ The workflow is now ready to test your code on the runner."
          - name: List files in the repository
            run: |
              ls ${{ github.workspace }}
          - run: echo "🍏 This job's status is ${{ job.status }}."
    

    在此阶段,你无需了解此工作流的详细信息。 现在,你只需将内容复制并粘贴到文件中。 完成本快速入门指南后,可以了解“关于工作流程”中工作流文件的语法,并了解 GitHub Actions 上下文的说明,例如 ${{ github.actor }}${{ github.event_name }},请参阅“访问有关工作流运行的上下文信息”。

  3. 单击“提交更改”。

  4. 在“建议更改”对话框中,选择提交到默认分支的选项或创建新分支并启动拉取请求的选项。 然后单击“提交更改”**** 或“建议更改”****。

    “建议更改”对话框的屏幕截图,其中提到的区域用橙色轮廓突出显示。

向存储库的分支提交工作流文件会触发 push 事件并运行工作流。

如果选择启动拉取请求,则可以继续并创建拉取请求,但对于本快速入门来说,这不是必要的,因为提交仍然是对分支进行的,并会触发新工作流。

查看工作流程结果

  1. 在 GitHub 上,导航到存储库的主页面。

  2. 在存储库名称下,单击 “操作”。

    “github/docs”存储库的选项卡的屏幕截图。 “操作”选项卡以橙色边框突出显示。

  3. 在左侧边栏中,单击要显示的工作流,在此示例中为“GitHub Actions 演示”。

    “Actions”页面的屏幕截图。 示例工作流的名称“GitHub Actions 演示”以深橙色边框突出显示。

  4. 从工作流运行列表中,单击要查看的运行名称,在此示例中为“USERNAME 正在测试 GitHub Actions”。

  5. 在工作流运行页的左侧边栏中,单击“作业”下的“Explore-GitHub-Actions”作业 。

    “工作流运行”页的屏幕截图。 在左侧边栏中,“Explore-GitHub-Actions”作业以深橙色边框突出显示。

  6. 日志显示每个步骤的处理方式。 展开任何步骤以查看其细节。

    工作流运行的步骤的屏幕截图。

    例如,你可以看到存储库中的文件列表:

    展开以显示日志输出的“列出存储库中的文件”步骤的屏幕截图。 步骤的输出以橙色轮廓突出显示。

每次将代码推送到分支时,刚刚添加的示例工作流都会运行,并显示 GitHub Actions 如何处理存储库的内容。 有关深入教程,请参阅“了解 GitHub Actions”。

后续步骤

GitHub Actions 可以帮助您自动执行应用程序开发过程的几乎每个方面。 准备好开始了吗? 以下是一些帮助您对 GitHub Actions 执行后续操作的有用资源:

  • 若要创建 GitHub Actions 工作流,请参阅“使用工作流模板”。
  • 有关持续集成 (CI) 工作流,请参阅“构建和测试”。
  • 有关生成和发布包,请参阅“发布包”。
  • 有关部署项目,请参阅“用例和示例”。
  • 有关 GitHub 上的自动化任务和流程,请参阅“管理项目”。
  • 有关演示 GitHub Actions 更复杂功能的示例,请参阅“用例和示例”。 这些详细示例说明了如何在运行器上测试代码、访问 GitHub CLI 以及使用高级功能(如并发和测试矩阵)。
  • 要认证你在 GitHub Actions 自动化工作流和加速开发方面的能力,可通过 GitHub Certifications 获得 GitHub Actions 证书。 有关详细信息,请参阅“关于 GitHub Certifications”。